View a markdown version of this page

创建亚马逊 S3 配送 - Amazon Kinesis Data Streams
使用 Amazon Web Services 管理控制台使用 Amazon CLI
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

创建亚马逊 S3 配送

创建一个传输，将记录从 Amazon Kinesis Data Streams 流发送到通用的 Amazon S3 存储桶。您可以使用 Amazon Web Services 管理控制台 或创建配送 Amazon CLI。记录以源格式传送，批处理成大小最优的对象，具有可配置的压缩和由您定义的 S3 密钥结构。

注意

在创建交付之前，请完成中的先决条件S3 通用交付入门，包括中所述的 IAM 服务执行角色用于数据传输的 IAM 权限。

使用 Amazon Web Services 管理控制台

  1. 打开 Kinesis 控制台，网址为。https://console.amazonaws.cn/kinesis

  2. 在导航窗格中，选择 S3 通用交付，然后选择创建交付。

  3. 步骤 1：源配置。在配送详情下，输入配送名称。对于来源，选择要从中 On-Demand 传送的直播。仅显示 On-Demand 直播。选择下一步。

  4. 步骤 2：目标配置。选择一种记录格式（JSON、STRING 或 BYTE_ARRAY），然后指定目标：

    • S3 存储桶 ARN — 目标通用型 Amazon S3 存储桶的 ARN。

    • 预期存储桶所有者-预期存储桶所有者的 12 位 Amazon Web Services 账户 ID。

    • 压缩类型 -选择 GZIP、ZSTD 或无。

    • 存储类别 — 可以选择一个 Amazon S3 存储类别。

    • 输出密钥模板-可选择定义 Amazon S3 对象密钥结构。有关更多信息，请参阅 用于 Amazon S3 交付的 S3 输出密钥模板。

    • 数据新鲜度-传送记录之前的最大缓冲时间（以秒为单位）（最小 300，最大 900）。

    选择下一步。

  5. 步骤 3：其他配置。配置加密、服务访问权限（IAM 角色）、可选的死信队列、日志传输和标签。选择下一步。

  6. 步骤 4：查看并创建。查看您的配置，然后选择创建配送。配置完成后，交付将从 “创建” 转换为 “活动”。

使用 Amazon CLI

使用create-channel命令创建 Amazon S3 交付，将记录发送到采用 JSON 格式和 GZIP 压缩的通用亚马逊 S3 存储桶：

aws kinesis create-channel \
    --channel-name "my-s3-delivery" \
    --service-execution-role-arn "arn:aws:iam::111122223333:role/my-channel-role" \
    --stream-configuration-list '[
        {
            "StreamARN": "arn:aws:kinesis:us-east-1:111122223333:stream/my-stream",
            "RecordConfiguration": {
                "RecordFormatType": "JSON"
            }
        }
    ]' \
    --s3-destination-configuration '{
        "DataFreshnessInSeconds": 300,
        "StorageConfiguration": {
            "BucketARN": "arn:aws:s3:::amzn-s3-demo-destination-bucket",
            "ExpectedBucketOwner": "111122223333",
            "CompressionType": "GZIP",
            "StorageClass": "STANDARD"
        }
    }'

该命令返回频道 ARN () ChannelARN。将其与一起使用describe-channel来验证交付是否已达到 “活动” 状态。请参阅描述亚马逊 S3 的配送。要自定义 Amazon S3 对象密钥结构，请参阅用于 Amazon S3 交付的 S3 输出密钥模板。

API 参考 — 参见CreateChannel《亚马逊 Kinesis Data Streams API 参考》。