指定されたカスタムイメージを削除します。

Action String はい このインターフェースの名前。値: DeleteImage
RegionId String はい イメージの属する Alibaba Cloud リージョンの ID。リージョン ID については、DescribeRegionsを参照してください。
ImageId String はい イメージの ID
Force String いいえ カスタムイメージを直接削除するかどうか。 オプションの値:
  • true:カスタムイメージを直接削除し、イメージの使用状況を無視します。
  • false:イメージが削除前にインスタンスによって使用されたかどうかを確認します。
デフォルト値:false

レスポンスパラメータ

すべてはパブリックリターンパラメータです。詳細については、「共通パラメーター」を参照してください。

リクエストの例

https://ecs.aliyuncs.com/?Action=DeleteImage
&RegionId=cn-hangzhou
&ImageId=m-63DFD5FB2
&<Common Request Parameters>

戻り値の例

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 指定されたイメージは他のインスタンスによって使用され、削除できません。
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 は存在しません。