你当前正在访问 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
任务
任务模板
配额和限制