次の方法で共有

操作

  • [アーティクル]

実行に時間のかかる処理の、現在の状態を表します。 実行に時間のかかる処理の例としては、仮想マシンの起動、終了、Origin の削除などが挙げられます。

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

重要

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

Operation エンティティ プロパティ

Property Type Description
Id

読み取り専用。		 String 操作の作成時に Media Services によって割り当てられる操作 ID。 形式は次のようになります:

nb:opid:UUID:<GUID>.
ErrorCode

読み取り専用。		 String 失敗した操作のエラー コード。 考えられるエラー コードについては、「 操作エラー コード」を参照してください。
ErrorMessage

読み取り専用。		 String 失敗した操作の詳細なエラー メッセージ。
State

読み取り専用。		 String 現在の状態。 次の値を指定できます。

- 成功
- 失敗
- 処理中
TargetEntityId

読み取り専用。		 String アクションのターゲットの ID。

クエリ操作

指定した操作のクエリ。

Method 要求 URI HTTP バージョン
GET <https:// accountname.restv2>。<location.media.azure.net/api/Operations>('OperationId') HTTP/1.1

要求のサンプル

最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。

GET api/Operations('nb:opid:UUID:ab66eff9-8945-4323-9f91-d257a695899b') HTTP/1.1  
MaxDataServiceVersion: 3.0;NetFx  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
Host: <host URI>  
Content-Length: 0

成功すると、次の例に示すように、応答本文に 200 OK ステータス コードとステータス メッセージが返されます。

応答のサンプル

HTTP/1.1 200 OK  
Cache-Control: no-cache  
Content-Length: 280  
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8  
Server: Microsoft-IIS/7.5  
request-id: c3f3501a-8563-4cff-8aeb-66f68f9bdb8b  
x-ms-request-id: c3f3501a-8563-4cff-8aeb-66f68f9bdb8b  
X-Content-Type-Options: nosniff  
DataServiceVersion: 3.0;  
X-Powered-By: ASP.NET  
Date: Wed, 15 Jan 2014 19:31:13 GMT  
  
{"odata.metadata":"https://wamsbayclus001rest-hs.cloudapp.net/api/$metadata#Operations/@Element","Id":"nb:opid:UUID:ab66eff9-8945-4323-9f91-d257a695899b","State":"Succeeded","TargetEntityId":"nb:chid:UUID:1e518dbc-91ef-4044-a8bd-d20769dae833","ErrorCode":null,"ErrorMessage":null}

操作のエラー コード

操作のエラー コードの一覧を以下に示します。

エラー コード 説明
BadRequest 他のエラー コードが適用されない場合、または正確なエラーが不明な場合に送信されます。
InsufficientCapacity データ センターの容量が不十分です。
InternalError サービスで、予期しないエラーが発生しました。
InvalidIdentifierFormat エンティティ ID の形式が無効です。
InvalidOperation この要求は、エンティティの現在の状態では無効です。
InvalidResourceName 指定した Origin 名が無効です。
OperationInProgress 指定したエンティティ上で、別の操作が既に進行中です。
OperationNotFound 指定した操作 ID の操作レコードが見つかりません。 期間が経過した後に操作が削除されたか、ID が間違っている可能性があります。
ResourceNameTaken 既に使用中の名前を使用して新しい Origin を作成しようとしています。
ResourceNotFound 指定したリソースが見つかりません。
ExceededResourceQuota 要求がリソース クォータ制限を超えました。
タイムアウト 非同期操作がタイムアウトになりました。
DeleteNotAllowedOnDefaultOrigin 既定の Origin を削除しようとしました。
SettingsUpdateInProgress 更新が既に進行中です。