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

JobTemplate

  • Статья

JobTemplate предоставляет параметры для заданий, которые необходимо выполнять повторно.

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

Важно!

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

Свойства объекта JobTemplate

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

Только для чтения. Устанавливается Службами мультимедиа во время создания.		 Edm.String Уникальный идентификатор.
Name

Необязательный элемент.		 Edm.String Понятное имя шаблона задания.
Created

Только для чтения. Устанавливается Службами мультимедиа во время создания.		 Edm.DateTime Представляет количество миллисекунд с полуночи 1 января 1970 г.
LastModified

Только для чтения. Задается Media Services.		 Edm.DateTime Это значение обновляется Службами мультимедиа после внесения любых изменений свойств. Оно представляет количество миллисекунд с полуночи 1 января 1970 г.
JobTemplateBody

Обязательный.		 Edm.String XML-документ, который определяет, какие шаблоны TaskTemplate и сколько входных и выходных ресурсов следует использовать. Например,

<?xml version="1.0" encoding="utf-8"?> <jobTemplate> <taskBody taskTemplateId=”nb:ttid:UUID:0749DF78-5167-413D-91AA-31564ED1EF34”> … </taskBody> <taskBody taskTemplateId=”nb:ttid:UUID:0432DF78-5167-4132-942A-88241ED1AC34”> … </taskBody> </jobtemplate>

Формат контента TaskBody совпадает со свойством TaskBody объекта Task и атрибутом TaskTemplateId (или taskTemplateId). Каждый код TaskTemplateId должен быть уникальным и соответствовать TaskTemplate в коллекции TaskTemplates. Количество TaskBody элементов должно совпадать с количеством TaskTemplates элементов коллекции.
NumberofInputAssets

Необязательный элемент. Нельзя обновить после создания сущности.		 Edm.Int32 Число входных ресурсов, которые можно использовать с этим объектом JobTemplate.
TemplateType

Обязательный. Нельзя обновить после создания сущности.		 Edm.Int32 Тип JobTemplate, который можно создать. Допустимые значения:

— SystemLevel = 0

— AccountLevel = 1

Примечание. Типы JobTemplate SystemLevel зарезервированы для Служб мультимедиа. Необходимо задать значение AccountLevel (т. е. "1").
TaskTemplates

Обязательный.		 Набор объектов TaskTemplates Свойство навигации, которое ссылается на все связанные объекты TaskTemplate.

Создание JobTemplate

JobTemplate можно создать с помощью HTTP-запроса POST.

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

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

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

POST https://<accountname>.restv2.<location>.media.azure.net/api/JobTemplates 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  
Content-Length: 608  
Expect: 100-continue  
  
{"Name" : "NewJobTemplate14ad96d1-2d14-4618-9014-08db7d227062", "TemplateType" : "1",  "JobTemplateBody" : "<?xml version=\"1.0\" encoding=\"utf-8\"?><jobTemplate><taskBody taskTemplateId=\"nb:ttid:UUID:071370A3-E63E-4E81-A099-AD66BCAC3789\"><inputAsset>JobInputAsset(0)</inputAsset><outputAsset>JobOutputAsset(0)</outputAsset></taskBody></jobTemplate>", "TaskTemplates" : [{"Id" : "nb:ttid:UUID:071370A3-E63E-4E81-A099-AD66BCAC3789", "Configuration" : "H.264 iPad", "MediaProcessorId" : "nb:mpid:UUID:2f381738-c504-4e4a-a38e-d199e207fcd5", "Name" : "SampleTaskTemplate2", "NumberofInputAssets" : 1, "NumberofOutputAssets" : 1}] }

Перечисление JobTemplate

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

Метод Универсальный код ресурса (URI) запроса Версия HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates> HTTP/1.1
Метод Универсальный код ресурса (URI) запроса Версия HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates>('nb:jtid:UUID:ed10f137-7a8e-8343-9110-f54603d1136f') HTTP/1.1

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

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

GET https://<accountname>.restv2.<location>.media.azure.net/api/JobTemplates('nb:jtid:UUID:ed10f137-7a8e-8343-9110-f54603d1136f') 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

Удаление JobTemplate

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

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

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

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

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/JobTemplates('nb:jtid:UUID:1149a161-92c6-be40-8e9c-7bf640c05df6') 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  
Content-Length: 0

См. также:

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