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

# PutFunctionEventInvokeConfig
<a name="API_PutFunctionEventInvokeConfig"></a>

Konfigurasi opsi untuk [invokasi asinkron](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html) 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](API_UpdateFunctionEventInvokeConfig.md).

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](API_UpdateFunctionConfiguration.md).

Untuk mengirim catatan invokasi ke antrean, topik, fungsi, atau bus peristiwa, tentukan [tujuan](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations). 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
<a name="API_PutFunctionEventInvokeConfig_RequestSyntax"></a>

```
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
<a name="API_PutFunctionEventInvokeConfig_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [FunctionName](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-FunctionName"></a>
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](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-Qualifier"></a>
Nomor versi atau nama alias.  
Panjang Batasan: Panjang minimum 1. Panjang maksimum 128.  
Pola: `(|[a-zA-Z0-9$_-]+)` 

## Isi Permintaan
<a name="API_PutFunctionEventInvokeConfig_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-DestinationConfig"></a>
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](API_DestinationConfig.md)  
Diperlukan: Tidak

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumEventAgeInSeconds"></a>
Masa maksimum permintaan yang dikirimkan Lambda ke fungsi untuk diproses.  
Tipe: Integer  
Rentang yang Valid: Nilai minimum 60. Nilai maksimum 21600.  
Diperlukan: Tidak

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_RequestSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-request-MaximumRetryAttempts"></a>
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
<a name="API_PutFunctionEventInvokeConfig_ResponseSyntax"></a>

```
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
<a name="API_PutFunctionEventInvokeConfig_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [DestinationConfig](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-DestinationConfig"></a>
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](API_DestinationConfig.md)

 ** [FunctionArn](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-FunctionArn"></a>
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](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-LastModified"></a>
Tanggal dan waktu konfigurasi terakhir diperbarui, dalam detik waktu Unix.  
Tipe: Timestamp

 ** [MaximumEventAgeInSeconds](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumEventAgeInSeconds"></a>
Masa maksimum permintaan yang dikirimkan Lambda ke fungsi untuk diproses.  
Tipe: Integer  
Rentang yang Valid: Nilai minimum 60. Nilai maksimum 21600.

 ** [MaximumRetryAttempts](#API_PutFunctionEventInvokeConfig_ResponseSyntax) **   <a name="lambda-PutFunctionEventInvokeConfig-response-MaximumRetryAttempts"></a>
Jumlah waktu maksimum untuk mencoba kembali saat fungsi mengembalikan kesalahan.  
Tipe: Integer  
Rentang yang Valid: Nilai minimum 0. Nilai maksimum 2.

## Kesalahan
<a name="API_PutFunctionEventInvokeConfig_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** 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](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Kode Status HTTP: 429

## Lihat Juga
<a name="API_PutFunctionEventInvokeConfig_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/PutFunctionEventInvokeConfig). 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWSSDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/PutFunctionEventInvokeConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/PutFunctionEventInvokeConfig)