Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅
中国的 Amazon Web Services 服务入门
(PDF)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
RetireGrant
搭配使用 Amazon SDK或 CLI
以下代码示例演示如何使用 RetireGrant
。
- CLI
-
- Amazon CLI
-
停用对客户主密钥的授权
以下retire-grant
示例从KMS密钥中删除授权。
以下示例命令指定 grant-id
和 key-id
参数。key-id
参数的值必须是密钥ARN的KMS键。
aws kms retire-grant \
--grant-id 1234a2345b8a4e350500d432bccf8ecd6506710e1391880c4f7f7140160c9af3
\
--key-id arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
此命令不生成任何输出。要确认授权是否已停用,请使用 list-grants
命令。
有关更多信息,请参阅《中止和撤销授权》Amazon 密钥管理服务开发人员指南。
- Python
-
- SDK适用于 Python (Boto3)
-
class GrantManager:
def __init__(self, kms_client):
self.kms_client = 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.")
有关完整列表 Amazon SDK开发者指南和代码示例,请参阅使用 Amazon KMS 用一个 Amazon SDK。本主题还包括有关入门的信息以及有关先前SDK版本的详细信息。