Todos os produtos
Search
Central de documentação

:DeleteSnapshot

Última atualização: Jul 03, 2026

Use esta operação para excluir um snapshot. Se você chamar esta operação para excluir um snapshot em criação, a tarefa de criação será cancelada.

Descrição

Ao chamar esta operação, observe os seguintes itens:

  • Se o ID do snapshot especificado não existir, a solicitação será ignorada.

  • Não é possível excluir um snapshot usado na criação de imagens personalizadas. A exclusão só pode ocorrer após a remoção das imagens personalizadas criadas (DeleteImage).

  • Snapshots usados para criar discos também não podem ser excluídos diretamente. Para forçar a exclusão nesses casos, defina o parâmetro Force como true. Após a exclusão forçada, os discos originados desse snapshot não poderão ser reinicializados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimDeleteSnapshot

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

SnapshotIdStringSims-bp1c0doj0taqyzzl****

O ID do snapshot.

ForceBooleanNãofalse

Especifica se deve forçar a exclusão do snapshot usado para criar discos. Valores válidos:

  • true: força a exclusão do snapshot. Após a exclusão forçada, os discos criados a partir deste snapshot não podem ser reinicializados.
  • false: não força a exclusão do snapshot.

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

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DeleteSnapshot
&SnapshotId=s-bp1c0doj0taqyzzl****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

Formato 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

SnapshotCreatedImage

The snapshot has been used to create user defined image(s).

Mensagem retornada porque o snapshot foi usado para criar imagens personalizadas e não pode ser excluído. A exclusão só é possível após remover as imagens personalizadas criadas a partir dele (DeleteImage).

403

SnapshotCreatedDisk

The snapshot has been used to create disk(s).

Mensagem retornada porque o snapshot foi usado para criar discos e não pode ser excluído. Caso precise excluir o snapshot, defina o parâmetro Force como true para forçar a operação. Os discos criados a partir do snapshot não poderão ser reinicializados após a exclusão forçada.

400

MissingParameter

The input parameter SnapshotId that is mandatory for processing this request is not supplied.

Mensagem retornada porque o parâmetro obrigatório SnapshotId não foi especificado.

500

InternalError

The request processing has failed due to some unknown error.

Mensagem retornada devido à ocorrência de um erro interno. Tente novamente mais tarde.

404

InvalidSnapshotId.NotFound

The specified snapshot is not found

Mensagem retornada porque o parâmetro SnapshotId especificado não existe.

403

Operation.Conflict

The operation may conflicts with others, please retry later.

Mensagem retornada porque a operação entra em conflito com outras operações. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, visite o API Error Center.