取消進行中中的複製鏡像(CopyImage)任務。
描述
調用該介面時,您需要注意:
-
取消複製鏡像後,目標地域中的新建的鏡像會被自動刪除,源鏡像保持不變。
-
若複製鏡像已完成,則操作失敗並返回錯誤提示。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:CancelCopyImage |
RegionId | String | 是 | 目標鏡像所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
ImageId | String | 是 | 正在被複製的鏡像 ID。 |
返回參數
全是公共返回參數。參閱 公共參數
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=CancelCopyImage
&RegionId=cn-hangzhou
&ImageId=img-2012-12-01-1300
&<公共請求參數>
返回樣本
XML 格式
<CancelCopyImageResponse>
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
</CancelCopyImageResponse>
JSON 格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
ImageCreatedNotFromCopy | The specified image is not the target image of a copy action. | 400 | 指定的鏡像 ImageId 沒有複製鏡像進程。 |
IncorrectImageStatus | The image has completed copy. | 400 | 指定的鏡像 ImageId 已經複製完成,取消複製失敗。 |
IncorrectImageStatus | The image is copied finished. | 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 | 指定的鏡像狀態不對。 |
InvalidImageId.NotFound | The specified ImageId does not exist. | 404 | 指定的鏡像不存在。 |
InvalidRegionId.NotFound | The specified region does not exist. | 404 | 指定的 RegionId 不存在。 |