共用方式為

JobTemplate

  • 發行項

工作 (Job) 範本為必須重複執行的工作 (Job) 提供可重複使用的設定。

本主題概述 JobTemplate 實體，也會示範如何使用 Media Services REST API 執行各種作業。

重要

在媒體服務中存取實體時，您必須在 HTTP 要求中設定特定的標頭欄位和值。
如需詳細資訊，請參閱媒體服務 REST API 開發和使用媒體服務 REST API 連線到媒體服務。

JobTemplate 實體屬性

屬性 類型 說明
Id

唯讀。 建立時由媒體服務設定。		 Edm.String 唯一識別碼。
Name

選擇性。		 Edm.String 工作 (Job) 範本的好記名稱。
Created

唯讀。 建立時由媒體服務設定。		 Edm.DateTime 代表自 1970 年 1 月 1 日午夜起的毫秒數。
LastModified

唯讀。 由 Media Services 設定。		 Edm.DateTime 進行任何屬性變更之後，媒體服務就會更新此值。 它代表自 1970 年 1 月 1 日午夜起的毫秒數。
JobTemplateBody

必要。		 Edm.String XML 文件定義要使用哪些工作 (Task) 範本和輸入與輸出資產的數目。 例如，

<?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 內容的格式與工作 (Task) 的 TaskBody 屬性以及 TaskTemplateId (或 taskTemplateId) 屬性相同。 每個 TaskTemplateId 都應該是唯一的，且對應至 TaskTemplate 集合中的 TaskTemplates。 元素數目 TaskBody 必須與集合計數 TaskTemplates 相同。
NumberofInputAssets

選擇性。 無法在建立實體之後更新。		 Edm.Int32 可與此工作 (Job) 範本搭配使用的輸入資產數目。
TemplateType

必要。 無法在建立實體之後更新。		 Edm.Int32 可以建立之工作 (Job) 範本的類型。 有效值為：

- SystemLevel = 0

- AccountLevel = 1

注意：SystemLevel JobTemplate 類型會保留給媒體服務。 您必須將此值設定為 AccountLevel (也就是「1」)。
TaskTemplates

必要。		 TaskTemplates 實體集 參考所有相關聯 TaskTemplate 實體的導覽屬性。

建立工作 (Job) 範本

工作 (Job) 範本可以使用 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}] }

列出工作 (Job) 範本

工作 (Job) 範本可以使用 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

刪除工作 (Job) 範本

工作 (Job) 範本可以使用 DELETE HTTP 要求刪除。

方法 要求 URI HTTP 版本
刪除 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
工作 (Job)
定位
MediaProcessor
Task
TaskTemplate
配額和限制