View a markdown version of this page

使用 GetKeyPolicy 用 Amazon SDK 或 CLI - Amazon Key Management Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用 GetKeyPolicy 用 Amazon SDK 或 CLI

以下代码示例显示了如何使用 GetKeyPolicy。

操作示例是大型程序的代码摘录,必须在上下文中运行。在以下代码示例中,您可以查看此操作的上下文:

CLI
Amazon CLI

将密钥策略从一个 KMS 密钥复制到另一个 KMS 密钥

以下 get-key-policy 示例从一个 KMS 密钥获取密钥策略并将其保存在文本文件中。然后,它使用文本文件作为策略输入替换其他 KMS 密钥的策略。

由于 put-key-policy 的 --policy 参数需要字符串,因此,您必须使用 --output text 选项将输出作为文本字符串(而不是 JSON)返回。

aws kms get-key-policy \ --policy-name default \ --key-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --query Policy \ --output text > policy.txt

以下 put-key-policy 示例使用 policy.txt 文件来替换其他 KMS 密钥的密钥策略。

aws kms put-key-policy \ --policy-name default \ --key-id a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 \ --policy file://policy.txt

policy.txt 的内容:

{ "Version":"2012-10-17", "Id": "key-default-1", "Statement": [ { "Sid": "Enable IAM User Permissions", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::123456789012:root" }, "Action": "kms:*", "Resource": "*" } ] }

此命令不生成任何输出。

有关更多信息,请参阅 中的关键政策 Amazon 千米 在 Amazon 密钥管理服务开发者指南。

  • 有关 API 的详细信息,请参阅 GetKeyPolicy 在 Amazon CLI 命令参考。

Python
适用于 Python 的 SDK(Boto3)
注意

还有更多关于 GitHub。在 Amazon 代码示例存储库中查找完整示例,了解如何进行设置和运行。

class KeyPolicy: def __init__(self, kms_client): self.kms_client = kms_client @classmethod def from_client(cls) -> "KeyPolicy": """ Creates a KeyPolicy instance with a default KMS client. :return: An instance of KeyPolicy initialized with the default KMS client. """ kms_client = boto3.client("kms") return cls(kms_client) def get_policy(self, key_id: str) -> dict[str, str]: """ Gets the policy of a key. :param key_id: The ARN or ID of the key to query. :return: The key policy as a dict. """ if key_id != "": try: response = self.kms_client.get_key_policy( KeyId=key_id, ) policy = json.loads(response["Policy"]) except ClientError as err: logger.error( "Couldn't get policy for key %s. Here's why: %s", key_id, err.response["Error"]["Message"], ) raise else: pprint(policy) return policy else: print("Skipping get policy demo.")
  • 有关 API 的详细信息,请参阅 GetKeyPolicy 在 Amazon 适用于 Python 的 SDK (Boto3) API 参考。

SAP ABAP
适用于 SAP ABAP 的 SDK
注意

还有更多关于 GitHub。在 Amazon 代码示例存储库中查找完整示例,了解如何进行设置和运行。

TRY. " iv_key_id = 'arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab' oo_result = lo_kms->getkeypolicy( iv_keyid = iv_key_id iv_policyname = 'default' ). MESSAGE 'Retrieved key policy successfully.' TYPE 'I'. CATCH /aws1/cx_kmsnotfoundexception. MESSAGE 'Key not found.' TYPE 'E'. CATCH /aws1/cx_kmskmsinternalex. MESSAGE 'An internal error occurred.' TYPE 'E'. ENDTRY.
  • 有关 API 的详细信息,请参阅 GetKeyPolicy 在 Amazon 适用于 SAP 的 SDK ABAP API 参考。

如需查看完整清单 Amazon SDK 开发者指南和代码示例,请参阅 将此服务与 Amazon SDK。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。