刪除一份自訂鏡像。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:DeleteImage
RegionId String 自訂鏡像所在的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
ImageId String 鏡像 ID。如果指定的自訂鏡像不存在,則請求將被忽略。
Force String 是否執行強制移除。取值範圍:
  • true:強制移除自訂鏡像,忽略當前鏡像是否被其他執行個體使用。
  • false:正常刪除自訂鏡像,刪除前檢查當前鏡像是否被其他執行個體使用。

返回參數

全是公共返回參數。參閱 公共參數

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=DeleteImage
&RegionId=cn-hangzhou
&ImageId=m-63DFD5FB2
&<公共請求參數>
返回樣本

XML 格式

<DeleteImageResponse>
     <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</DeleteImageResponse>
JSON 格式
{
    "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
ImageUsingByInstance The specified image has been used to create instances. 403 指定的鏡像 ID 被其他執行個體使用,暫時無法刪除。
ImageIsCreating The specified image is being created. 403 指定的自訂鏡像正在建立中,請稍後再試。
ImageUseShared The specified image has been shared to others. 403 您共用了該自訂鏡像給其他使用者,暫時無法刪除。
OperationDenied.ImageCopying The specified image is being copied. 403 指定的自訂鏡像正在被複製中,請稍後再試。
InvalidRegionId.NotFound The specified region does not exist. 404 指定的 RegionId 不存在。