JobTemplate
Un JobTemplate fournit des paramètres réutilisables pour les travaux qui doivent être exécutés de façon répétée.
Cette rubrique offre une vue d'ensemble de l'entité JobTemplate
, et montre comment exécuter diverses opérations avec l'API REST Media Services.
Important
Lors de l’accès aux entités dans Media Services, vous devez définir les valeurs et les champs d’en-tête spécifiques dans vos requêtes HTTP.
Pour plus d’informations, consultez Configuration du développement d’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.
Propriétés de l'entité JobTemplate
Propriété | Type | Description |
---|---|---|
Id Lecture seule. Défini par Media Services au moment de la création. |
Edm.String | Identificateur unique. |
Name Optionnel. |
Edm.String | Nom convivial du modèle de travail. |
Created Lecture seule. Défini par Media Services au moment de la création. |
Edm.DateTime | Indique le nombre de millisecondes écoulées depuis le 1er janvier 1970 à minuit. |
LastModified Lecture seule. Défini par Media Services. |
Edm.DateTime | Cette valeur est mise à jour par Media Services après que des modifications de propriété ont été apportées. Elle représente le nombre de millisecondes écoulées depuis le 1er janvier 1970 à minuit. |
JobTemplateBody Obligatoire. |
Edm.String | Document XML définissant les TaskTemplates et le nombre d'éléments multimédias d'entrée et de sortie à utiliser. Par exemple,<?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> Le format du contenu TaskBody est identique à la propriété de la tâcheTaskBody et à l'attribut TaskTemplateId (ou taskTemplateId ). Chaque TaskTemplateId doit être unique et correspondre au TaskTemplate présent dans la collection de TaskTemplates . Le nombre d'éléments TaskBody doit être identique à celui de la collection de TaskTemplates . |
NumberofInputAssets Optionnel. Mise à jour impossible après la création de l'entité. |
Edm.Int32 | Nombre d'éléments multimédias d'entrée qui peuvent être utilisés avec ce JobTemplate. |
TemplateType Obligatoire. Mise à jour impossible après la création de l'entité. |
Edm.Int32 | Type de JobTemplate qui peut être créé. Les valeurs autorisées sont : - SystemLevel = 0 - AccountLevel = 1 Remarque : Les types JobTemplate SystemLevel sont réservés à Media Services. Vous devez définir cette valeur sur AccountLevel (soit « 1 »). |
TaskTemplates Obligatoire. |
Ensemble d'entités TaskTemplates | Propriété de navigation faisant référence aux entités TaskTemplate associées. |
Création d'un JobTemplate
Les JobTemplates peuvent être créés à l'aide d'une requête HTTP POST.
Méthode | URI de demande | Version HTTP |
---|---|---|
POST | <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates> | HTTP/1.1 |
Exemple de demande
Pour obtenir la dernière version x-ms-version:
, consultez REST Media Services.
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}] }
Liste des JobTemplates
Les JobTemplates peuvent être récupérés à l'aide d'une requête HTTP GET.
Méthode | URI de demande | Version HTTP |
---|---|---|
GET | <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates> | HTTP/1.1 |
Méthode | URI de demande | Version HTTP |
---|---|---|
GET | <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates>('nb:jtid:UUID:ed10f137-7a8e-8343-9110-f54603d1136f') | HTTP/1.1 |
Exemple de demande
Pour obtenir la dernière version x-ms-version:
, consultez REST Media Services.
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
Suppression d'un JobTemplate
Les JobTemplates peuvent être supprimés à l'aide d'une requête HTTP DELETE.
Méthode | URI de demande | Version HTTP |
---|---|---|
Suppression | <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates>('jobtemplateid') | HTTP/1.1 |
Exemple de demande
Pour obtenir la dernière version x-ms-version:
, consultez REST Media Services.
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
Voir aussi
ContentKey
Asset
AccessPolicy
AssetFile
Travail
Locator
MediaProcessor
Tâche
TaskTemplate
Quotas et limitations