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

# 创建亚马逊 S3 配送
<a name="data-delivery-s3-create"></a>

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

**注意**  
 在创建交付之前，请完成中的先决条件[S3 通用交付入门](data-delivery-s3-getting-started.md)，包括中所述的 IAM 服务执行角色[用于数据传输的 IAM 权限](data-delivery-iam.md)。

## 使用 Amazon Web Services 管理控制台
<a name="data-delivery-s3-create-console"></a>

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

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

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

1. **步骤 2：目标配置。**选择一种**记录格式**（**JSON**、**STRING** 或 **BYTE\_ARRAY**），然后指定目标：
   + **S3 存储桶 ARN** — 目标通用型 Amazon S3 存储桶的 ARN。
   + **预期存储桶所有者**-预期存储桶所有者的 12 位 Amazon Web Services 账户 ID。
   + **压缩类型** **-选择 **GZIP**、**ZSTD** 或无。**
   + **存储类别** — 可以选择一个 Amazon S3 存储类别。
   + **输出密钥模板**-可选择定义 Amazon S3 对象密钥结构。有关更多信息，请参阅 [用于 Amazon S3 交付的 S3 输出密钥模板](data-delivery-s3-key-template.md)。
   + **数据新鲜度**-传送记录之前的最大缓冲时间（以秒为单位）（最小 300，最大 900）。

   选择**下一步**。

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

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

## 使用 Amazon CLI
<a name="data-delivery-s3-create-cli"></a>

 使用`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 的配送](data-delivery-s3-describe.md)。要自定义 Amazon S3 对象密钥结构，请参阅[用于 Amazon S3 交付的 S3 输出密钥模板](data-delivery-s3-key-template.md)。

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