Amazon Kinesis Data Streams 的操作、资源和条件键 - 服务授权参考
操作资源类型条件键
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

Amazon Kinesis Data Streams 的操作、资源和条件键

Amazon Kinesis Data Streams（服务前缀：kinesis）提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。

参考：

Amazon Kinesis Data Streams 定义的操作

您可以在 IAM policy 语句的 Action 元素中指定以下操作。可以使用策略授予在 Amazon 中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。

操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值，您必须在策略语句的 Resource 元素中指定策略应用的所有资源（“*”）。通过在 IAM policy 中使用条件来筛选访问权限，以控制是否可以在资源或请求中使用特定标签键。如果操作具有一个或多个必需资源，则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您在 IAM policy 中使用 Resource 元素限制资源访问权限，则必须为每种必需的资源类型添加 ARN 或模式。某些操作支持多种资源类型。如果资源类型是可选的（未指示为必需），则可以选择使用一种可选资源类型。

操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息，请参阅资源类型表的条件键列。

注意

资源条件键在资源类型表中列出。您可以在操作表的资源类型（* 为必需）列中找到应用于某项操作的资源类型的链接。资源类型表中的资源类型包括条件密钥列，这是应用于操作表中操作的资源条件键。

有关下表中各列的详细信息，请参阅操作表。

操作 描述 访问级别 资源类型（* 为必需） 条件键 相关操作
AddTagsToStream 授予为指定 Amazon Kinesis 流添加或更新标签的权限 每个流可最多可以有 10 个标签 Tagging

stream*

CreateStream 授予创建 Amazon Kinesis 流的权限 Write

stream*

DecreaseStreamRetentionPeriod 授予缩短流的保留期的权限，保留期是将数据记录添加到流中后可供访问的期限。 Write

stream*

DeleteResourcePolicy 授予删除与指定流或使用者关联的资源策略的权限 Write

consumer*

stream*

DeleteStream 授予删除流及其所有分片和数据的权限 Write

stream*

DeregisterStreamConsumer 授予从 Kinesis 数据流取消注册流使用者的权限。 Write

consumer*

DescribeLimits 授予描述账户的分片限制和使用量的权限 Read
DescribeStream 授予描述指定流的权限 Read

stream*

DescribeStreamConsumer 授予获取注册的流使用者描述的权限 Read

consumer*

DescribeStreamSummary 授予提供无分片列表的指定 Kinesis 数据流的摘要描述的权限 Read

stream*

DisableEnhancedMonitoring 授予禁用增强监控的权限 Write
EnableEnhancedMonitoring 授予对分片级别指标启用增强型 Kinesis 数据流监控的权限 Write
GetRecords 授予获取分片中数据记录的权限 Read

stream*

GetResourcePolicy 授予获取与指定流或使用者关联的资源策略的权限 Read

consumer*

stream*

GetShardIterator 授予获取分片迭代器的权限。分片迭代器将在其返回给请求者的五分钟后过期。 Read

stream*

IncreaseStreamRetentionPeriod 授予增加流的保留期的权限，保留期是将数据记录添加到流中后可供访问的期限。 Write

stream*

ListShards 授予列出流中的分片，并提供有关每个分片的信息的权限。 List

stream*

ListStreamConsumers 授予列出使用增强型扇出从 Kinesis 流中接收数据的注册流使用者，并提供有关每个使用者的信息的权限。 List

stream*

ListStreams 授予列出流的权限 List
ListTagsForStream 授予列出指定 Amazon Kinesis 流的标签的权限 Read

stream*

MergeShards 授予将两个相邻分片合并为一个流并将其组合为单一分片，从而减少流接收和传输数据的容量的权限。 Write

stream*

PutRecord 授予将来自创建器的单个数据记录写入 Amazon Kinesis 流中的权限 Write

stream*

PutRecords 授予通过单个调用（也称为 PutRecords 请求）将来自创建器的多个数据记录写入 Amazon Kinesis 流的权限 Write

stream*

PutResourcePolicy 授予将资源策略附加到指定流或使用者的权限 Write

consumer*

stream*

RegisterStreamConsumer 授予将流使用者注册到 Kinesis 数据流的权限。 Write

stream*

RemoveTagsFromStream 授予从指定 Kinesis 数据流移除标签的权限。移除的标签将被删除且在此操作成功完成后将无法恢复 Tagging

stream*

SplitShard 授予将一个分片分割为 Kinesis 数据流中的两个新分片，从而增加流接收和传输数据的容量的权限 Write

stream*

StartStreamEncryption 授予为指定流启用或更新使用 Amazon KMS 密钥进行服务器端加密的权限 Write

kmsKey*

stream*

StopStreamEncryption 授予为指定流禁用服务器端加密的权限 Write

kmsKey*

stream*

SubscribeToShard 授予侦听具有增强型扇出的特定分片的权限 Read

consumer*

UpdateShardCount 授予将指定流的分片数更新为指定分片数的权限 Write
UpdateStreamMode 授予更新数据流的容量模式的权限 Write

Amazon Kinesis Data Streams 定义的资源类型

以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键，从而定义资源类型。这些键显示在资源类型表的最后一列。有关下表中各列的详细信息，请参阅资源类型表。

资源类型 ARN 条件键
stream arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName}
consumer arn:${Partition}:kinesis:${Region}:${Account}:${StreamType}/${StreamName}/consumer/${ConsumerName}:${ConsumerCreationTimpstamp}
kmsKey arn:${Partition}:kms:${Region}:${Account}:key/${KeyId}

Amazon Kinesis Data Streams 的条件键

Kinesis 没有可以在策略语句的 Condition 元素中使用的服务特定上下文键。有关适用于所有服务的全局上下文键列表，请参阅可用的条件键。