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

# AWS-SNS-스퀘어
<a name="aws-sns-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\$1sns\$1sqs  | 
|  ![\[alt text not found\]](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/typescript.png) 타이프 스크립트  |  @aws-solutions-constructs/aws-sns-sqs  | 
|  ![\[alt text not found\]](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.snssqs  | 

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

 Amazon SQS 대기열에 연결된 Amazon SNS 주제를 구현하는 AWS 솔루션 구성입니다.

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

```
import { SnsToSqs, SnsToSqsProps } from "@aws-solutions-constructs/aws-sns-sqs";
import * as iam from '@aws-cdk/aws-iam';

const snsToSqsStack = new SnsToSqs(this, 'SnsToSqsPattern', {});

// Grant yourself permissions to use the Customer Managed KMS Key
const policyStatement = new iam.PolicyStatement({
    actions: ["kms:Encrypt", "kms:Decrypt"],
    effect: iam.Effect.ALLOW,
    principals: [ new iam.AccountRootPrincipal() ],
    resources: [ "*" ]
});

snsToSqsStack.encryptionKey?.addToResourcePolicy(policyStatement);
```

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

```
new SnsToSqs(scope: Construct, id: string, props: SnsToSqsProps);
```

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

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


|  **이름**  |  **유형**  |  **설명**  | 
| --- | --- | --- | 
|  기존토픽코비? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html)  |  SNS Topic 객체의 기존 인스턴스로,topicProps오류가 발생합니다. | 
|  주제소품? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.TopicProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.TopicProps.html)  |  SNS 주제에 대한 기본 속성을 재정의하는 선택적 사용자 제공 속성입니다. 이 인 경우에는 무시됩니다.existingTopicObj제공될 예정입니다. | 
|  대기열에 있는 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오류가 발생합니다. | 
|  대기열 소품? |  [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제공될 예정입니다. | 
|  배포데드 레터 큐? |  boolean  |  배달 못한 편지 대기열로 사용할 보조 대기열을 생성할지 여부를 지정합니다. 기본값은 true입니다. | 
|  데드레터 대기열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로 설정됩니다. | 
|  maxReceiveCount? |  number  |  배달 못한 편지 대기열로 이동되기 전에 메시지가 대기열에서 빼지 못할 수 있는 횟수입니다. 기본값은 15입니다. | 
|  고객 관리 키를 사용하여 암호화를 활성화하시겠습니까? |  boolean  |  이 CDK 앱에서 관리하거나 가져온 고객 관리 암호화 키를 사용할지 여부 암호화 키를 가져오는 경우 암호화 키를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-28"></a>


|  **이름**  |  **유형**  |  **설명**  | 
| --- | --- | --- | 
|  snsTopic  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html)  |  패턴에 의해 생성된 SNS 주제의 인스턴스를 반환합니다. | 
|  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)  |  패턴에 의해 생성 된 암호화 키의 인스턴스를 돌려줍니다. | 
|  분류: 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)  |  패턴에 의해 생성 된 데드 레터 큐의 인스턴스를 돌려줍니다 (배포 된 경우). | 

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

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

### Amazon SNS 주제
<a name="amazon-sns-topic-28"></a>
+  SNS 주제에 대한 최소 권한 액세스 권한을 구성합니다.
+  AWS 관리형 KMS 키를 사용하여 서버 측 암호화를 활성화합니다.
+  전송 중인 데이터의 암호화를 강제 시행 

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

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

![\[AWS 서비스 diagram showing SNS, SQS, and Lambda interactions with queues and notifications.\]](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/aws-sns-sqs.png)


## GitHub
<a name="github-28"></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 - SNS - 스퀘어](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-sns-sqs)  |