JobTemplate
JobTemplate は、繰り返し実行する必要があるジョブの再利用可能な設定を提供します。
このトピックは、JobTemplate
エンティティを概説し、また Media Services REST API でさまざまな操作を実行する方法を示します。
重要
Media Services でエンティティにアクセスするときは、HTTP 要求で特定のヘッダー フィールドと値を設定する必要があります。
詳細については、「 Media Services REST API 開発のセットアップ」および「Media Services REST APIを使用した Media Services への接続」を参照してください。
JobTemplate エンティティのプロパティ
プロパティ | Type | 説明 |
---|---|---|
Id 読み取り専用です。 作成時に Media Services によって設定されます。 |
Edm.String | 一意識別子。 |
Name 省略可能。 |
Edm.String | ジョブ テンプレートのフレンドリ名。 |
Created 読み取り専用です。 作成時に Media Services によって設定されます。 |
Edm.DateTime | 1970 年 1 月 1 日の午前 0 時からのミリ秒数を表します。 |
LastModified 読み取り専用です。 Media Services で設定します。 |
Edm.DateTime | この値は、プロパティの変更が行われた後に Media Services によって更新されます。 1970 年 1 月 1 日の午前 0 時からのミリ秒数を表します。 |
JobTemplateBody 必須。 |
Edm.String | 使用する TaskTemplate および入出力アセットの数を定義する 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 | この JobTemplate で使用できる入力アセットの数。 |
TemplateType 必須。 エンティティが作成された後に更新することはできません。 |
Edm.Int32 | 作成できる JobTemplate の型。 有効な値は次のとおりです。 - SystemLevel = 0 - AccountLevel = 1 注: SystemLevel JobTemplate 型は Media Services 用に予約されています。 この値を AccountLevel (つまり "1") に設定する必要があります。 |
TaskTemplates 必須。 |
TaskTemplate エンティティ セット | 関連付けられたすべての TaskTemplate エンティティを参照するナビゲーション プロパティ。 |
JobTemplate の作成
JobTemplate は、POST HTTP 要求を使用して作成できます。
Method | 要求 URI | HTTP バージョン |
---|---|---|
POST | <https:// accountname.restv2>。<location.media.azure.net/api/JobTemplates> | HTTP/1.1 |
要求のサンプル
最新 x-ms-version:
の を取得するには、「 Media Services 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}] }
JobTemplate の一覧表示
JobTemplate は、GET HTTP 要求を使用して取得できます。
Method | 要求 URI | HTTP バージョン |
---|---|---|
GET | <https:// accountname.restv2>。<location.media.azure.net/api/JobTemplates> | HTTP/1.1 |
Method | 要求 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:
の を取得するには、「 Media Services 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
JobTemplate の削除
JobTemplate は、DELETE HTTP 要求を使用して削除できます。
Method | 要求 URI | HTTP バージョン |
---|---|---|
DELETE | <https:// accountname.restv2>。<location.media.azure.net/api/JobTemplates>('jobtemplateid') | HTTP/1.1 |
要求のサンプル
最新 x-ms-version:
の を取得するには、「 Media Services 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
Asset
AccessPolicy
AssetFile
ジョブ
ロケーター
MediaProcessor
タスク
TaskTemplate
クォータと制限