Utilisation RetireGrant avec un AWS SDK ou une CLI - AWS Key Management Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation RetireGrant avec un AWS SDK ou une CLI

Les exemples de code suivants illustrent comment utiliser RetireGrant.

CLI
AWS CLI

Pour mettre hors service un octroi sur la clé principale d’un client

L’exemple retire-grant suivant supprime un octroi d’une clé KMS.

L’exemple de commande suivant spécifie les paramètres grant-id et key-id. La valeur du paramètre key-id doit être l’ARN de clé de la clé KMS.

aws kms retire-grant \ --grant-id 1234a2345b8a4e350500d432bccf8ecd6506710e1391880c4f7f7140160c9af3 \ --key-id arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

Cette commande ne produit aucune sortie. Pour confirmer que l’octroi a été résilié, utilisez la commande list-grants.

Pour plus d’informations, consultez Retrait et révocation d’octrois dans le Guide du développeur AWS Key Management Service.

  • Pour plus de détails sur l'API, reportez-vous RetireGrantà la section Référence des AWS CLI commandes.

Python
SDK pour Python (Boto3)
Note

Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le référentiel d’exemples de code 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.")
  • Pour plus de détails sur l'API, consultez RetireGrantle AWS manuel de référence de l'API SDK for Python (Boto3).

Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultezUtilisation de ce service avec un AWS SDK. Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes de SDK.