本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
EnableKeyRotation
搭配 AWS SDK 或 CLI 使用
下列程式碼範例示範如何使用 EnableKeyRotation
。
- CLI
-
- AWS CLI
-
啟用 KMS 金鑰的自動輪換
下列
enable-key-rotation
範例會啟用客戶受管 KMS 金鑰的自動輪換,輪換期間為 180 天。KMS 金鑰將自此命令完成之日起一年 (大約 365 天) 輪換,之後每年輪換一次。--key-id
參數可識別 KMS 金鑰。此範例使用金鑰 ARN 值,但您可以使用 KMS 金鑰的金鑰 ID 或 ARN。--rotation-period-in-days
參數會指定每個輪換日期之間的天數。指定介於 90 到 2560 天之間的值。如果未指定值,預設值為 365 天。aws kms enable-key-rotation \ --key-id
arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
\ --rotation-period-in-days180
此命令不會產生輸出。若要確認 KMS 金鑰已啟用,請使用
get-key-rotation-status
命令。如需詳細資訊,請參閱 金鑰管理服務開發人員指南中的輪換AWS 金鑰。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 EnableKeyRotation
。
-
- Python
-
- SDK for Python (Boto3)
-
注意
GitHub 上提供更多範例。尋找完整範例,並了解如何在 AWS 程式碼範例儲存庫
中設定和執行。 class KeyManager: def __init__(self, kms_client): self.kms_client = kms_client self.created_keys = [] @classmethod def from_client(cls) -> "KeyManager": """ Creates a KeyManager instance with a default KMS client. :return: An instance of KeyManager initialized with the default KMS client. """ kms_client = boto3.client("kms") return cls(kms_client) def enable_key_rotation(self, key_id: str) -> None: """ Enables rotation for a key. :param key_id: The ARN or ID of the key to enable rotation for. """ try: self.kms_client.enable_key_rotation(KeyId=key_id) except ClientError as err: logging.error( "Couldn't enable rotation for key '%s'. Here's why: %s", key_id, err.response["Error"]["Message"], ) raise
-
如需 API 詳細資訊,請參閱 AWS SDK for Python (Boto3) API 參考中的 EnableKeyRotation。
-
如需 AWS SDK 開發人員指南和程式碼範例的完整清單,請參閱 將此服務與 搭配使用 AWS SDK。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。
EnableKey
Encrypt