JobTemplate
Element JobTemplate udostępnia ustawienia wielokrotnego użytku dla zadań, które muszą być uruchamiane wielokrotnie.
Ten temat zawiera omówienie JobTemplate
jednostki, a także pokazuje, jak wykonywać różne operacje za pomocą interfejsu API REST usługi Media Services.
Ważne
Podczas uzyskiwania dostępu do jednostek w usłudze Media Services należy ustawić określone pola nagłówka i wartości w żądaniach HTTP.
Aby uzyskać więcej informacji, zobacz Setup for Media Services REST API Development (Konfigurowanie tworzenia interfejsu API REST usługi Media Services) i Connecting to Media Services with the Media Services REST API (Nawiązywanie połączenia z usługą Media Services za pomocą interfejsu API REST usługi Media Services).
Właściwości jednostki JobTemplate
Właściwość | Typ | Opis |
---|---|---|
Id Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia. |
Edm.String | Unikatowy identyfikator. |
Name Opcjonalny. |
Edm.String | Przyjazna nazwa szablonu zadania. |
Created Tylko do odczytu. Ustawienie przez usługę Media Services w czasie tworzenia. |
Edm.DateTime | Przedstawia liczbę milisekund od północy 1 stycznia 1970 r. |
LastModified Tylko do odczytu. Ustawiane przez usługę Media Services. |
Edm.DateTime | Ta wartość jest aktualizowana przez usługę Media Services po wprowadzeniu jakichkolwiek zmian właściwości. Reprezentuje liczbę milisekund od północy 1 stycznia 1970 r. |
JobTemplateBody Wymagane. |
Edm.String | Dokument XML, który definiuje elementy TaskTemplates i liczbę zasobów wejściowych i wyjściowych do użycia. Na przykład<?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> Format TaskBody zawartości jest taki sam jak właściwość zadaniaTaskBody oraz TaskTemplateId atrybut (lub taskTemplateId ). Każda z nich TaskTemplateId powinna być unikatowa i odpowiadać właściwościom TaskTemplate w kolekcji TaskTemplates . Liczba TaskBody elementów musi być taka sama jak liczba kolekcji TaskTemplates . |
NumberofInputAssets Opcjonalny. Nie można zaktualizować po utworzeniu jednostki. |
Edm.Int32 | Liczba zasobów wejściowych, które mogą być używane z tym elementem JobTemplate. |
TemplateType Wymagane. Nie można zaktualizować po utworzeniu jednostki. |
Edm.Int32 | Typ zadaniaTemplate, który można utworzyć. Prawidłowe wartości: - SystemLevel = 0 - AccountLevel = 1 Uwaga: typy SystemLevel JobTemplate są zarezerwowane dla usługi Media Services. Należy ustawić tę wartość na AccountLevel (czyli "1"). |
TaskTemplates Wymagane. |
Zestaw jednostek TaskTemplates | Właściwość nawigacji, która odwołuje się do wszystkich skojarzonych jednostek TaskTemplate. |
Tworzenie zadaniaTemplate
Element JobTemplates można utworzyć za pomocą żądania HTTP POST.
Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
---|---|---|
POST | <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates> | HTTP/1.1 |
Przykładowe żądanie
Aby uzyskać najnowszą wersję x-ms-version:
, zobacz Artykuł Usługa Media Services 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}] }
List JobTemplates
Narzędzia JobTemplates można pobrać przy użyciu żądania HTTP GET.
Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
---|---|---|
GET | <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates> | HTTP/1.1 |
Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
---|---|---|
GET | <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates>('nb:jtid:UUID:ed10f137-7a8e-8343-9110-f54603d1136f') | HTTP/1.1 |
Przykładowe żądanie
Aby uzyskać najnowszą wersję x-ms-version:
, zobacz Artykuł Usługa Media Services 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
Usuwanie elementu JobTemplate
Narzędzia JobTemplates można usunąć przy użyciu żądania HTTP DELETE.
Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
---|---|---|
DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates>('jobtemplateid') | HTTP/1.1 |
Przykładowe żądanie
Aby uzyskać najnowszą wersję x-ms-version:
, zobacz Artykuł Usługa Media Services 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
Zobacz też
ContentKey
Zasób
AccessPolicy
AssetFile
Zadanie
Lokalizator
MediaProcessor
Zadanie
TaskTemplate
Limity przydziału i ograniczenia