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

Задача

Обновлено: Август 2014 г.

Задача является отдельной операцией в работе с ресурсом и она определяется заданием.

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

ImportantВажно!
При работе с API REST служб мультимедиа придерживайтесь следующих рекомендаций:

 

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

Id

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

Edm.String

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

Configuration

Необязательный параметр.

Edm.String

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

EndTime

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

Edm.DateTime

Дата и время, когда задача была выполнена, отменена или завершилась сбоем.

ErrorDetails

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

Коллекция (ErrorDetail)

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

HistoricalEvents

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

Коллекция (Сущность 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

Значение, указывающее ноль к 100 процентам.

RunningDuration

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

Edm.Double

Затраченное время для задачи (в секундах).

StartTime

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

Edm.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). Имя учетной записи хранения, в которой будет храниться выходной ресурс. Если значение не задано, используется учетная запись пользователя по умолчанию.

Задача может зависеть от нескольких задач, и несколько задач могут зависеть от нее. Например, если на <outputAsset> задачи A ссылается <inputAsset> задачи B, то задача 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.

Набор сущностей Asset.

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

InputMediaAssets

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

Набор сущностей Asset.

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

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

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

 

Метод 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.6
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

См. также

Показ:
© 2014 Microsoft