JobTemplate

  • Artículo

La entidad JobTemplate proporciona una configuración reutilizable para los trabajos que se deben ejecutar repetidamente.

En este tema encontrará un resumen de la entidad JobTemplate y una demostración de cómo ejecutar distintas operaciones con la API de REST de Media Services.

Importante

Al obtener acceso a las entidades de Media Services, debe establecer los campos de encabezado específicos y los valores en las solicitudes HTTP.
Para obtener más información, consulte Configuración para el desarrollo de api REST de Media Services y conexión a Media Services con la API REST de Media Services.

Propiedades de la entidad JobTemplate

Propiedad Tipo Descripción
Id

Solo lectura. Establezca por Media Services en el momento de la creación.		 Edm.String Identificador único.
Name

Opcional.		 Edm.String Nombre descriptivo de la plantilla de trabajo.
Created

Solo lectura. Establezca por Media Services en el momento de la creación.		 Edm.DateTime Representa el número de milisegundos desde la medianoche del 1 de enero de 1970.
LastModified

Solo lectura. Establecido por Servicios multimedia.		 Edm.DateTime Media Services actualiza este valor después de realizar cualquier cambio de propiedad. Representa el número de milisegundos desde la medianoche del 1 de enero de 1970.
JobTemplateBody

Necesario.		 Edm.String Un documento XML que define las TaskTemplates y el número de recursos de entrada y salida que se deben usar. Por ejemplo,

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

El formato para el contenido de TaskBody es el mismo que el de la propiedad de TareaTaskBody, además del atributo TaskTemplateId (o taskTemplateId). Cada TaskTemplateId debería ser único y corresponder a TaskTemplate en la colección TaskTemplates. El número de TaskBody elementos debe ser el mismo que el recuento de la TaskTemplates colección.
NumberofInputAssets

Opcional. No se puede actualizar después de la creación de la entidad.		 Edm.Int32 Número de recursos de entrada que se pueden usar con la JobTemplate.
TemplateType

Necesario. No se puede actualizar después de la creación de la entidad.		 Edm.Int32 Tipo de JobTemplate que se puede crear. Los valores válidos son:

- SystemLevel = 0

- AccountLevel = 1

Nota: Los tipos JobTemplate de SystemLevel están reservados para Media Services. Defina el valor como AccountLevel (es decir, "1").
TaskTemplates

Necesario.		 Conjunto de entidades TaskTemplates Propiedad de navegación que hace referencia a todas las entidades TaskTemplate asociadas.

Creación de JobTemplate

Para crear JobTemplates, puede usar una solicitud HTTP POST.

Método URI de solicitud Versión HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates> HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de 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}] }

Lista de JobTemplates

Para recuperar JobTemplates, use una solicitud HTTP GET.

Método URI de solicitud Versión HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates> HTTP/1.1
Método URI de solicitud Versión HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates>('nb:jtid:UUID:ed10f137-7a8e-8343-9110-f54603d1136f') HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de 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

Eliminación de JobTemplate

Para eliminar JobTemplates, use una solicitud HTTP DELETE.

Método URI de solicitud Versión HTTP
Delete <https:// accountname.restv2>.<location.media.azure.net/api/JobTemplates>('jobtemplateid') HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de 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

Consulte también

ContentKey
Recurso
AccessPolicy
AssetFile
Trabajo
Localizador
MediaProcessor
Task
TaskTemplate
Cuotas y limitaciones