使用适用于 Amazon Kinesis Data Streams 和 Amazon DynamoDB 的 IAM 策略 - Amazon DynamoDB

使用适用于 Amazon Kinesis Data Streams 和 Amazon DynamoDB 的 IAM 策略

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

有关服务相关角色的更多信息,请参见 IAM 用户指南中的使用服务相关角色

注意

DynamoDB 不支持基于标签的 IAM 策略条件。

要启用 Amazon Kinesis Data Streams for Amazon DynamoDB,您必须对该表具有以下权限:

  • dynamodb:EnableKinesisStreamingDestination

  • kinesis:ListStreams

  • kinesis:PutRecords

  • kinesis:DescribeStream

要为给定的 DynamoDB 表描述 Amazon Kinesis Data Streams for Amazon DynamoDB,您必须对该表具有以下权限。

  • dynamodb:DescribeKinesisStreamingDestination

  • kinesis:DescribeStreamSummary

  • kinesis:DescribeStream

要禁用 Amazon Kinesis Data Streams for Amazon DynamoDB,您必须对该表具有以下权限。

  • dynamodb:DisableKinesisStreamingDestination

要更新 Amazon Kinesis Data Streams for Amazon DynamoDB,您必须对该表具有以下权限。

  • dynamodb:UpdateKinesisStreamingDestination

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

示例:启用 Amazon Kinesis Data Streams for Amazon DynamoDB

以下 IAM 策略授予了为 Music 表启用 Amazon Kinesis Data Streams for Amazon DynamoDB 的权限。它不授予为 Music 表禁用、更新或描述 Kinesis Data Streams for DynamoDB 的权限。

{ "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:12345678901:table/Music" } ] }

示例:更新 Amazon Kinesis Data Streams for Amazon DynamoDB

以下 IAM 策略授予了为 Music 表更新 Amazon Kinesis Data Streams for Amazon DynamoDB 的权限。它不授予为 Music 表启用、禁用或描述 Amazon Kinesis Data Streams for Amazon DynamoDB 的权限。

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

示例:禁用 Amazon Kinesis Data Streams for Amazon DynamoDB

以下 IAM 策略授予了为 Music 表禁用 Amazon Kinesis Data Streams for Amazon DynamoDB 的权限。它不授予为 Music 表启用、更新或描述 Amazon Kinesis Data Streams for Amazon DynamoDB 的权限。

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

示例:根据资源有选择地应用 Amazon Kinesis Data Streams for Amazon DynamoDB 权限

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

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "dynamodb:EnableKinesisStreamingDestination", "dynamodb:DescribeKinesisStreamingDestination" ], "Resource": "arn:aws:dynamodb:us-west-2:12345678901:table/Music" }, { "Effect": "Deny", "Action": [ "dynamodb:DisableKinesisStreamingDestination" ], "Resource": "arn:aws:dynamodb:us-west-2:12345678901: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 服务并查找服务相关角色列中显示为的服务。选择和链接,查看该服务的服务相关角色文档。

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

Kinesis Data Streams for DynamoDB 使用名为 AWSServiceRoleForDynamoDBKinesisDataStreamsReplication 的服务相关角色。服务相关角色的目的是允许 Amazon DynamoDB 代表您管理项目级 Kinesis Data Streams 改动的复制。

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

  • kinesisreplication.dynamodb.amazonaws.com

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

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

  • 操作:AWS KMS 上的 Generate data keys,以将数据放到使用用户生成的 AWS KMS 密钥加密的 Kinesis 数据流中。

有关该策略文档的确切内容,请参阅 DynamoDBKinesisReplicationServiceRolePolicy

您必须配置权限,允许 IAM 实体(如用户、组或角色)创建、编辑或删除服务相关角色。有关更多信息,请参阅《IAM 用户指南》中的服务相关角色权限

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

您无需手动创建服务相关角色。在 AWS Management Console、AWS CLI 或 AWS API 中启用 Kinesis Data Streams for DynamoDB 后,Kinesis Data Streams for DynamoDB 将为您创建服务相关角色。

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

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

Kinesis Data Streams for DynamoDB 不允许您编辑 AWSServiceRoleForDynamoDBKinesisDataStreamsReplication 服务相关角色。创建服务相关角色后,您将无法更改角色的名称,因为可能有多种实体引用该角色。但是可以使用 IAM 编辑角色描述。有关更多信息,请参见 IAM 用户指南中的编辑服务相关角色

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

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

注意

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

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

使用 IAM 控制台,即 AWS CLI 或 AWS API 来删除 AWSServiceRoleForDynamoDBKinesisDataStreamsReplication 服务相关角色。有关更多信息,请参见 IAM 用户指南中的删除服务相关角色