Todos os produtos
Search
Central de documentação

Key Management Service:ScheduleKeyDeletion

Última atualização: Jun 28, 2026

Exclui uma chave mestra de cliente (CMK) especificada.

Descrição da operação

Durante o período agendado, a CMK está no estado PendingDeletion e não pode ser usada para criptografar dados, descriptografar dados ou gerar chaves de dados.

Após a exclusão de uma CMK, ela não pode ser recuperada. Os dados criptografados e as chaves de dados geradas com o uso da CMK não podem ser descriptografados. Para evitar a exclusão acidental de CMKs, o Key Management Service (KMS) permite apenas agendar tarefas de exclusão de chaves. Você não pode excluir CMKs diretamente. Se quiser excluir uma CMK, chame a operação DisableKey para desativar a CMK.

Ao chamar esta operação, você deve especificar um período agendado entre 7 e 366 dias. O período agendado começa a partir do momento em que você envia a solicitação. Você pode chamar a operação CancelKeyDeletion para cancelar a tarefa de exclusão da chave antes do término do período agendado.

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

KeyId

string

Sim

O ID da chave mestra de cliente (CMK). O ID deve ser globalmente exclusivo.

7906979c-8e06-46a2-be2d-68e3ccbc****

PendingWindowInDays

integer

Sim

O período agendado após o qual a CMK é excluída. Durante esse período, a CMK está no estado PendingDeletion. Após o término desse período, você não pode cancelar a tarefa de exclusão da chave.

Valores válidos: 7 a 366.

Unidade: dias.

7

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

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

3da5b8cc-8107-40ac-a170-793cd181d7b7

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "3da5b8cc-8107-40ac-a170-793cd181d7b7"
}

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.
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.