Экспорт (0) Печать
Развернуть все

Задача

Обновлено: Ноябрь 2014 г.

Задача — это индивидуальная операция в активе, которая определяется в задании.

В данном разделе приводится описание сущности Task и демонстрируется выполнение различных операций с API REST служб мультимедиа.

ImportantВажно!
При работе с API REST служб мультимедиа учитывайте следующее.

 

Свойство Type Описание

Id

Только для чтения. Задается Службы Media Services во время создания.

Edm.String

Уникальный идентификатор.

Configuration

Необязательно.

Edm.String

Предустановка, определяющая действия обработки, такие как кодирование, защита и т. д., которые будет выполнять задача. Максимальная длина составляет 100000 символов.

EndTime

Только для чтения. Задается Службы Media Services.

Edm.DateTime

Объект datetime, когда задача была завершена, завершена сбоем или была отменена.

ErrorDetails

Только для чтения. Задается Службы Media Services.

Collection(ErrorDetail)

Коллекция кодов и подробных сообщений, описывающих все ошибки, которые происходят, когда задача запущена.

HistoricalEvents

Только для чтения. Задается Службы Media Services.

Collection(Сущность TaskHistoricalEvent)

Коллекция объектов Сущность TaskHistoricalEvent, которая описывает события, связанные с выполнением задачи.

MediaProcessorId

Обязательно.

Edm.String

Идентификатор MediaProcessor, который будет использоваться в задаче. Допустимые значения можно получить с помощью запроса GET для /API/MediaProcessors.

Name

Необязательно.

Edm.String

Необязательно. Понятное имя задачи. Максимальная длина составляет 4000 символов.

PerfMessage

Только для чтения. Задается Службы Media Services.

Edm.String

Содержит сведения о производительности задачи.

Priority

Необязательно.

Edm.Int32

Приоритет задачи. Верхнее значение указывает на верхний приоритет относительно других задач. . Например, задача с приоритетом = 40 будет обрабатываться перед задачей с приоритетом = 30. Верхняя граница равна значению MaxInt.

Progress

Только для чтения. Задается Службы Media Services.

Edm.Double

Значение, указывающее от 0 до 100 %.

RunningDuration

Только для чтения. Задается Службы Media Services.

Edm.Double

Время в секундах для выполнения задачи.

StartTime

Только для чтения. Задается Службы Media Services.

Edm.DateTime

Объект datetime времени начала задачи.

State

Только для чтения. Задается Службы Media Services.

Edm.Int32

Состояние задачи. Допустимые значения:

  • Нет = 0

  • Активна = 1

  • Выполняется = 2

  • Завершена = 3

TaskBody

Обязательно.

Edm.String

Документ XML, который содержит сведения о том, какие входные и выходные активы должна использовать задача для запуска. Задача должна иметь по крайней мере 1 входной актив и 1 выходной актив.

Документ XML указывается в следующем формате.

<taskBody>
    <inputAsset> JobInputAsset(0)</inputAsset>
    <inputAsset> JobInputAsset(1)</inputAsset>
    <outputAsset assetCreationOptions=”1” 
                 assetName=”output” 
                 storageAccountName=”mystoreagename”>
                 JobOutputAsset(0)
    </outputAsset>
<taskBody>

Элемент <outputAsset> может иметь следующие атрибуты:

  1. assetCreationOptions (или AssetCreationOptions). Эти атрибуты могут иметь одно из следующих значений: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. Значение по умолчанию — StorageEncrypted.

  2. assetName (или AssetName). Если значение не указано, Службы Media Services задает имя в следующем формате: родительский элемент outputAsset с суффиксом имени задания (или идентификатора задания, если имя задания имеет пустое значение.

  3. storageAccountName (или StorageAccountName). Имя учетной записи хранения, где будет храниться выходной актив. Если оно не указано, будет использоваться учетная запись хранения пользователя по умолчанию.

Задача может зависеть от нескольких задач, а также может иметь несколько зависимых объектов. Например, если задача A имеет значение <outputAsset>, на которое ссылка задачи B указывает как на <inputAsset>, то задача B является зависимой от задачи A. В результате Службы Media Services необходимо завершить обработку задачи A, перед тем как она сможет обработать задачу B.

Options

Обязательно. После создания доступ только для чтения.

Edm.Int32

Значение перечисления, которое описывает варианты шифрования, с помощью которых может быть создана задача. Допустимые значения:

  • Нет = 0

  • ProtectedConfiguration = 1

EncryptionKeyId

Необязательно.

Edm.String

Зашифрованный код ключа.

EncryptionScheme

Необязательно.

Edm.String

Схема EncryptionScheme, использованная в файле конфигурации. Допустимое значение — "ConfigurationEncryption".

EncryptionVersion

Необязательно.

Edm.String

Используемая версия конфигурации шифрования. В текущий момент поддерживается версия "1.0".

InitializationVector

Необязательно.

Edm.String

InitializationVector файла конфигурации. Максимальная длина составляет 4000 символов.

OutputMediaAssets

Только для чтения. Задается Службы Media Services.

Набор объектов Актив

Свойство навигации, к которому можно получить доступ с помощью ссылки на определенную задачу по значению идентификатора. Возвращаемый набор сущностей содержит все сущности OutputMediaAsset, связанные с указанной задачей.

InputMediaAssets

Только для чтения. Задается Службы Media Services.

Набор объектов Актив

Свойство навигации, к которому можно получить доступ с помощью ссылки на определенную задачу по значению идентификатора. Возвращаемый набор сущностей содержит все сущности InputMediaAsset, связанные с указанной задачей.

Задачи создаются путем создания задания. Пример см. в разделе Создание задания.

Задачи можно получить с помощью HTTP-запроса GET.

 

Метод URI запроса Версия HTTP

GET

https://media.windows.net/API/Tasks

HTTP/1.1

 

Метод URI запроса Версия HTTP

GET

https://media.windows.net/API/Jobs('jobid')/Tasks

HTTP/1.1

ImportantВажно!
После успешного подключения к https://media.windows.net будет получено перенаправление 301, указывающее другой URI служб Media Services. Последующие обращения к новому URI.

GET https://media.windows.net/API/Jobs('nb:jid:UUID:b1f956b3-774c-bb44-a3f7-ee47e23add31')/Tasks HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337212980&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=kK7PbPM3lTAEJYIx5OTWeaSY7zvia358UjPiuvSFHz0%3d
Host: media.windows.net

См. также

Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft