Todos os produtos
Search
Central de documentação

:DeleteImage

Última atualização: Jul 03, 2026

Exclui uma imagem personalizada.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action String Sim DeleteImage

A operação a ser executada. Defina o valor como DeleteImage.

RegionId String Sim cn-hangzhou

O ID da região da imagem personalizada. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

ImageId String Sim m-bp67acfmxazb4p****

O ID da imagem. Se a imagem personalizada especificada não existir, a solicitação será ignorada.

Force Boolean Não false

Especifica se a imagem personalizada deve ser excluída à força. Valores válidos:

  • true: exclua a imagem personalizada à força, independentemente de outras instâncias estarem usando a imagem.
  • false: verifica se nenhuma outra instância está usando a imagem e, em seguida, a exclui.

Valor padrão: false.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

O ID da solicitação.

Exemplos

Solicitações de exemplo

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

Respostas de sucesso de exemplo

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 erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

403

ImageUsingByInstance

The specified image has been used to create instances.

A imagem especificada foi usada para crie instâncias e não pode ser excluída.

403

ImageUseShared

The specified image has been shared to others.

A imagem especificada já está compartilhada com outras contas.

403

OperationDenied.ImageCopying

The Image is coping.

A imagem está sendo copiada. Tente novamente mais tarde.

403

ImageIsImporting

The specified Image is importing.

A imagem especificada está sendo importada. Não é possível executar a operação.

403

ImageIsExporting

The specified Image is exporting. Please cancel task first.

A imagem especificada está sendo exportada. Cancele a tarefa de exportação antes de excluir a imagem.

403

ImageIsPublic

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

A imagem especificada é uma imagem da comunidade e não pode ser excluída diretamente. Chame a operação ModifyImageSharePermission para despublicar a imagem antes de excluí-la.

404

InvalidImageId.NotFound

The specified ImageId does not exist.

A imagem especificada não foi encontrada na conta. Verifique se o ID da imagem está correto.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.