调用CancelCopyImage取消正在进行中的复制镜像(CopyImage)任务。
接口说明
调用该接口时,您需要注意:
- 取消复制镜像后,目标地域中新建的镜像会被自动删除,源镜像保持不变。
- 若复制镜像已完成,则操作失败并返回错误提示。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 目标镜像所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
ImageId | string | 是 | 正在被复制的镜像 ID。 | m-bp1caf3yicx5jlfl**** |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
错误码
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 | IncorrectImageStatus | The specified image is not coping. | 指定的镜像不在复制中。 |
400 | IncorrectImageStatus | The Image copy has been failed. | 复制镜像失败。 |
400 | CancelNotSupported | The specified image coping can not be cancelled. | 无法取消复制镜像。 |
400 | IncorrectImageStatus | The image copy has completed. | 镜像已完成复制。 |
404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定的地域 ID 不存在。 |
404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定的镜像在该用户账号下不存在,请您检查镜像 ID 是否正确。 |
500 | InternalError | The request processing has failed due to some unknown error. | 内部错误,请重试。 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2023-07-12 | OpenAPI 错误码发生变更 | 查看变更详情 |