你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
操作
表示长时间运行的操作的当前状态。 例如，长时间运行的操作包括启动、停止和删除 Origin。
本主题提供 Operation 实体的概述，并且还演示如何使用 Media Services REST API 执行各种操作。
重要
访问媒体服务中的实体时，必须在 HTTP 请求中设置特定标头字段和值。
有关详细信息，请参阅设置媒体服务 REST API 开发和使用媒体服务 REST API 连接到媒体服务。
Operation 实体属性
Property |
类型 | 说明 |
|---|---|---|
Id只读。 |
字符串 | 操作 ID，由媒体服务在创建操作时分配。 格式为：nb:opid:UUID:<GUID>. |
ErrorCode只读。 |
字符串 | 失败操作的错误代码。 有关可能的错误代码的信息，请参阅 操作错误代码。 |
ErrorMessage只读。 |
字符串 | 失败操作的详细错误消息。 |
State只读。 |
字符串 | 当前状态。 可能的值包括： - Succeeded（成功） - Failed（失败） - InProgress |
TargetEntityId只读。 |
字符串 | 操作的目标 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 确定”状态代码以及状态消息，如下例中所示。
示例响应
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 | 更新已在进行中。 |