Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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
propertiAWS::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
propertiAWS::Lambda::EventSourceMapping
sumber daya. -
DynamicPolicyName
-
Secara default, nama kebijakan AWS Identity and Access Management (IAM) adalah
SamAutoGeneratedAMQPolicy
untuk kompatibilitas mundur. Tentukantrue
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
-
Jika
true
, pemetaan sumber peristiwa aktif. Untuk menjeda polling dan pemanggilan, atur kefalse
.Tipe: Boolean
Wajib: Tidak
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
Enabled
propertiAWS::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
propertiAWS::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
propertiAWS::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
propertiAWS::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
propertiAWS::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 adalahBASIC_AUTH
danVIRTUAL_HOST
.-
BASIC_AUTH
Rahasia 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 tipeBASIC_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 tipeVIRTUAL_HOST
diizinkan.
Tipe: Daftar
Wajib: Ya
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
SourceAccessConfigurations
propertiAWS::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