使用 IAM 控制对 Amazon Kinesis Data Streams 资源的访问

使用 AWS Identity and Access Management (IAM) 可以执行以下操作：

通过将 IAM 与 Kinesis Data Streams 配合使用，您可以控制组织中的用户能否用特定的 Kinesis Data Streams API 操作执行某项任务，以及他们能否使用特定的 AWS 资源。

如果您使用 Kinesis Client Library (KCL) 开发应用程序，您的策略必须包含对 Amazon DynamoDB 和 Amazon CloudWatch 的权限；KCL 使用 DynamoDB 跟踪应用程序的状态信息，并使用 CloudWatch 代表您将 KCL 指标发送到 CloudWatch。有关 KCL 的更多信息，请参阅使用 Kinesis Client Library 开发 Amazon Kinesis Data Streams 使用者。

有关 IAM 的更多信息，请参阅下文：

有关 IAM 和 Amazon DynamoDB 的更多信息，请参阅 Amazon DynamoDB 开发人员指南 中的使用 IAM 控制对 Amazon DynamoDB 资源的访问。

有关 IAM 和 Amazon CloudWatch 的更多信息，请参阅 Amazon CloudWatch 用户指南 中的 控制用户对您的 AWS 账户的访问。

策略语法

IAM 策略是包含一个或多个语句的 JSON 文档。每个语句的结构如下：

{
  "Statement":[{
    "Effect":"effect",
    "Action":"action",
    "Resource":"arn",
    "Condition":{
      "condition":{
        "key":"value"
        }
      }
    }
  ]
}

组成语句的各个元素如下：

在创建和管理 IAM 策略时，您可能希望使用 IAM 策略生成器和 IAM 策略模拟器。

针对 Kinesis Data Streams 的操作

在 IAM 策略语句中，您可以从支持 IAM 的任何服务中指定任何 API 操作。对于 Kinesis Data Streams，请使用以下前缀为 API 操作命名：kinesis:。例如：kinesis:CreateStream、kinesis:ListStreams 和 kinesis:DescribeStream。

要在单个语句中指定多项操作，请使用逗号将它们隔开，如下所示：

"Action": ["kinesis:action1", "kinesis:action2"]

您也可以使用通配符指定多项操作。例如，您可以指定名称以单词“Get”开头的所有操作，如下所示：

"Action": "kinesis:Get*"

要指定所有 Kinesis Data Streams 操作，请使用 * 通配符，如下所示：

"Action": "kinesis:*"

有关 Kinesis Data Streams API 操作的完整列表，请参阅 Amazon Kinesis API Reference。

适用于 Kinesis Data Streams 的 Amazon 资源名称 (ARN)

每个 IAM 策略语句适用于您使用资源的 ARN 指定的资源。

请对 Kinesis data stream使用以下 ARN 资源格式：

arn:aws-cn:kinesis:region:account-id:stream/stream-name

例如：

"Resource": arn:aws-cn:kinesis:*:111122223333:stream/my-stream

Kinesis Data Streams 策略示例

以下策略示例演示如何控制用户对您的 Kinesis data stream的访问。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kinesis:Get*",
                "kinesis:DescribeStream"
            ],
            "Resource": [
                "arn:aws-cn:kinesis:us-east-1:111122223333:stream/stream1"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "kinesis:ListStreams"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kinesis:PutRecord"
            ],
            "Resource": [
                "arn:aws-cn:kinesis:us-east-1:111122223333:stream/*"
            ]
        }
    ]
}

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "kinesis:*",
            "Resource": [
                "arn:aws-cn:kinesis:us-east-1:111122223333:stream/stream1"
            ]
        }
    ]
}

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "kinesis:*",
            "Resource": [
                "arn:aws-cn:kinesis:*:111122223333:stream/*"
            ]
        }
    ]
}

本页内容：

• 策略语法
• 针对 Kinesis Data Streams 的操作
• 适用于 Kinesis Data Streams 的 Amazon 资源名称 (ARN)
• Kinesis Data Streams 策略示例