Todos os produtos
Search
Central de documentação

Key Management Service:DeleteSecret

Última atualização: Jun 28, 2026

Exclui um segredo.

Descrição da operação

Se você chamar esta operação sem especificar um período de recuperação, o segredo excluído poderá ser recuperado em até 30 dias.

Se você especificar um período de recuperação, o segredo excluído poderá ser recuperado dentro desse período. Você também pode excluir forçadamente um segredo. Um segredo excluído forçadamente não pode ser recuperado.

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

SecretName

string

Sim

O nome do segredo.

secret001

ForceDeleteWithoutRecovery

string

Não

Especifica se o segredo deve ser excluído forçadamente. Se este parâmetro for definido como true, o segredo não poderá ser recuperado.

Valores válidos:

  • true

  • false (valor padrão)

false

RecoveryWindowInDays

string

Não

Especifica o período de recuperação do segredo se você não o excluir forçadamente. Valor padrão: 30. Unidade: dias.

10

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

SecretName

string

O nome do segredo.

secret001

RequestId

string

O ID da solicitação, que é usado para localizar e solucionar problemas.

38bbed2a-15e0-45ad-98d4-816ad2ccf4ea

PlannedDeleteTime

string

A hora em que o segredo está programado para ser excluído.

2022-09-15T07:02:14Z

Exemplos

Resposta de sucesso

JSON formato

{
  "SecretName": "secret001",
  "RequestId": "38bbed2a-15e0-45ad-98d4-816ad2ccf4ea",
  "PlannedDeleteTime": "2022-09-15T07:02:14Z"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter The specified parameter is not valid. An invalid value is specified for the parameter.
500 InternalFailure Internal Failure
404 Forbidden.ResourceNotFound Resource not found
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.
409 Rejected.ResourceInDeleteWindow secret in delete peroid

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.