适用于 Amazon DynamoDB 的 Amazon Kinesis Data Streams 的自定义 IAM 策略 - Amazon DynamoDB
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

适用于 Amazon DynamoDB 的 Amazon Kinesis Data Streams 的自定义 IAM 策略

首次为 DynamoDB 启用 Kinesis Data Streams 时,DynamoDB 会自动为您创建一个 AWS Identity and Access Management (IAM) 服务相关角色。此角色 AWSServiceRoleForDynamoDBKinesisDataStreamsReplication 允许 DynamoDB 代表您管理将项目级更改复制到 Kinesis Data Streams 的过程。不要删除该服务相关角色。

有关服务相关角色的更多信息,请参阅 https://docs.amazonaws.cn/IAM/latest/UserGuide/using-service-linked-roles.html 中的使用服务相关角色IAM 用户指南。

以下示例说明如何使用 IAM 策略为 DynamoDB 的 Kinesis Data Streams 授予权限。

  • 要为 DynamoDB 启用 Kinesis Data Streams,您必须对表具有 dynamodb:EnableKinesisStreamingDestination 权限。

  • 要禁用适用于 DynamoDB 的 Kinesis Data Streams,您必须对表具有 dynamodb:DisableKinesisStreamingDestination 权限。

  • 要描述给定 DynamoDB 表的 DynamoDB 的 Kinesis Data Streams,您必须具有表的 dynamodb:DescribeKinesisStreamingDestination 权限。

示例:为 DynamoDB 启用 Kinesis 数据流

以下 IAM 策略为 DynamoDB 表授予为 Music 启用 Kinesis Data Streams 的权限,并且不授予为 DynamoDB 表禁用或描述 Music 的 Kinesis Data Streams 的权限。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:CreateServiceLinkedRole", "Resource": "arn:aws:iam::*:role/aws-service-role/kinesisreplication.dynamodb.amazonaws.com/AWSServiceRoleForDynamoDBKinesisDataStreamsReplication", "Condition": {"StringLike": {"iam:AWSServiceName": "kinesisreplication.dynamodb.amazonaws.com"}} }, { "Effect": "Allow", "Action": [ "dynamodb:EnableKinesisStreamingDestination" ], "Resource": "arn:aws:dynamodb:us-west-2:123456789012:table/Music" } ] }

示例:禁用 DynamoDB 的 Kinesis 数据流

以下 IAM 策略授予对 DynamoDB 表禁用适用于 Music 的 Kinesis Data Streams 的权限,而不授予对 DynamoDB 表启用或描述适用于 Music 的 Kinesis Data Streams 的权限。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "dynamodb:DisableKinesisStreamingDestination" ], "Resource": "arn:aws:dynamodb:us-west-2:123456789012:table/Music" } ] }

示例:基于资源为 DynamoDB 的 Kinesis 数据流选择应用权限

以下 IAM 策略授予为 DynamoDB 表启用和描述 Music 的 Kinesis Data Streams 的权限,并拒绝为 DynamoDB 表禁用 Orders 的 Kinesis Data Streams 的权限。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "dynamodb:EnableKinesisStreamingDestination", "dynamodb:DescribeKinesisStreamingDestination" ], "Resource": "arn:aws:dynamodb:us-west-2:123456789012:table/Music" }, { "Effect": "Deny", "Action": [ "dynamodb:DisableKinesisStreamingDestination" ], "Resource": "arn:aws:dynamodb:us-west-2:123456789012:table/Orders" } ] }

对 Kinesis Data Streams for DynamoDB 使用服务相关角色

Amazon Kinesis Data Streams for Amazon DynamoDB 使用 AWS Identity and Access Management (IAM) 服务相关角色。服务相关角色是一种与 Kinesis Data Streams for DynamoDB 直接关联的独特类型的 IAM 角色。服务相关角色由 Kinesis Data Streams for DynamoDB 预定义,并包含该服务代表您调用其他 AWS 服务所需的一切权限。

服务相关角色使 Kinesis Data Streams for DynamoDB 的设置更轻松,因为您不必手动添加必要的权限。Kinesis Data Streams for DynamoDB 定义其服务相关角色的权限,除非另行定义,否则仅 Kinesis Data Streams for DynamoDB 可以代入其角色。定义的权限包括信任策略和权限策略,并且权限策略不能附加到任何其他 IAM 实体。

有关支持服务相关角色的其他服务的信息,请参阅与 IAM 配合使用的 AWS 服务并查找 Service-Linked Role 列为 Yes 的服务。选择 Yes 与查看该服务的服务相关角色文档的链接。

适用于 Kinesis Data Streams for DynamoDB 的服务相关角色权限

Kinesis Data Streams for DynamoDB 使用名为 AWSServiceRoleForDynamoDBKinesisDataStreamsReplication 的服务相关角色。The purpose of the service-linked role is to allow Amazon DynamoDB to manage the replication of item-level changes to Kinesis Data Streams, on your behalf.

AWSServiceRoleForDynamoDBKinesisDataStreamsReplication 服务相关角色信任以下服务代入该角色:

  • kinesisreplication.dynamodb.amazonaws.com

角色权限策略允许 Kinesis Data Streams for DynamoDB 对指定资源完成以下操作:

  • 操作: Put records and describe 上的 Kinesis stream

您必须配置权限以允许 IAM 实体(如用户、组或角色)创建、编辑或删除服务相关角色。有关更多信息,请参阅 https://docs.amazonaws.cn/IAM/latest/UserGuide/contributorinsights-service-linked-roles.html#service-linked-role-permissions 中的IAM 用户指南服务相关角色权限

为 Kinesis Data Streams for DynamoDB 创建服务相关角色

您无需手动创建服务相关角色。在 AWS 管理控制台、AWS CLI 或 AWS API 中enable Kinesis Data Streams for DynamoDB时,Kinesis Data Streams for DynamoDB 将为您创建服务相关角色。

如果您删除了此服务相关角色然后需要再次创建它,则可以使用相同的流程在您的账户中重新创建此角色。当您enable Kinesis Data Streams for DynamoDB时,Kinesis Data Streams for DynamoDB 将再次为您创建服务相关角色。

编辑 Kinesis Data Streams for DynamoDB 的服务相关角色

Kinesis Data Streams for DynamoDB 不允许您编辑 AWSServiceRoleForDynamoDBKinesisDataStreamsReplication 服务相关角色。创建服务相关角色后,您将无法更改角色的名称,因为可能有多种实体引用该角色。但是,您可以使用 IAM 编辑角色的说明。有关更多信息,请参阅 https://docs.amazonaws.cn/IAM/latest/UserGuide/contributorinsights-service-linked-roles.html#edit-service-linked-role 中的IAM 用户指南编辑服务相关角色

删除 Kinesis Data Streams for DynamoDB 的服务相关角色

您还可以使用 IAM 控制台、AWS CLI 或 AWS API 来手动删除服务相关角色。为此,您必须先手动清除服务相关角色的资源,然后才能手动删除它。

注意

如果在您试图删除资源时 Kinesis Data Streams for DynamoDB 服务正在使用该角色,则删除操作可能会失败。如果发生这种情况,则请等待几分钟后重试。

使用 手动删除服务相关角色 IAM

使用 IAM 控制台、AWS CLI 或 AWS API 删除 AWSServiceRoleForDynamoDBKinesisDataStreamsReplication 服务相关角色。有关更多信息,请参阅 https://docs.amazonaws.cn/IAM/latest/UserGuide/using-service-linked-roles.html 中的IAM 用户指南删除服务相关角色