AWS-이벤트-규칙-sqs - AWS 솔루션 구성체

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

AWS-이벤트-규칙-sqs

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

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

언어 패키지
Python
aws_solutions_constructs.aws_events_rule_sqs
타이프 스크립트
@aws-solutions-constructs/aws-events-rule-sqs
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);

파라미터

패턴 구성

이름 유형 설명
이벤트루프로프 events.RuleProps CloudWatch 이벤트 규칙의 기본 속성을 재정의하는 사용자 제공 속성입니다.
대기열에 있는 Obj? sqs.Queue 기본 대기열 대신 사용할 기존 SQS 대기열 (선택 사항) 이 두 가지를 모두 제공queueProps오류가 발생합니다.
대기열 소품? sqs.QueueProps SQS 대기열의 기본 속성을 재정의하는 선택적 사용자 제공 속성입니다. 이 인 경우에는 무시됩니다.existingQueueObj이 제공될 예정입니다.
대기열 제거 기능을 활성화하시겠습니까? boolean SQS 대기열을 비울 수 있도록 Lambda 함수에 추가 권한을 부여할지 여부 기본값은 false입니다.
배포데드 레터 큐? boolean 배달 못한 편지 대기열로 사용되는 보조 대기열을 생성할지 여부를 지정합니다. 기본값은 true입니다.
데드레터 큐프로프? sqs.QueueProps 데드 레터 큐의 기본 소품을 재정의하는 선택적 사용자가 제공 한 소품. 에만 사용됩니다.deployDeadLetterQueue속성이 true로 설정됩니다.
maxReceiveCount? number 배달 못한 편지 대기열로 이동되기 전에 메시지가 대기열에서 빼지 못한 횟수입니다. 기본값은 15입니다.
고객 관리 키를 사용하여 암호화를 활성화하시겠습니까? boolean 이 CDK 앱에서 관리하거나 가져온 고객 관리 암호화 키를 사용할지 여부 암호화 키를 가져오는 경우 암호화 키를encryptionKey이 구문에 대한 속성입니다.
encryptionKey kms.Key 기본 암호화 키 대신 사용할 선택적 기존 암호화 키입니다.
암호화 키 소품? kms.KeyProps 암호화 키의 기본 속성을 재정의하는 선택적 사용자 제공 속성입니다.

패턴 속성

이름 유형 설명
이벤트 규칙 events.Rule 패턴에 의해 생성된 Events 규칙의 인스턴스를 반환합니다.
분류: SQqueue sqs.Queue 패턴에 의해 생성된 SQS 대기열의 인스턴스를 반환합니다.
encryptionKey kms.Key 패턴에 의해 생성 된 암호화 키의 인스턴스를 돌려줍니다.
데드 레터 큐? sqs.Queue 패턴에 의해 생성 된 데드 레터 큐의 인스턴스를 돌려줍니다 (배포 된 경우).

기본 설정

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

Amazon CloudWatch Events

  • CloudWatch 이벤트에 최소 권한을 부여하여 SQS 대기열에 게시할 수 있습니다.

Amazon SQS 대기열

  • 소스 대기열에 대한 배달 못한 편지 대기열을 배포합니다.

  • 고객 관리형 AWS KMS 키를 사용하여 소스 대기열에 대한 서버 측 암호화를 활성화합니다.

  • 전송 중인 데이터의 암호화를 강제 시행.

Architecture

GitHub

이 패턴의 코드를 보려면 문제 및 끌어오기 요청을 작성/조회하는 등의 작업을 수행합니다.
@aws -솔루션 - 구성/AWS - 이벤트 - 규칙 - sqs