エクスポート (0) 印刷
すべて展開

Task

更新日: 2014年2月

Task は Asset に対する作業の個々の操作で、Job で定義されます。

このトピックでは、Task エンティティの概要を説明し、Media Services REST API を使用してさまざまな操作を実行する方法を示します。

Important重要
Media Services REST API を操作する場合は、次の考慮事項に注意してください。

  • Media Services のエンティティにアクセスする場合は、HTTP 要求で特定のヘッダー フィールドと値を設定する必要があります。詳細については、「Media Services REST API 開発のセットアップ」を参照してください。

  • https://media.windows.net への接続に成功すると、別の Media Services URI を指定する 301 リダイレクトを受け取ります。続いて、新しい URI への呼び出しを行う必要があります。

    詳細については、「Media Services REST API による Media Services への接続」を参照してください。

Task エンティティのプロパティ

 

プロパティ 説明

Id

読み取り専用。作成時に Media Services で設定。

Edm.String

一意識別子。

Configuration

省略可能です。

Edm.String

エンコードや保護など、Task で実行する処理アクションを定義するプリセット。最大長は 100000 です。

EndTime

読み取り専用。Media Services で設定。

Edm.DateTime

タスクが完了、失敗、または取り消された日時。

ErrorDetails

読み取り専用。Media Services で設定。

Collection(ErrorDetail)

Task の実行時に発生するエラーを説明するコードと詳細メッセージのコレクション。

HistoricalEvents

読み取り専用。Media Services で設定。

Collection(TaskHistoricalEvent)

タスクの実行に関連付けられるイベントを記述する TaskHistoricalEvent オブジェクトのコレクション。

MediaProcessorId

必須です。

Edm.String

Task で使用される MediaProcessor の ID。有効な値は、/API/MediaProcessors で GET 要求を実行することによって取得できます。

Name

省略可能です。

Edm.String

省略可能です。タスクのフレンドリ名。最大長は 4000 です。

PerfMessage

読み取り専用。Media Services で設定。

Edm.String

Task に関するパフォーマンス情報を格納します。

Priority

省略可能です。

Edm.Int32

タスクの優先順位。値が大きいほど、他のタスクと比較して高い優先順位を示します。. たとえば、Priority = 40 のタスクは Priority = 30 のタスクより前に処理されます。上限は MaxInt です。

Progress

読み取り専用。Media Services で設定。

Edm.Double

0 ~ 100% を示す値。

RunningDuration

読み取り専用。Media Services で設定。

Edm.Double

Task の経過時間 (秒単位)。

StartTime

読み取り専用。Media Services で設定。

Edm.DateTime

Task が開始されたときの日時。

State

読み取り専用。Media Services で設定。

Edm.Int32

Task の状態。有効な値は次のとおりです。

  • None = 0

  • Active = 1

  • Running = 2

  • Completed = 3

TaskBody

必須です。

Edm.String

Task の実行対象である入力および出力資産に関する情報を格納する XML ドキュメント。Task は最低 1 つの入力資産と出力資産を持つ必要があります。

XML ドキュメントは以下の形式になります。

<taskBody>
    <inputAsset> JobInputAsset(0)</inputAsset>
    <inputAsset> JobInputAsset(1)</inputAsset>
    <outputAsset assetCreationOptions=”1” 
                 assetName=”output” 
                 storageAccountName=”mystoreagename”>
                 JobOutputAsset(0)
    </outputAsset>
<taskBody>

<outputAsset> 要素には以下の属性を指定できます。

  1. assetCreationOptions (または AssetCreationOptions)。この属性は、None=0x0、StorageEncrypted=0x1、CommonEncryptionProtected=0x2、EnvelopeEncryptionProtected=0x4 のいずれかになります。既定値は StorageEncrypted です。

  2. assetName (または AssetName)。指定しない場合、Media Services により、次の形式で名前が設定されます。ジョブ名 (ジョブ名が空の場合はジョブ ID) の接尾辞が付いた親の outputAsset 要素。

  3. storageAccountName (または StorageAccountName)。出力資産が配置されるストレージ アカウントの名前です。指定しない場合、ユーザーの既定のストレージ アカウントが使用されます。

タスクは、複数のタスクと連係でき、複数の依存関係を設定することもできます。たとえば、Task A に、Task B が <inputAsset> として参照する <outputAsset> がある場合、Task B は Task A に依存していることになります。その結果、Media Services では、Task B の処理を開始する前に、Task A を終了する必要があります。

Options

必須です。作成後読み取り専用。

Edm.Int32

Task の作成に使用できる暗号化オプションを示す列挙値。有効な値は次のとおりです。

  • None = 0

  • ProtectedConfiguration = 1

EncryptionKeyId

省略可能です。

Edm.String

暗号化された Key Id。

EncryptionScheme

省略可能です。

Edm.String

構成ファイルで使用される EncryptionScheme。有効な値は "ConfigurationEncryption" です。

EncryptionVersion

省略可能です。

Edm.String

使用する構成の暗号化のバージョン。現在サポートされているバージョンは "1.0" です。

InitializationVector

省略可能です。

Edm.String

構成ファイルの InitializationVector。最大長は 4000 です。

OutputMediaAssets

読み取り専用。Media Services で設定。

Asset エンティティ セット

ID 値により特定のタスクを参照することによってアクセスできるナビゲーション プロパティ。返されるエンティティ セットには、指定されたタスクにリンクされているすべての OutputMediaAsset エンティティが格納されます。

InputMediaAssets

読み取り専用。Media Services で設定。

Asset エンティティ セット

ID 値により特定のタスクを参照することによってアクセスできるナビゲーション プロパティ。返されるエンティティ セットには、指定されたタスクにリンクされているすべての InputMediaAsset エンティティが格納されます。

Task を作成する

Task は、ジョブを作成することによって作成されます。例については、「ジョブを作成する」を参照してください。

Task を一覧表示する

タスクは GET HTTP 要求を使用して取得されます。

 

メソッド 要求 URI HTTP のバージョン

GET

https://media.windows.net/API/Tasks

HTTP/1.1

 

メソッド 要求 URI HTTP のバージョン

GET

https://media.windows.net/API/Jobs('jobid')/Tasks

HTTP/1.1

サンプル要求

Important重要
https://media.windows.net への接続に成功すると、別の Media Services URI を指定する 301 リダイレクトを受け取ります。続いて、新しい URI への呼び出しを行う必要があります。

GET https://media.windows.net/API/Jobs('nb:jid:UUID:b1f956b3-774c-bb44-a3f7-ee47e23add31')/Tasks HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.6
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337212980&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=kK7PbPM3lTAEJYIx5OTWeaSY7zvia358UjPiuvSFHz0%3d
Host: media.windows.net

参照


ビルド日:

2014-06-20

コミュニティの追加

表示:
© 2014 Microsoft