

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Delete an key
<a name="key-deletion"></a>

Usuários autorizados podem usar a [https://docs.aws.amazon.com/kms/latest/APIReference/API_ScheduleKeyDeletion.html](https://docs.aws.amazon.com/kms/latest/APIReference/API_ScheduleKeyDeletion.html)API para agendar a exclusão de uma chave KMS e de todas as chaves associadas. HBKs Essa é uma operação inerentemente destrutiva, e você deve ter cuidado ao excluir chaves de. AWS KMS AWS KMS impõe um tempo mínimo de espera de sete dias ao excluir as chaves KMS. Durante o período de espera, a chave é colocada em um estado desativado com um estado de chave **Exclusão pendente**. Todas as chamadas para usar a chave para operações criptográficas falharão. ScheduleKeyDeletion usa os seguintes argumentos.

```
{
  "KeyId": "string",
  "PendingWindowInDays": number
}
```

**KeyId**  
O identificador exclusivo da chave KMS que será excluída. Para especificar esse valor, use o ID de chave exclusivo ou o ARN de chave da chave KMS. 

** PendingWindowInDays**  
(Opcional) O período de espera, em número de dias. Este valor é opcional. O intervalo é de 7 a 30 dias, e o valor padrão é de 30 dias. Após o término do período de espera, AWS KMS exclui a chave KMS e todas as associadas. HBKs