Todos los productos
Search
Centro de documentos

:DeleteImage

Última actualización: Sep 02, 2026

Elimina una imagen personalizada.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action String Sí DeleteImage

La operación que desea ejecutar. Establezca el valor en DeleteImage.

RegionId String Sí cn-hangzhou

El ID de región de la imagen personalizada. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.

ImageId String Sí m-bp67acfmxazb4p****

El ID de la imagen. Si la imagen personalizada especificada no existe, se ignora la solicitud.

Force Boolean No false

Especifica si se debe eliminar forzosamente la imagen personalizada. Valores válidos:

  • true: elimina forzosamente la imagen personalizada, sin importar si otras instancias la están utilizando.
  • false: comprueba que ninguna otra instancia esté utilizando la imagen y luego la elimina.

Valor predeterminado: false.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato XML

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

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

Formato JSON

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

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

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

403

ImageUsingByInstance

The specified image has been used to create instances.

La imagen especificada se utiliza para crear instancias y no se puede eliminar.

403

ImageUseShared

The specified image has been shared to others.

La imagen especificada ya está compartida con otras cuentas.

403

OperationDenied.ImageCopying

The Image is coping.

La imagen se está copiando. Inténtelo de nuevo más tarde.

403

ImageIsImporting

The specified Image is importing.

La imagen especificada se está importando. No se puede realizar la operación.

403

ImageIsExporting

The specified Image is exporting. Please cancel task first.

La imagen especificada se está exportando. Debe cancelar la tarea de exportación antes de eliminar la imagen.

403

ImageIsPublic

You can not delete public image, please modify it to private.

La imagen especificada es una imagen comunitaria y no se puede eliminar directamente. Debe llamar a la operación ModifyImageSharePermission para retirar la publicación de la imagen antes de eliminarla.

404

InvalidImageId.NotFound

The specified ImageId does not exist.

No se encontró la imagen especificada en la cuenta. Compruebe si el ID de la imagen es correcto.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.