作業
表示長時間執行作業的目前狀態。 長時間執行作業的範例包括啟動、停止以及刪除 Origin。
本主題概述 Operation 實體，也會示範如何使用 Media Services REST API 執行各種作業。
重要
在媒體服務中存取實體時，您必須在 HTTP 要求中設定特定的標頭欄位和值。
如需詳細資訊，請參閱媒體服務 REST API 開發和使用媒體服務 REST API 連線到媒體服務。
作業實體屬性
Property |
類型 | Description |
|---|---|---|
Id唯讀。 |
String | 建立作業時由媒體服務指派的作業識別碼。 其格式為：nb:opid:UUID:<GUID>. |
ErrorCode唯讀。 |
String | 失敗作業的錯誤代碼。 如需可能錯誤碼的詳細資訊，請參閱 作業錯誤碼。 |
ErrorMessage唯讀。 |
String | 失敗作業的詳細錯誤代碼。 |
State唯讀。 |
String | 目前狀態。 可能的值包括： - Succeeded - Failed (失敗) - InProgres |
TargetEntityId唯讀。 |
String | 動作目標的 ID。 |
查詢作業
查詢指定作業。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/Operations ('OperationId > ') | HTTP/1.1 |
範例要求
若要取得最新的 x-ms-version: ，請參閱 媒體服務 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 | 找不到指定之作業識別碼的作業記錄。 作業可能會在時間範圍之後移除，或識別碼錯誤。 |
| ResourceNameTaken | 嘗試用使用中的名稱建立新的 Origin。 |
| ResourceNotFound | 找不到指定的資源。 |
| ExceededResourceQuota | 要求超過資源的配額限制。 |
| 逾時 | 非同步作業已逾時。 |
| DeleteNotAllowedOnDefaultOrigin | 嘗試刪除預設的 Origin。 |
| SettingsUpdateInProgress | 更新正在進行中。 |