Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
DocumentDB
Objek yang menggambarkan tipe sumber peristiwa DocumentDB
. Untuk informasi selengkapnya, lihat Menggunakan AWS Lambda Amazon DocumentDB di AWS Lambda Panduan Pengembang.
Sintaks
Untuk mendeklarasikan entitas ini di AWS SAM template Anda, gunakan sintaks berikut.
YAML
BatchSize:
Integer
Cluster:String
CollectionName:String
DatabaseName:String
Enabled:Boolean
FilterCriteria:FilterCriteria
FullDocument:String
KmsKeyArn:String
MaximumBatchingWindowInSeconds:Integer
SecretsManagerKmsKeyId:String
SourceAccessConfigurations:List
StartingPosition:String
StartingPositionTimestamp:Double
Properti
-
BatchSize
-
Jumlah maksimum item yang akan diambil dalam satu batch.
Tipe: Integer
Wajib: Tidak
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
BatchSize
propertiAWS::Lambda::EventSourceMapping
sumber daya. -
Cluster
-
Nama Sumber Daya Amazon (ARN) dari cluster Amazon DocumentDB.
Tipe: String
Wajib: Ya
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
EventSourceArn
propertiAWS::Lambda::EventSourceMapping
sumber daya. -
CollectionName
-
Nama koleksi untuk dikonsumsi dalam database. Jika Anda tidak menentukan koleksi, Lambda mengkonsumsi semua koleksi.
Tipe: String
Wajib: Tidak
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
CollectionName
properti tipeAWS::Lambda::EventSourceMapping
DocumentDBEventSourceConfig
data. -
DatabaseName
-
Nama database untuk dikonsumsi dalam cluster Amazon DocumentDB.
Tipe: String
Wajib: Ya
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
DatabaseName
properti tipeAWS::Lambda::EventSourceMapping
DocumentDBEventSourceConfig
data. -
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 acara Lambda di Panduan Pengembang.AWS Lambda
Jenis: FilterCriteria
Wajib: Tidak
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
FilterCriteria
propertiAWS::Lambda::EventSourceMapping
sumber daya. -
FullDocument
-
Menentukan apa yang Amazon DocumentDB kirimkan ke aliran acara Anda selama operasi pembaruan dokumen. Jika disetel ke
UpdateLookup
, Amazon DocumentDB mengirimkan delta yang menjelaskan perubahan, bersama dengan salinan seluruh dokumen. Jika tidak, Amazon DocumentDB hanya mengirimkan sebagian dokumen yang berisi perubahan.Tipe: String
Wajib: Tidak
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
FullDocument
properti tipeAWS::Lambda::EventSourceMapping
DocumentDBEventSourceConfig
data. -
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. -
SecretsManagerKmsKeyId
-
ID kunci AWS Key Management Service (AWS KMS) kunci kunci yang dikelola pelanggan dari AWS Secrets Manager. Diperlukan saat Anda menggunakan kunci terkelola 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 protokol otentikasi atau host virtual. Tentukan ini menggunakan tipe SourceAccessConfigurationsdata.
Untuk tipe sumber
DocumentDB
acara, satu-satunya jenis konfigurasi yang valid adalahBASIC_AUTH
.-
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.
Tipe: Daftar
Wajib: Ya
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
SourceAccessConfigurations
propertiAWS::Lambda::EventSourceMapping
sumber daya. -
-
StartingPosition
-
Posisi dalam pengaliran tempat untuk mulai membaca.
-
AT_TIMESTAMP
— Tentukan waktu untuk mulai membaca catatan. -
LATEST
— Baca hanya catatan baru. -
TRIM_HORIZON
— Memproses semua catatan yang tersedia.
Tipe: String
Wajib: Ya
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
StartingPosition
propertiAWS::Lambda::EventSourceMapping
sumber daya. -
-
StartingPositionTimestamp
-
Waktu untuk mulai membaca, dalam detik waktu Unix. Tentukan
StartingPositionTimestamp
kapanStartingPosition
ditentukan sebagaiAT_TIMESTAMP
.Tipe: Ganda
Wajib: Tidak
AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke
StartingPositionTimestamp
propertiAWS::Lambda::EventSourceMapping
sumber daya.
Contoh
Sumber acara Amazon DocumentDB
AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 ... Resources: MyFunction: Type: AWS::Serverless::Function Properties: ... Events: MyDDBEvent: Type: DocumentDB Properties: Cluster: "arn:aws:rds:us-west-2:123456789012:cluster:docdb-2023-01-01" BatchSize: 10 MaximumBatchingWindowInSeconds: 5 DatabaseName: "db1" CollectionName: "collection1" FullDocument: "UpdateLookup" SourceAccessConfigurations: - Type: BASIC_AUTH URI: "arn:aws:secretsmanager:us-west-2:123456789012:secret:doc-db"