Freigeben über

JobTemplate

  • Artikel

Eine JobTemplate stellt wiederverwendbare Einstellungen für Aufträge zur Verfügung, die wiederholt ausgeführt werden sollen.

Dieses Thema enthält eine Übersicht über die Entität JobTemplate. Darüber hinaus wird gezeigt, wie unterschiedliche Vorgänge mit der Media Services REST-API ausgeführt werden.

Wichtig

Wenn Sie in Media Services auf Entitäten zugreifen, müssen Sie bestimmte Headerfelder und Werte in Ihren HTTP-Anforderungen festlegen.
Weitere Informationen finden Sie unter Einrichten der Media Services-REST-API-Entwicklung und Herstellen einer Verbindung mit Media Services mit der Media Services-REST-API.

JobTemplate-Entitätseigenschaften

Eigenschaft type BESCHREIBUNG
Id

Schreibgeschützt. Von Media Services zum Erstellungszeitpunkt festgelegt.		 Edm.String Eindeutiger Bezeichner.
Name

Optional.		 Edm.String Der Anzeigename für die Auftragsvorlage.
Created

Schreibgeschützt. Von Media Services zum Erstellungszeitpunkt festgelegt.		 Edm.DateTime Stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar.
LastModified

Schreibgeschützt. Wird von Media Services festgelegt.		 Edm.DateTime Dieser Wert wird von Media Services aktualisiert, nachdem Eigenschaftenänderungen vorgenommen wurden. Er stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar.
JobTemplateBody

Erforderlich.		 Edm.String Ein XML-Dokument, das definiert, welche TaskTemplates und welche Anzahl von Eingabe- und Ausgabemedienobjekten verwendet werden sollen. Beispiel:

<?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>

Das Format für den TaskBody-Inhalt ist mit der Eigenschaft TaskBody der Aufgabe zuzüglich des Attributs TaskTemplateId (oder taskTemplateId) identisch. Jede TaskTemplateId sollte eindeutig sein und der TaskTemplate in der TaskTemplates-Auflistung entsprechen. Die Anzahl der TaskBody Elemente muss mit der Anzahl der TaskTemplates Auflistung identisch sein.
NumberofInputAssets

Optional. Kann nach der Erstellung der Entität nicht aktualisiert werden.		 Edm.Int32 Die Anzahl der Eingabemedienobjekte, die mit dieser JobTemplate verwendet werden können.
TemplateType

Erforderlich. Kann nach der Erstellung der Entität nicht aktualisiert werden.		 Edm.Int32 Der Typ von JobTemplate, der erstellt werden kann. Gültige Werte sind:

- SystemLevel = 0

- AccountLevel = 1

Hinweis: SystemLevel JobTemplate-Typen sind für Media Services reserviert. Sie müssen diesen Wert auf AccountLevel (also 1) festlegen.
TaskTemplates

Erforderlich.		 Die TaskTemplates-Entitätenmenge. Eine Navigationseigenschaft, die auf alle zugehörigen TaskTemplate-Entitäten verweist.

Erstellen einer "JobTemplate"

JobTemplates können mithilfe einer POST HTTP-Anforderung erstellt werden.

Methode Anforderungs-URI HTTP-Version
POST <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates> HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter 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}] }

Auflisten von "JobTemplates"

JobTemplates können mithilfe einer GET HTTP-Anforderung abgerufen werden.

Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates> HTTP/1.1
Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates>('nb:jtid:UUID:ed10f137-7a8e-8343-9110-f54603d1136f') HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter 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

Löschen eines JobTemplate-Objekts

JobTemplates können mithilfe einer DELETE HTTP-Anforderung gelöscht werden.

Methode Anforderungs-URI HTTP-Version
Delete <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates>('jobtemplateid') HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter 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

Weitere Informationen

ContentKey
Asset
AccessPolicy
AssetFile
Job
Locator
MediaProcessor
Aufgabe
TaskTemplate
Kontingente und Einschränkungen