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á.
Use RetireGrant
com um AWS SDK ou CLI
Os exemplos de código a seguir mostram como usar o RetireGrant
.
- CLI
-
- AWS CLI
-
Como descontinuar uma concessão em uma chave mestra do cliente
O exemplo de retire-grant
a seguir exclui a concessão de uma chave do KMS.
O comando de exemplo a seguir especifica os parâmetros grant-id
e key-id
. O valor do parâmetro key-id
deve ser o ARN de chave da chave do KMS.
aws kms retire-grant \
--grant-id 1234a2345b8a4e350500d432bccf8ecd6506710e1391880c4f7f7140160c9af3
\
--key-id arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
Este comando não produz saída. Use o comando list-grants
para confirmar a descontinuação da concessão.
Para obter mais informações, consulte Retiring and revoking grants no Guia do desenvolvedor do AWS Key Management Service.
- Python
-
- SDK para Python (Boto3)
-
class GrantManager:
def __init__(self, kms_client):
self.kms_client = kms_client
@classmethod
def from_client(cls) -> "GrantManager":
"""
Creates a GrantManager instance with a default KMS client.
:return: An instance of GrantManager initialized with the default KMS client.
"""
kms_client = boto3.client("kms")
return cls(kms_client)
def retire_grant(self, grant):
"""
Retires a grant so that it can no longer be used.
:param grant: The grant to retire.
"""
try:
self.kms_client.retire_grant(GrantToken=grant["GrantToken"])
except ClientError as err:
logger.error(
"Couldn't retire grant %s. Here's why: %s",
grant["GrantId"],
err.response["Error"]["Message"],
)
else:
print(f"Grant {grant['GrantId']} retired.")
Para obter uma lista completa dos guias do desenvolvedor do AWS SDK e exemplos de código, consulteUsando este serviço com um AWS SDK. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.