你当前正在访问 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 | 更新已在进行中。 |