MQ

Objek yang menggambarkan tipe sumber peristiwa MQ. Untuk informasi lebih lanjut, lihat Menggunakan Lambda dengan Amazon MQ dalam Panduan Developer AWS Lambda .

AWS Serverless Application Model (AWS SAM) menghasilkan AWS::Lambda::EventSourceMappingsumber daya saat jenis acara ini disetel.

catatan

Untuk memiliki antrian Amazon MQ di cloud pribadi virtual (VPC) yang terhubung ke fungsi Lambda di jaringan publik, peran eksekusi fungsi Anda harus menyertakan izin berikut:

• ec2:CreateNetworkInterface

• ec2:DeleteNetworkInterface

• ec2:DescribeNetworkInterfaces

• ec2:DescribeSecurityGroups

• ec2:DescribeSubnets

• ec2:DescribeVpcs

Untuk informasi selengkapnya, lihat Izin peran eksekusi di Panduan Developer AWS Lambda .

Sintaks

Untuk mendeklarasikan entitas ini di AWS SAM template Anda, gunakan sintaks berikut.

YAML

  BatchSize: Integer
  Broker: String
  DynamicPolicyName: Boolean
  Enabled: Boolean
  FilterCriteria: FilterCriteria
  KmsKeyArn: String 
  MaximumBatchingWindowInSeconds: Integer
  Queues: List
  SecretsManagerKmsKeyId: String
  SourceAccessConfigurations: List

Properti

BatchSize

Jumlah maksimum item yang akan diambil dalam satu batch.

Tipe: Integer

Wajib: Tidak

Default: 100

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke BatchSize properti AWS::Lambda::EventSourceMapping sumber daya.

Minimal: 1

Maksimum: 10000

Broker

Nama Sumber Daya Amazon (ARN) dari broker Amazon MQ.

Tipe: String

Wajib: Ya

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke EventSourceArn properti AWS::Lambda::EventSourceMapping sumber daya.

DynamicPolicyName

Secara default, nama kebijakan AWS Identity and Access Management (IAM) adalah SamAutoGeneratedAMQPolicy untuk kompatibilitas mundur. Tentukan true untuk menggunakan nama yang dibuat secara otomatis untuk IAM kebijakan Anda. Nama ini akan menyertakan ID logis sumber peristiwa Amazon MQ.

catatan

Saat menggunakan lebih dari satu sumber peristiwa Amazon MQ, tentukan true untuk menghindari duplikat IAM nama kebijakan.

Tipe: Boolean

Wajib: Tidak

Default: false

AWS CloudFormation kompatibilitas: Properti ini unik AWS SAM dan tidak memiliki AWS CloudFormation padanan.

Enabled

Jikatrue, pemetaan sumber peristiwa aktif. Untuk menjeda polling dan pemanggilan, atur ke false.

Tipe: Boolean

Wajib: Tidak

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke Enabled properti AWS::Lambda::EventSourceMapping sumber daya.

FilterCriteria

Objek yang mendefinisikan kriteria yang menentukan apakah Lambda harus memproses suatu peristiwa. Untuk informasi selengkapnya, lihat pemfilteran AWS Lambda acara di Panduan AWS Lambda Pengembang.

Jenis: FilterCriteria

Wajib: Tidak

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke FilterCriteria properti AWS::Lambda::EventSourceMapping sumber daya.

KmsKeyArn

Nama Sumber Daya Amazon (ARN) dari kunci untuk mengenkripsi informasi yang terkait dengan peristiwa ini.

Tipe: String

Wajib: Tidak

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke KmsKeyArn properti AWS::Lambda::EventSourceMapping sumber daya.

MaximumBatchingWindowInSeconds

Jumlah waktu maksimum untuk mengumpulkan rekaman sebelum memanggil fungsi, dalam hitungan detik.

Tipe: Integer

Wajib: Tidak

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke MaximumBatchingWindowInSeconds properti AWS::Lambda::EventSourceMapping sumber daya.

Queues

Nama antrean tujuan broker Amazon MQ yang akan digunakan.

Tipe: Daftar

Wajib: Ya

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke Queues properti AWS::Lambda::EventSourceMapping sumber daya.

SecretsManagerKmsKeyId

ID kunci AWS Key Management Service (AWS KMS) kunci kunci yang dikelola pelanggan dari AWS Secrets Manager. Diperlukan saat Anda menggunakan kunci yang dikelola pelanggan dari Secrets Manager dengan peran eksekusi Lambda yang tidak menyertakan izin. kms:Decrypt

Nilai properti ini adalah aUUID. Sebagai contoh: 1abc23d4-567f-8ab9-cde0-1fab234c5d67.

Tipe: String

Wajib: Bersyarat

AWS CloudFormation kompatibilitas: Properti ini unik AWS SAM dan tidak memiliki AWS CloudFormation padanan.

SourceAccessConfigurations

Array dari protokol autentikasi atau host vitual. Tentukan ini menggunakan tipe SourceAccessConfigurationsdata.

Untuk tipe sumber MQ acara, satu-satunya tipe konfigurasi yang valid adalah BASIC_AUTH danVIRTUAL_HOST.

• BASIC_AUTHRahasia Secrets Manager yang menyimpan kredensi broker Anda. Untuk tipe ini, kredensialnya harus dalam format berikut: {"username": "your-username", "password": "your-password"}. Hanya satu objek dari tipe BASIC_AUTH diizinkan.

• VIRTUAL_HOST— Nama host virtual di broker RabbitMQ Anda. Lambda akan menggunakan host Rabbit MQ ini sebagai sumber peristiwa. Hanya satu objek dari tipe VIRTUAL_HOST diizinkan.

Tipe: Daftar

Wajib: Ya

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke SourceAccessConfigurations properti AWS::Lambda::EventSourceMapping sumber daya.

Contoh

Sumber peristiwa Amazon MQ

Berikut ini adalah contoh tipe sumber peristiwa MQ untuk broker Amazon MQ.

YAML

Events:
  MQEvent:
    Type: MQ
    Properties:
      Broker: arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9
      Queues: List of queues
      SourceAccessConfigurations:
        - Type: BASIC_AUTH
          URI: arn:aws:secretsmanager:us-east-1:01234567890:secret:MyBrokerSecretName
      BatchSize: 200
      Enabled: true