Todos os produtos
Search
Central de documentação

Elastic Compute Service:DeleteSnapshot

Última atualização: Oct 22, 2026

Exclui um snapshot especificado. Você também pode chamar esta operação para excluir um snapshot que está sendo criado, o que cancela a tarefa de criação do snapshot.

Descrição da operação

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

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

  • Se o snapshot tiver sido usado para criar uma imagem personalizada, você não poderá executar a operação de exclusão. Você deve excluir a imagem personalizada criada (DeleteImage) antes de poder excluir o snapshot.

  • Se o snapshot tiver sido usado para criar um disco em nuvem e as configurações do parâmetro Force não forem especificadas ou Force=false, você não poderá excluir o snapshot diretamente. Se tiver certeza de que deseja excluir o snapshot, altere as configurações para Force=true para forçar a exclusão do snapshot. Após o snapshot ser excluído à força, o disco em nuvem correspondente não poderá executar a inicialização.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

SnapshotId

string

Sim

O ID do snapshot.

s-bp1c0doj0taqyzzl****

Force

boolean

Não

Especifica se deve forçar a exclusão de um snapshot que foi usado para criar um disco em nuvem. Valores válidos:

  • true: força a exclusão do snapshot. Após o snapshot ser excluído à força, o disco em nuvem não poderá ser reinicializado.

  • false: não força a exclusão do snapshot.

Valor padrão: false.

false

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 MissingParameter The input parameter SnapshotId that is mandatory for processing this request is not supplied. Um parâmetro obrigatório está ausente.
400 IncorrectDiskStatus.CreatingSnapshot A previous snapshot creation is in process. Um snapshot está sendo criado para o disco. Aguarde até que o snapshot seja criado e tente novamente.
500 InternalError The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403 SnapshotCreatedImage The snapshot has been used to create user defined image(s). O snapshot não pode ser excluído porque foi usado para criar uma imagem personalizada. Você deve excluir a imagem personalizada chamando a operação DeleteImage antes de poder excluir o snapshot.
403 SnapshotCreatedDisk The snapshot has been used to create disk(s). O snapshot especificado foi usado para criar um disco. Quando as configurações do parâmetro Force não são especificadas ou o parâmetro Force é definido como false, o snapshot não pode ser excluído diretamente. Se tiver certeza de que deseja excluir o snapshot, defina o parâmetro Force como true para forçar a exclusão do snapshot. Após a exclusão forçada do snapshot, você não poderá executar a inicialização no disco correspondente novamente.
403 Operation.Conflict The operation may conflict with others. Please retry later.
403 InvalidOperation.RelatedSnapshotNotFinished The related standard snapshot is not finished. O snapshot atual possui snapshots associados que estão incompletos. Tente novamente mais tarde.
403 InvalidOperation.DeleteSharedSnapshotUnsupported The current snapshot shares authorization with other users. Please revoke the shared authorization through resource management first. O snapshot está atualmente compartilhado com outros usuários. Revogue a autorização no Resource Management antes de prosseguir.
403 InvalidOperation.ResourceManagedByCloudProduct The current operation is not supported because the resource is managed by a cloud product. Please contact the relevant cloud product to confirm the reason. Os grupos de segurança gerenciados por serviços em nuvem não podem ser modificados.
403 InvalidOperation.SnapshotIsLocked The current operation is not supported because the snapshot is locked. Please wait for the lock to expire before retrying. Esta operação não é suportada porque o snapshot está bloqueado. Aguarde o bloqueio expirar e tente novamente.
403 InvalidStatus.SnapshotWarmingUp The specified snapshot has an active warming-up task and cannot be deleted. Please wait for the warming-up task to complete and try again.
404 InvalidSnapshotId.NotFound The specified snapshot is not found. O snapshot especificado não existe. Verifique se o ID do snapshot está correto.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.