Verwendung von RetireGrant mit einem AWS-SDK oder CLI - AWS-SDK-Codebeispiele

Weitere AWS-SDK-Beispiele sind im GitHub-Repository Beispiele für AWS Doc SDKs verfügbar.

Verwendung von RetireGrant mit einem AWS-SDK oder CLI

Die folgenden Code-Beispiele zeigen, wie RetireGrant verwendet wird.

CLI
AWS CLI

So ziehen Sie eine Erteilung für einen Kundenhauptschlüssel zurück

Im folgenden retire-grant-Beispiel wird eine Erteilung aus einem KMS-Schlüssel gelöscht.

Der folgende Beispielbefehl legt die Parameter grant-id und key-id fest. Der Wert des Parameters key-id muss der Schlüssel-ARN des KMS-Schlüssels sein.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Verwenden Sie den Befehl list-grants, um zu bestätigen, dass die Erteilung zurückgezogen wurde.

Weitere Informationen finden Sie unter Zurückziehen und Widerrufen von Erteilungen im Entwicklerhandbuch für AWS Key Management Service.

  • Weitere API-Informationen finden Sie unter RetireGrant in der AWS CLI-Befehlsreferenz.

Python
SDK für Python (Boto3)
Anmerkung

Auf GitHub finden Sie noch mehr. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das AWS-Code-Beispiel- einrichten und ausführen.

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.")
  • Weitere API-Informationen finden Sie unter RetireGrant in der API-Referenz zum AWS SDK für Python (Boto3).