Usar o RetireGrant
com um AWS SDK ou a 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
ekey-id
. O valor do parâmetrokey-id
deve ser o ARN de chave da chave do KMS.aws kms retire-grant \ --grant-id
1234a2345b8a4e350500d432bccf8ecd6506710e1391880c4f7f7140160c9af3
\ --key-idarn: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.
-
Para obter detalhes da API, consulte RetireGrant
na Referência de comandos da AWS CLI.
-
- Python
-
- SDK para Python (Boto3).
-
nota
Há mais no GitHub. Encontre o exemplo completo e saiba como configurar e executar no Repositório de exemplos de código da AWS
. 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 detalhes da API, consulte RetireGrant na Referência da API AWS SDK para Python (Boto3).
-
Para ver uma lista completa dos Guias do desenvolvedor de SDK da AWS e exemplos de código, consulte Usar 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.