All Products
Search

This Product

    :DeleteImage

    Document Center

    :DeleteImage

    Last Updated:May 22, 2026

    Menghapus custom image.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

    Parameter Permintaan

    Parameter

    Type

    Required

    Example

    Description
    Action String Yes DeleteImage

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DeleteImage.

    RegionId String Yes cn-hangzhou

    ID Wilayah dari custom image tersebut. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.

    ImageId String Yes m-bp67acfmxazb4p****

    ID gambar tersebut. Jika custom image yang ditentukan tidak ada, permintaan akan diabaikan.

    Force Boolean No false

    Menentukan apakah custom image akan dihapus secara paksa. Nilai yang valid:

    • true: menghapus custom image secara paksa, terlepas dari apakah gambar sedang digunakan oleh instans lain atau tidak.
    • false: memverifikasi bahwa gambar tidak sedang digunakan oleh instans lain sebelum menghapusnya.

    Nilai default: false.

    Parameter Respons

    Parameter

    Type

    Example

    Description
    RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID permintaan tersebut.

    Contoh

    Contoh permintaan

    https://ecs.aliyuncs.com/?Action=DeleteImage
&ImageId=m-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&Force=false
&<Common request parameters>

    Contoh respons sukses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteImageResponse>
     <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</DeleteImageResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

    Kode Kesalahan

    Kode status HTTP

    Kode kesalahan

    Pesan kesalahan

    Description
    403 ImageUsingByInstance The specified image has been used to create instances. Gambar yang ditentukan digunakan untuk membuat instans dan tidak dapat dihapus.
    403 ImageUseShared The specified image has been shared to others. Gambar yang ditentukan telah dibagikan ke akun lain.
    403 OperationDenied.ImageCopying The Image is coping. Gambar sedang dalam proses penyalinan. Coba lagi nanti.
    403 ImageIsImporting The specified Image is importing. Gambar yang ditentukan sedang dalam proses impor. Operasi tidak dapat dilakukan.
    403 ImageIsExporting The specified Image is exporting. Please cancel task first. Gambar yang ditentukan sedang dalam proses ekspor. Anda harus membatalkan tugas ekspor terlebih dahulu sebelum dapat menghapus gambar tersebut.
    403 ImageIsPublic You can not delete public image, please modify it to private. Gambar yang ditentukan merupakan community image dan tidak dapat dihapus secara langsung. Anda harus memanggil operasi ModifyImageSharePermission untuk membatalkan publikasi gambar sebelum dapat menghapusnya.
    404 InvalidImageId.NotFound The specified ImageId does not exist. Gambar yang ditentukan tidak ditemukan di akun tersebut. Periksa apakah ID gambar sudah benar.

    Untuk daftar lengkap kode kesalahan, lihat Service error codes.