기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # AWS-이벤트-규칙-sqs ![](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\_events\_rule\_sqs | | ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/typescript.png) 타이프 스크립트 | @aws-solutions-constructs/aws-events-rule-sqs | | ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/java.png) Java | software.amazon.awsconstructs.services.eventsrulesqs | ## Overview 이 패턴은 Amazon SQS 대기열에 연결된 Amazon CloudWatch Events 규칙을 구현합니다. 다음은 최소한의 배포 가능한 패턴 정의입니다. ``` import { Duration } from '@aws-cdk/core'; import * as events from '@aws-cdk/aws-events'; import * as iam from '@aws-cdk/aws-iam'; import { EventsRuleToSqsProps, EventsRuleToSqs } from "@aws-solutions-constructs/aws-events-rule-sqs"; const props: EventsRuleToSqsProps = { eventRuleProps: { schedule: events.Schedule.rate(Duration.minutes(5)) } }; const constructStack = new EventsRuleToSqs(this, 'test-construct', props); // 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: [ "*" ] }); constructStack.encryptionKey?.addToResourcePolicy(policyStatement); ``` ## Initializer ``` new EventsRuleToSqs(scope: Construct, id: string, props: EventsRuleToSqsProps); ``` *파라미터* + 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[`EventsRuleToSqsProps`](#pattern-construct-props-31) ## 패턴 구성 | **이름** | **유형** | **설명** | | --- | --- | --- | | 이벤트루프로프 | [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-events.RuleProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-events.RuleProps.html) | CloudWatch 이벤트 규칙의 기본 속성을 재정의하는 사용자 제공 속성입니다. | | 대기열에 있는 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 | SQS 대기열을 비울 수 있도록 Lambda 함수에 추가 권한을 부여할지 여부 기본값은 false입니다. | | 배포데드 레터 큐? | boolean | 배달 못한 편지 대기열로 사용되는 보조 대기열을 생성할지 여부를 지정합니다. 기본값은 true입니다. | | 데드레터 큐프로프? | [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) | 암호화 키의 기본 속성을 재정의하는 선택적 사용자 제공 속성입니다. | ## 패턴 속성 | **이름** | **유형** | **설명** | | --- | --- | --- | | 이벤트 규칙 | [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-events.Rule.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-events.Rule.html) | 패턴에 의해 생성된 Events 규칙의 인스턴스를 반환합니다. | | 분류: 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 대기열의 인스턴스를 반환합니다. | | 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-sqs.Queue.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html) | 패턴에 의해 생성 된 데드 레터 큐의 인스턴스를 돌려줍니다 (배포 된 경우). | ## 기본 설정 재정의없이이 패턴을 즉시 구현하면 다음과 같은 기본값이 설정됩니다. ### Amazon CloudWatch Events + CloudWatch 이벤트에 최소 권한을 부여하여 SQS 대기열에 게시할 수 있습니다. ### Amazon SQS 대기열 + 소스 대기열에 대한 배달 못한 편지 대기열을 배포합니다. + 고객 관리형 AWS KMS 키를 사용하여 소스 대기열에 대한 서버 측 암호화를 활성화합니다. + 전송 중인 데이터의 암호화를 강제 시행. ## Architecture ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/aws-events-rule-sqs.png) ## GitHub
이 패턴의 코드를 보려면 문제 및 끌어오기 요청을 작성/조회하는 등의 작업을 수행합니다.
![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/GitHub-Mark-32px.png) [@aws -솔루션 - 구성/AWS - 이벤트 - 규칙 - sqs](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-events-rule-sqs)