PutFunctionEventInvokeConfig - AWS Lambda

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

PutFunctionEventInvokeConfig

Konfigurasi opsi untuk invokasi asinkron pada fungsi, versi, atau alias. Jika konfigurasi sudah ada untuk fungsi, versi, atau alias, operasi ini akan menimpa konfigurasi tersebut. Jika Anda mengecualikan pengaturan apa pun, pengaturan tersebut akan dihapus. Untuk mengatur satu opsi tanpa memengaruhi pengaturan yang ada untuk opsi lain, gunakan UpdateFunctionEventInvokeConfig.

Secara default, Lambda mencoba lagi invokasi asinkron dua kali jika fungsi mengembalikan kesalahan. Ini mempertahankan peristiwa dalam antrean hingga enam jam. Ketika peristiwa gagal dalam semua upaya pemrosesan atau berada dalam antrean invokasi asinkron terlalu lama, Lambda menghapusnya. Untuk mempertahankan peristiwa yang dihapus, konfigurasi antrean surat mati dengan UpdateFunctionConfiguration.

Untuk mengirim catatan invokasi ke antrean, topik, fungsi, atau bus peristiwa, tentukan tujuan. Anda dapat mengonfigurasi tujuan terpisah untuk invokasi yang berhasil (berhasil) dan peristiwa yang gagal diproses (gagal). Anda dapat mengonfigurasi tujuan selain atau sebagai ganti antrean surat mati.

Sintaks Permintaan

PUT /2019-09-25/functions/FunctionName/event-invoke-config?Qualifier=Qualifier HTTP/1.1 Content-type: application/json { "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "MaximumEventAgeInSeconds": number, "MaximumRetryAttempts": number }

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

FunctionName

Nama fungsi Lambda, versi, atau alias.

Format nama
  • Nama fungsi - my-function (hanya nama), my-function:v1 (dengan alias).

  • ARN Fungsi - arn:aws:lambda:us-west-2:123456789012:function:my-function.

  • ARN sebagian - 123456789012:function:my-function.

Anda dapat menambahkan nomor versi atau alias ke salah satu format. Batas panjang hanya berlaku untuk ARN penuh. Jika Anda hanya menentukan nama fungsi, panjang nama dibatasi hingga 64 karakter.

Panjang Batasan: Panjang minimum 1. Panjang maksimum 140.

Pola: (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

Diperlukan: Ya

Qualifier

Nomor versi atau nama alias.

Panjang Batasan: Panjang minimum 1. Panjang maksimum 128.

Pola: (|[a-zA-Z0-9$_-]+)

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

DestinationConfig

Tujuan untuk peristiwa setelah dikirim ke fungsi untuk diproses.

Tujuan
  • Fungsi- Amazon Resource Name (ARN) dari fungsi Lambda.

  • Antrian - ARN dari antrian SQS standar.

  • Topik - ARN dari topik SNS standar.

  • Event Bus - ARN dari bus EventBridge acara Amazon.

Tipe: Objek DestinationConfig

Diperlukan: Tidak

MaximumEventAgeInSeconds

Masa maksimum permintaan yang dikirimkan Lambda ke fungsi untuk diproses.

Tipe: Integer

Rentang yang Valid: Nilai minimum 60. Nilai maksimum 21600.

Diperlukan: Tidak

MaximumRetryAttempts

Jumlah waktu maksimum untuk mencoba kembali saat fungsi mengembalikan kesalahan.

Tipe: Integer

Rentang yang Valid: Nilai minimum 0. Nilai maksimum 2.

Wajib: Tidak

Sintaksis Respons

HTTP/1.1 200 Content-type: application/json { "DestinationConfig": { "OnFailure": { "Destination": "string" }, "OnSuccess": { "Destination": "string" } }, "FunctionArn": "string", "LastModified": number, "MaximumEventAgeInSeconds": number, "MaximumRetryAttempts": number }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

DestinationConfig

Tujuan untuk peristiwa setelah dikirim ke fungsi untuk diproses.

Tujuan
  • Fungsi- Amazon Resource Name (ARN) dari fungsi Lambda.

  • Antrian - ARN dari antrian SQS standar.

  • Topik - ARN dari topik SNS standar.

  • Event Bus - ARN dari bus EventBridge acara Amazon.

Tipe: Objek DestinationConfig

FunctionArn

Amazon Resource Name (ARN) fungsi.

Tipe: String

Pola: arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?

LastModified

Tanggal dan waktu konfigurasi terakhir diperbarui, dalam detik waktu Unix.

Tipe: Timestamp

MaximumEventAgeInSeconds

Masa maksimum permintaan yang dikirimkan Lambda ke fungsi untuk diproses.

Tipe: Integer

Rentang yang Valid: Nilai minimum 60. Nilai maksimum 21600.

MaximumRetryAttempts

Jumlah waktu maksimum untuk mencoba kembali saat fungsi mengembalikan kesalahan.

Tipe: Integer

Rentang yang Valid: Nilai minimum 0. Nilai maksimum 2.

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

InvalidParameterValueException

Salah satu parameter dalam permintaan tidak valid.

Kode Status HTTP: 400

ResourceConflictException

Sumber daya sudah ada, atau operasi lain sedang berlangsung.

Kode Status HTTP: 409

ResourceNotFoundException

Sumber daya yang ditentukan dalam permintaan tidak ada.

Kode Status HTTP: 404

ServiceException

Layanan AWS Lambda mengalami kesalahan internal.

Kode Status HTTP: 500

TooManyRequestsException

Batas throughput permintaan terlampaui. Untuk informasi lebih lanjut, lihat Kuota Lambda.

Kode Status HTTP: 429

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: