Todos os produtos
Search
Central de documentação

:DeleteSecret

Última atualização: Jul 09, 2026

Exclui um segredo.

Você pode agendar a exclusão de um segredo em uma janela de 7 a 30 dias. Durante esse período, é possível restaurar o segredo. Você também pode excluir um segredo imediatamente. Nesse caso, a restauração não estará disponível.

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

DeleteSecret

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

SecretName

String

Sim

secret001

O Alibaba Cloud Resource Name (ARN) do segredo ou recurso de segredo.

Nota

Ao acessar um segredo em outra conta Alibaba Cloud, insira o ARN do segredo. O ARN segue o formato acs:kms:${region}:${account}:secret/${secret-name}.

ForceDeleteWithoutRecovery

String

Não

false

Especifique se o segredo deve ser excluído imediatamente.

Valores válidos:

  • true

  • false (padrão)

RecoveryWindowInDays

String

Não

10

Janela de exclusão agendada especificada ao programar a exclusão do segredo. Durante esse período, é possível restaurar o segredo. Valores válidos: 7 a 30 dias.

Valor padrão: 30. Unidade: Dias.

Nota

Para excluir um segredo imediatamente e definir ForceDeleteWithoutRecovery como true, não defina RecoveryWindowInDays.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

SecretName

String

secret001

Nome do segredo.

RequestId

String

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

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

PlannedDeleteTime

String

2024-04-15T07:02:14Z

Momento em que o segredo será excluído. O valor está no formato de timestamp.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DeleteSecret
&SecretName=secret001
&ForceDeleteWithoutRecovery=false
&RecoveryWindowInDays=10
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<DeleteSecretResponse>
    <SecretName>secret001</SecretName>
    <RequestId>38bbed2a-15e0-45ad-98d4-816ad2ccf4ea</RequestId>
    <PlannedDeleteTime>2022-09-15T07:02:14Z</PlannedDeleteTime>
</DeleteSecretResponse>

Formato JSON

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

{
  "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.

O parâmetro especificado é inválido.

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