取消正在进行中的复制镜像(CopyImage)任务。
接口说明
调用该接口时,您需要注意:
取消复制镜像后,目标地域中新建的镜像会被自动删除,源镜像保持不变。
若复制镜像已完成,则操作失败并返回错误提示。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ecs:CancelCopyImage |
update |
*Image
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
目标镜像所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 |
cn-hangzhou |
| ImageId |
string |
是 |
正在被复制的镜像 ID。 |
m-bp1caf3yicx5jlfl**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
异常返回示例
JSON格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | ImageCreatedNotFromCopy | The specified image is not the target image of a copy action. | 这个镜像不是来源于拷贝的镜像,只能取消来自于拷贝的镜像。 |
| 400 | InvalidDescription.Malformed | The specified description is wrongly formed. | 指定的资源描述格式不合法。长度为 2-256 个字符,不能以 http:// 和 https:// 开头。 |
| 400 | IncorrectImageStatus | The specified snapshot is not coping. | 指定的快照不在复制中。 |
| 400 | CancelNotSupported | The specified image coping can not be cancelled. | 无法取消复制镜像。 |
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定的地域 ID 不存在。 |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定的镜像在该用户账号下不存在,请您检查镜像 ID 是否正确。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。
该文章对您有帮助吗?