DocumentDB - AWS Serverless Application Model
SintaksPropertiContoh

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 properti AWS::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 properti AWS::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 tipe AWS::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 tipe AWS::Lambda::EventSourceMapping DocumentDBEventSourceConfig data.

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 acara Lambda di Panduan Pengembang.AWS Lambda

Jenis: FilterCriteria

Wajib: Tidak

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

FullDocument

Menentukan apa yang Amazon DocumentDB kirimkan ke aliran acara Anda selama operasi pembaruan dokumen. Jika disetel keUpdateLookup, 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 tipe AWS::Lambda::EventSourceMapping DocumentDBEventSourceConfig data.

KmsKeyArn

Nama Sumber Daya Amazon (ARN) dari kunci untuk mengenkripsi informasi yang terkait dengan acara 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.

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 UUID. 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_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.

Tipe: Daftar

Wajib: Ya

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke SourceAccessConfigurations properti AWS::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 properti AWS::Lambda::EventSourceMapping sumber daya.

StartingPositionTimestamp

Waktu untuk mulai membaca, dalam detik waktu Unix. Tentukan StartingPositionTimestamp kapan StartingPosition ditentukan sebagaiAT_TIMESTAMP.

Tipe: Ganda

Wajib: Tidak

AWS CloudFormation kompatibilitas: Properti ini diteruskan langsung ke StartingPositionTimestamp properti AWS::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"