你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

作业模板

作业模板为需要反复运行的作业提供了可重用设置。

本主题提供 JobTemplate 实体的概述,并且还演示如何使用 Media Services REST API 执行各种操作。

重要

访问媒体服务中的实体时,必须在 HTTP 请求中设置特定标头字段和值。
有关详细信息,请参阅设置媒体服务 REST API 开发和使用媒体服务 REST API 连接到媒体服务

作业模板实体属性

属性 类型 说明
Id

只读。 由媒体服务在创建时设置。
Edm.String 唯一标识符。
Name

可选。
Edm.String 作业模板的友好名称。
Created

只读。 由媒体服务在创建时设置。
Edm.DateTime 表示自 1970 年 1 月 1 日午夜以来的毫秒数。
LastModified

只读。 由 Media Services 设置。
Edm.DateTime 进行任何属性更改后,媒体服务会更新此值。 它表示自 1970 年 1 月 1 日午夜以来的毫秒数。
JobTemplateBody

必需。
Edm.String 一个 XML 文档,用于定义要使用哪些任务模板以及要使用的输入和输出资产的数量。 例如,

<?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 属性以及 TaskTemplateId(或 taskTemplateId)属性的格式相同。 每个 TaskTemplateId 应唯一且应与 TaskTemplate 集合中的 TaskTemplates 相对应。 元素数 TaskBody 必须与集合计数 TaskTemplates 相同。
NumberofInputAssets

可选。 在创建实体后无法进行更新。
Edm.Int32 可与此作业模板一起使用的输入资产的数量。
TemplateType

必需。 在创建实体后无法进行更新。
Edm.Int32 可以创建的作业模板的类型。 有效值为:

- SystemLevel = 0

- AccountLevel = 1

注意:SystemLevel JobTemplate 类型是为媒体服务保留的。 必须将此值设置为 AccountLevel(即“1”)。
TaskTemplates

必需。
任务模板实体集 导航属性,该属性引用所有关联的任务模板实体。

创建作业模板

可以使用 POST HTTP 请求创建作业模板。

方法 请求 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}] }  
  

列出作业模板

可以使用 GET HTTP 请求检索作业模板。

方法 请求 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  
  

删除作业模板

可以使用 DELETE HTTP 请求删除作业模板。

方法 请求 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
任务
任务模板
配额和限制