

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon S3 전송 생성
<a name="data-delivery-s3-create"></a>

 Amazon Kinesis Data Streams 스트림의 레코드를 범용 Amazon S3 버킷으로 전송하는 전송을 생성합니다. AWS Management Console 또는를 사용하여 전송을 생성할 수 있습니다 AWS CLI. 레코드는 소스 형식으로 전달되며, 구성 가능한 압축과 정의한 S3 키 구조를 사용하여 최적의 크기의 객체로 일괄 처리됩니다.

**참고**  
 전송을 생성하기 전에에 설명된 IAM 서비스 실행 역할을 [S3 범용 전송 시작하기](data-delivery-s3-getting-started.md)포함하여의 사전 조건을 완료합니다[데이터 전송을 위한 IAM 권한](data-delivery-iam.md).

## 사용 AWS Management Console
<a name="data-delivery-s3-create-console"></a>

1. 에서 Kinesis 콘솔을 엽니다[https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis).

1. 탐색 창에서 **S3 범용 전송**을 선택한 다음 **전송 생성을** 선택합니다.

1. **1단계: 소스 구성.** **전송 세부 정보**에서 **전송 이름을** 입력합니다. **소스**에서 전송할 온디맨드 스트림을 선택합니다. 온디맨드 스트림만 표시됩니다. **다음**을 선택합니다.

1. **2단계: 대상 구성.** **레코드 형식**(**JSON**, **STRING** 또는 **BYTE\_ARRAY**)을 선택한 다음 대상을 지정합니다.
   + **S3 버킷 ARN** - 대상 범용 Amazon S3 버킷의 ARN입니다.
   + **예상 버킷 소유자** - 예상 버킷 소유자의 12자리 AWS 계정 ID입니다.
   + **압축 유형** - **GZIP**, **ZSTD** 또는 **없음을** 선택합니다.
   + **스토리지 클래스** - 선택적으로 Amazon S3 스토리지 클래스를 선택합니다.
   + **출력 키 템플릿** - 선택적으로 Amazon S3 객체 키 구조를 정의합니다. 자세한 내용은 [Amazon S3 전송을 위한 S3 출력 키 템플릿 Amazon S3](data-delivery-s3-key-template.md)을 참조하세요.
   + **데이터 신선도** - 레코드가 전송되기 전 초 단위의 최대 버퍼링 시간입니다(최소 300, 최대 900).

   **다음**을 선택합니다.

1. **3단계: 추가 구성.** 암호화, 서비스 액세스(IAM 역할), 선택적 배달 못한 편지 대기열, 로그 전송 및 태그를 구성합니다. **다음**을 선택합니다.

1. **4단계: 검토 및 생성.** 구성을 검토한 다음 **전송 생성을** 선택합니다. 프로비저닝이 완료된 후 전송이 CREATING에서 ACTIVE로 전환됩니다.

## 사용 AWS CLI
<a name="data-delivery-s3-create-cli"></a>

 `create-channel` 명령을 사용하여 JSON 형식 및 GZIP 압축을 사용하여 레코드를 범용 Amazon S3 버킷으로 전송하는 Amazon S3 전송을 생성합니다.

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

 명령은 채널 ARN()을 반환합니다`ChannelARN`. 와 함께 사용하여 전송이 ACTIVE 상태에 도달하는지 `describe-channel` 확인합니다. [Amazon S3 전송 설명](data-delivery-s3-describe.md)을(를) 참조하세요. Amazon S3 객체 키 구조를 사용자 지정하려면 섹션을 참조하세요[Amazon S3 전송을 위한 S3 출력 키 템플릿 Amazon S3](data-delivery-s3-key-template.md).

 **API 참조** - *Amazon Kinesis Data Streams API 참조*`CreateChannel`의 섹션을 참조하세요.