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

# AWS-이오트키네시스파이어호스-3
<a name="aws-iot-kinesisfirehose-s3"></a>

![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/experimental.png)


 모든 클래스는 활발히 개발 중이며 향후 버전에서 이전 버전과 호환되지 않는 변경 또는 제거 될 수 있습니다. 이들은 적용되지 않습니다[의미 체계 버전 관리](https://semver.org/)모델. 즉, 이 패키지를 사용할 수도 있지만 이 패키지의 최신 버전으로 업그레이드할 때 소스 코드를 업데이트해야 할 수도 있습니다.

**참고:** 적절한 기능을 보장하려면 프로젝트의 AWS 솔루션 구성 패키지와 AWS CDK 패키지가 동일한 버전이어야 합니다.


|  **언어**  |  **패키지**  | 
| --- | --- | 
|  ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/python.png) Python  |  aws\_solutions\_constructs.aws\_iot\_kinesisfirehose\_s3  | 
|  ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/typescript.png) 타이프 스크립트  |  @aws-solutions-constructs/aws-iot-kinesisfirehose-s3  | 
|  ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.iotkinesisfirehoses3  | 

## Overview
<a name="overview-11"></a>

 이 AWS 솔루션 구성체는 AWS IoT MQTT 주제 규칙을 구현하여 Amazon S3 버킷에 연결된 Amazon Kinesis Data Firehose 전송 스트림에 데이터를 전송합니다.

 다음은 TypeScript 터의 최소 배포 가능한 패턴 정의입니다.

```
import { IotToKinesisFirehoseToS3Props, IotToKinesisFirehoseToS3 } from '@aws-solutions-constructs/aws-iot-kinesisfirehose-s3';

const props: IotToKinesisFirehoseToS3Props = {
    iotTopicRuleProps: {
        topicRulePayload: {
            ruleDisabled: false,
            description: "Persistent storage of connected vehicle telematics data",
            sql: "SELECT * FROM 'connectedcar/telemetry/#'",
            actions: []
        }
    }
};

new IotToKinesisFirehoseToS3(this, 'test-iot-firehose-s3', props);
```

## Initializer
<a name="initializer-11"></a>

```
new IotToKinesisFirehoseToS3(scope: Construct, id: string, props: IotToKinesisFirehoseToS3Props);
```

 *파라미터* 
+  scope[https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html) 
+  id`string` 
+  props[`IotToKinesisFirehoseToS3Props`](#pattern-construct-props-11) 

## 패턴 구성
<a name="pattern-construct-props-11"></a>


|  **이름**  |  **유형**  |  **설명**  | 
| --- | --- | --- | 
|  이오토피크루프롭스  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iot.CfnTopicRuleProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iot.CfnTopicRuleProps.html)  |  사용자가 기본값을 재정의하기 위해 CFNTopyCruleProps를 제공했습니다. | 
|  키네시스파이어호스프로프스? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kinesisfirehose.CfnDeliveryStreamProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kinesisfirehose.CfnDeliveryStreamProps.html)  |  Kinesis 파이어호스 배달 스트림의 기본 소품을 무시하기 위한 선택적 사용자 제공 소품  | 
|  버켓토비 기존에? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html)  |  S3 버킷 객체의 기존 인스턴스로,bucketProps오류가 발생합니다. | 
|  버킷 소품? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.BucketProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.BucketProps.html)  |  사용자가 S3 버킷의 기본 소품을 재정의하는 소품을 제공했습니다. 이것이 제공되는 경우bucketProps는 오류입니다. | 
|  로그그룹Props? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroupProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroupProps.html)  |  선택적 사용자 제공 소품을 사용하여 CloudWatch Logs 로그 그룹의 기본 소품을 재정의합니다. | 

## 패턴 속성
<a name="pattern-properties-11"></a>


|  **이름**  |  **유형**  |  **설명**  | 
| --- | --- | --- | 
|  IOT액션역할  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html)  |  IoT 규칙의 패턴에 의해 생성된 IAM 역할의 인스턴스를 반환합니다. | 
|  아이오토항목 규칙  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iot.CfnTopicRule.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iot.CfnTopicRule.html)  |  패턴에 의해 생성된 IoT 주제 규칙의 인스턴스를 반환합니다. | 
|  키네시스파이어호스  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kinesisfirehose.CfnDeliveryStream.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kinesisfirehose.CfnDeliveryStream.html)  |  패턴에 의해 생성된 Kinesis 파이어호스 전달 스트림의 인스턴스를 반환합니다. | 
|  키네시스파이어호스셀로그그룹  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroup.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroup.html)  |  Kinesis Firehose 액세스 로그가 전송되는 패턴으로 생성된 로그 그룹의 인스턴스를 반환합니다. | 
|  키네시스파이어호스롤  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html)  |  Kinesis Firehose 전송 스트림의 패턴에 의해 생성된 IAM 역할의 인스턴스를 반환합니다. | 
|  S3Bucket? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html)  |  패턴에 의해 생성된 S3 버킷의 인스턴스를 반환합니다. | 
|  s3로깅 버킷? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html)  |  S3 버킷의 패턴으로 생성된 로깅 버킷의 인스턴스를 반환합니다. | 

## 기본 설정
<a name="default-settings-11"></a>

 재정의없이이 패턴을 즉시 구현하면 다음과 같은 기본값이 설정됩니다.

### Amazon IoT 규칙
<a name="amazon-iot-rule"></a>
+  Amazon IoT 에 대한 최소 권한 액세스 IAM 역할 구성 

### Amazon Kinesis Firehose
<a name="amazon-kinesis-firehose"></a>
+  Kinesis 파이어호스에 대한 CloudWatch 로깅 활성화 
+  Amazon Kinesis Firehose 대한 최소 권한 액세스 IAM 역할 구성 

### Amazon S3 버킷
<a name="amazon-s3-bucket-1"></a>
+  S3 버킷에 대한 액세스 로깅 구성 
+  AWS 관리형 KMS 키를 사용하여 S3 버킷에 대한 서버 측 암호화 활성화 
+  S3 버킷에 대한 버전 관리 켜기 
+  S3 버킷에 대한 공용 액세스 허용 안 함 
+  CloudFormation 스택을 삭제할 때 S3 버킷 유지 
+  90일 후에 비최신 객체 버전을 Glacier 스토리지로 이동하는 수명 주기 규칙을 적용합니다.

## Architecture
<a name="architecture-11"></a>

![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/aws-iot-kinesisfirehose-s3.png)


## GitHub
<a name="github-11"></a>


<table>
<thead>
  <tr><th colspan="2"> 이 패턴의 코드를 보려면 문제 및 끌어오기 요청을 작성/조회하는 등의 작업을 수행합니다. </th></tr>
</thead>
<tbody>
  <tr><td> ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/GitHub-Mark-32px.png) </td><td> [@aws -솔루션 - 구성/AWS-Iot-키네시스파이어호스-s3](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-iot-kinesisfirehose-s3) </td></tr>
</tbody>
</table>