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

# aws-sqs-람다
<a name="aws-sqs-lambda"></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\_sqs\_lambda  | 
|  ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/typescript.png) 타이프 스크립트  |  @aws-solutions-constructs/aws-sqs-lambda  | 
|  ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.sqslambda  | 

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

 이 AWS 솔루션 구성체는 AWS Lambda 함수에 연결된 Amazon SQS 대기열을 구현합니다.

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

```
const { SqsToLambda } = require('@aws-solutions-constructs/aws-sqs-lambda');

new SqsToLambda(stack, 'SqsToLambdaPattern', {
    lambdaFunctionProps: {
        runtime: lambda.Runtime.NODEJS_14_X,
        // This assumes a handler function in lib/lambda/index.js
        code: lambda.Code.fromAsset(`${__dirname}/lambda`),
        handler: 'index.handler'
    }
});
```

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

```
new SqsToLambda(scope: Construct, id: string, props: SqsToLambdaProps);
```

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

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


|  **이름**  |  **유형**  |  **설명**  | 
| --- | --- | --- | 
|  람다오브즈 기존인가요? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  Lambda 함수 객체의 기존 인스턴스, 이 및lambdaFunctionProps를 초과하면 오류가 발생합니다. | 
|  람다기능소품? |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html)  |  Lambda 함수의 기본 속성을 재정의하는 선택적 사용자 제공 속성입니다. 이 인 경우에는 무시됩니다.existingLambdaObj이 제공될 예정입니다. | 
|  대기열에 있는 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입니다. | 

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


|  **이름**  |  **유형**  |  **설명**  | 
| --- | --- | --- | 
|  데드 레터 큐? |  [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)  |  패턴에 의해 생성 된 데드 레터 큐의 인스턴스를 돌려줍니다 (배포 된 경우). | 
|  람다함수  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  패턴에 의해 생성 된 Lambda 함수의 인스턴스를 돌려줍니다. | 
|  분류: 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 대기열의 인스턴스를 반환합니다. | 

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

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

### Amazon SQS 대기열
<a name="amazon-sqs-queue-1"></a>
+  소스 SQS 대기열에 대한 SQS 배달 못한 편지 대기열을 배포합니다.
+  AWS 관리형 KMS 키를 사용하여 소스 SQS 대기열로 서버 측 암호화를 활성화합니다.
+  전송 중인 데이터의 암호화를 강제 시행.

### AWS Lambda 함수
<a name="aws-lambda-function-15"></a>
+  Lambda 함수에 대한 제한된 권한 액세스 IAM 역할을 구성합니다.
+  NodeJS Lambda 함수에 대한 연결 유지와 연결을 재사용 할 수 있습니다.
+  X-Ray 추적을 활성화합니다.
+  환경 변수를 설정합니다.
  +  `AWS_NODEJS_CONNECTION_REUSE_ENABLED`(노드 10.x 이상 함수의 경우)

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

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


## GitHub
<a name="github-24"></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-sqs-람다](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-sqs-lambda) </td></tr>
</tbody>
</table>