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

# AWS-s3-sqs
<a name="aws-s3-sqs"></a>

![\[Two labels: "STABILITY" in gray and "EXPERIMENTAL" in orange.\]](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/experimental.png)


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

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


|  **언어**  |  **패키지**  | 
| --- | --- | 
|  ![\[alt text not found\]](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/python.png) Python  |  aws\$1solutions\$1constructs.aws\$1s3\$1sqs  | 
|  ![\[alt text not found\]](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/typescript.png) 타이프 스크립트  |  @aws-solutions-constructs/aws-s3-sqs  | 
|  ![\[alt text not found\]](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.s3sqs  | 

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

 이 AWS 솔루션 구조는 Amazon SQS 대기열에 알림을 보내도록 구성된 Amazon S3 버킷을 구현합니다.

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

```
import { S3ToSqs } from "@aws-solutions-constructs/aws-s3-sqs";

new S3ToSqs(stack, 'S3ToSQSPattern', {});
```

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

```
new S3ToSqs(scope: Construct, id: string, props: S3ToSqsProps);
```

 *파라미터* 
+  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[`S3ToSqsProps`](#pattern-construct-props-39) 

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


|  **이름**  |  **유형**  |  **설명**  | 
| --- | --- | --- | 
|  버켓토비 기존에? |  [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 버킷의 기본 소품을 재정의하는 선택적 사용자 제공 소품입니다. | 
|  S3이벤트 유형? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.EventType.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.EventType.html)  |  알림을 트리거할 S3 이벤트 유형입니다. 기본값은 s3.EventType.OBJECT\$1CREATED입니다. | 
|  S3이벤트 필터? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.NotificationKeyFilter.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.NotificationKeyFilter.html)  |  S3 객체 키 필터 규칙은 이 이벤트를 트리거하는 객체를 결정합니다. 지정하지 않으면 필터 규칙이 적용되지 않습니다. | 
|  대기열에 있는 OBJ? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html)  |  기본 대기열 대신 사용할 기존 SQS 대기열 (선택 사항) 이 두 가지를 모두 제공queueProps를 초과하면 오류가 발생합니다. SQS 대기열이 암호화되면 암호화에 사용되는 KMS 키는 고객이 관리하는 CMK여야 합니다. | 
|  대기열 소품? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html)  |  SQS 대기열의 기본 속성을 재정의하는 선택적 사용자 제공 속성입니다. 이 인 경우에는 무시됩니다.existingQueueObj이 제공될 예정입니다. | 
|  데드레터 대기열Props? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html)  |  데드 레터 큐의 기본 소품을 재정의하는 선택적 사용자가 제공 한 소품. 에만 사용됩니다.deployDeadLetterQueue속성이 true로 설정됩니다. | 
|  배포데드 레터 큐? |  boolean  |  배달 못한 편지 대기열로 사용될 보조 대기열을 생성할지 여부. 기본값은 true입니다. | 
|  maxReceiveCount? |  number  |  배달 못한 편지 대기열로 이동되기 전에 메시지가 대기열에서 빠질 수 있는 횟수입니다. 기본값은 15입니다. | 
|  고객 관리 키를 사용하여 암호화를 활성화하시겠습니까? |  boolean  |  이 CDK 앱에서 관리하거나 가져온 KMS 키를 사용할지 여부 암호화 키를 가져오는 경우 암호화 키를encryptionKey이 구문에 대한 속성입니다. | 
|  encryptionKey  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html)  |  기본 암호화 키 대신 사용할 선택적 기존 암호화 키입니다. | 
|  암호화 키 소품? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.KeyProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.KeyProps.html)  |  암호화 키의 기본 속성을 재정의하는 선택적 사용자 제공 속성입니다. | 

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


|  **이름**  |  **유형**  |  **설명**  | 
| --- | --- | --- | 
|  분류: SQqueue  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html)  |  패턴에 의해 생성된 SQS 대기열의 인스턴스를 반환합니다. | 
|  데드 레터 큐? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html)  |  패턴에 의해 생성 된 데드 레터 큐의 인스턴스를 돌려줍니다 (배포 된 경우). | 
|  encryptionKey  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html)  |  패턴에 의해 생성 된 암호화 키의 인스턴스를 돌려줍니다. | 
|  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-39"></a>

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

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

### Amazon SQS 대기열
<a name="aws-sqs-queue-39"></a>
+  SQS 대기열에 대한 최소 권한 액세스 권한 구성 
+  소스 SQS 대기열에 대한 SQS 배달 못한 편지 대기열 배포 
+  고객 관리 KMS 키를 사용하여 SQS 대기열을 위한 서버 측 암호화 활성화 
+  전송 중인 데이터의 암호화 강제 시행 

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

![\[Diagram showing Amazon Simple Notification Service connecting to Amazon Simple Queue Service and AWS Lambda.\]](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/aws-s3-sqs.png)


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


|  **이 패턴의 코드를 보려면 문제 및 끌어오기 요청을 작성/조회하는 등의 작업을 수행합니다.**  | 
| --- | 
|  ![\[Circular icon with a graduation cap symbol representing education or learning.\]](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/GitHub-Mark-32px.png)  |  [@aws -솔루션 - 구성/AWS-s3-sqs](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-s3-sqs)  |