Задача

Статья
07/19/2023

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

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

Важно!

При доступе к сущностям в службах мультимедиа необходимо задать определенные поля и значения заголовков в HTTP-запросах.
Дополнительные сведения см. в статье Настройка rest API Служб мультимедиа Разработка и подключение к Службам мультимедиа с помощью REST API Служб мультимедиа.

Свойства сущности задачи

Свойство	Тип	Описание
`Id` Только для чтения. Устанавливается Службами мультимедиа во время создания.	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> может иметь следующие атрибуты: — assetCreationOptions (или AssetCreationOptions). Эти атрибуты могут иметь одно из следующих значений: None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4. Значение по умолчанию — StorageEncrypted. — assetName (или AssetName). Если ни один из них не указан, Службы мультимедиа задают имя в следующем формате: родительский элемент outputAsset с суффиксом имени задания (или идентификатор задания, если имя задания пустое). — storageAccountName (или StorageAccountName). Имя учетной записи хранения, где будет храниться выходной актив. Если оно не указано, будет использоваться учетная запись хранения пользователя по умолчанию. Задача может зависеть от нескольких задач, а также может иметь несколько зависимых объектов. Например, если задача А имеет <набор> выходных данных, на который ссылается задача B как inputAsset<>, задача B зависит от задачи A. В результате Службам мультимедиа необходимо завершить обработку задачи 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, связанные с указанной задачей.
`TaskNotificationSubscriptions` Обязательный.	Набор сущностей TaskNotificationSubscription	Определяет изменения состояния задачи конечной точки уведомления. Кроме того, указывает, следует ли включать ход выполнения задачи, о которой следует уведомлять.

Создание задачи

Задачи создаются путем создания задания. Пример см. в разделе Кодирование ресурса с помощью Media Encoder Standard.

Список задач

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

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Tasks>	HTTP/1.1

Метод	Универсальный код ресурса (URI) запроса	Версия HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Tasks	HTTP/1.1

Пример запроса

Сведения о том, как получить последнюю версию x-ms-version:, см. в разделе REST Служб мультимедиа.

GET https://<accountname>.restv2.<location>.media.azure.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.19
Authorization: Bearer <token value>  
Host: media.windows.net

См. также:

AccessPolicy
Ресурс
ContentKey
Задание
Задание
JobTemplate
Локатор
MediaProcessor
TaskTemplate
Квоты и ограничения

Поделиться через