

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

# Aturan pendengar untuk layanan VPC Lattice
<a name="listener-rules"></a>

Setiap pendengar memiliki aturan default dan aturan tambahan yang dapat Anda tentukan. Setiap aturan terdiri dari prioritas, satu atau beberapa tindakan, dan satu atau beberapa syarat. Anda dapat menambahkan atau mengedit peraturan kapan saja.

**Topics**
+ [Peraturan default](#listener-default-rule)
+ [Prioritas peraturan](#listener-rule-priority)
+ [Tindakan aturan](#listener-rule-actions)
+ [Syarat peraturan](#listener-rule-conditions)
+ [Tambahkan peraturan](#add-rules)
+ [Perbarui aturan](#update-rules)
+ [Menghapus peraturan](#delete-rules)

## Peraturan default
<a name="listener-default-rule"></a>

Bila Anda membuat listener, Anda menentukan tindakan untuk peraturan default. Peraturan default tidak dapat memiliki syarat. Jika tidak ada syarat untuk peraturan listener yang terpenuhi, maka tindakan untuk peraturan default akan dilakukan.

## Prioritas peraturan
<a name="listener-rule-priority"></a>

Setiap peraturan memiliki prioritas. Peraturan dievaluasi dalam urutan prioritas, dari nilai terendah ke nilai tertinggi. Peraturan default dievaluasi terakhir. Anda dapat mengubah prioritas aturan non-default kapan saja. Anda tidak dapat mengubah prioritas peraturan default. 

## Tindakan aturan
<a name="listener-rule-actions"></a>

Pendengar untuk layanan VPC Lattice mendukung tindakan maju dan tindakan respons tetap.

### Tindakan ke depan
<a name="forward-actions"></a>

Anda dapat menggunakan `forward` tindakan untuk merutekan permintaan ke satu atau beberapa grup target VPC Lattice. Jika Anda menentukan beberapa kelompok target untuk tindakan `forward`, Anda harus menentukan bobot untuk setiap grup target. Bobot setiap grup target adalah nilai dari 0 hingga 999. Permintaan yang sesuai dengan peraturan listener dengan kelompok target tertimbang didistribusikan ke grup target ini berdasarkan bobot mereka. Misalnya, jika Anda menentukan dua grup target, masing-masing dengan bobot 10, setiap grup target menerima setengah dari permintaan. Jika Anda menentukan dua grup target, satu dengan bobot 10 dan lainnya dengan bobot 20, grup target dengan bobot 20 menerima permintaan dua kali lebih banyak dari grup target lainnya.

### Tindakan respons tetap
<a name="fixed-response-actions"></a>

Anda dapat menggunakan `fixed-response` untuk menjatuhkan permintaan klien dan mengembalikan respons HTTP khusus. Anda dapat menggunakan tindakan ini untuk mengembalikan kode respons 404 atau 500.

**Example Contoh tindakan respons tetap untuk AWS CLI**  
Anda dapat menentukan tindakan saat membuat atau memperbarui aturan. Tindakan berikut mengirimkan respons tetap dengan kode status yang ditentukan.  

```
"action": { 
    "fixedResponse": { 
        "statusCode": 404
},
```

## Syarat peraturan
<a name="listener-rule-conditions"></a>

Setiap syarat peraturan memiliki jenis dan konfigurasi informasi. Bila syarat untuk suatu peraturan terpenuhi, maka tindakannya dilakukan.

Berikut ini adalah kriteria pencocokan yang didukung untuk aturan:

**Pertandingan header**  
Routing didasarkan pada header HTTP untuk setiap permintaan. Anda dapat menggunakan syarat header HTTP untuk mengonfigurasi aturan yang merutekan permintaan berdasarkan header HTTP untuk permintaan tersebut. Anda dapat menentukan nama-nama bidang header HTTP standar atau kustom. Nama header dan evaluasi kecocokan tidak peka huruf besar/kecil. Anda dapat mengubah pengaturan ini dengan mengaktifkan sensitivitas huruf besar/kecil. Karakter wildcard tidak didukung dalam nama header. Awalan, tepat, dan berisi pencocokan didukung pada pencocokan header.

**Metode pencocokan**  
Routing didasarkan pada metode permintaan HTTP dari setiap permintaan.   
Anda dapat menggunakan syarat metode permintaan HTTP untuk mengonfigurasi aturan yang merutekan permintaan berdasarkan metode permintaan HTTP dari permintaan tersebut. Anda dapat menentukan metode HTTP standar atau kustom. Metode pencocokan peka huruf besar/kecil. Nama metode harus sama persis. Karakter wildcard tidak didukung. 

**Pertandingan jalur**  
Routing didasarkan pada pencocokan pola jalur dalam permintaan URLs.   
Anda dapat menggunakan kondisi jalur untuk menentukan aturan yang merutekan permintaan berdasarkan URL dalam permintaan. Karakter wildcard tidak didukung. Awalan dan pencocokan tepat di jalur didukung.

## Tambahkan peraturan
<a name="add-rules"></a>

Anda dapat menambahkan aturan pendengar kapan saja.

**Untuk menambahkan aturan listener menggunakan konsol**

1. Buka konsol Amazon VPC di. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)

1. **Di panel navigasi, di bawah **VPC** Lattice, pilih Layanan.**

1. Pilih nama layanan untuk membuka halaman detailnya.

1. Pada tab **Routing**, pilih **Edit listener**.

1. Perluas **aturan Listener** dan pilih **Tambahkan aturan**.

1. Untuk **nama Aturan**, masukkan nama untuk aturan.

1. Untuk **Prioritas**, masukkan prioritas antara 1 dan 100. Peraturan dievaluasi dalam urutan prioritas, dari nilai terendah ke nilai tertinggi. Peraturan default dievaluasi terakhir.

1. Untuk **Kondisi**, masukkan pola jalur untuk kondisi pencocokan jalur. Ukuran maksimum setiap string adalah 200 karakter. Perbandingannya tidak peka huruf besar/kecil. Karakter wildcard tidak didukung.

   Untuk menambahkan kondisi aturan kecocokan header atau kecocokan metode, gunakan AWS CLI atau AWS SDK.

1. Untuk **Tindakan**, pilih grup target VPC Lattice.

1. Pilih **Simpan perubahan**.

**Untuk menambahkan aturan menggunakan AWS CLI**  
Gunakan perintah [create-rule](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/create-rule.html).

## Perbarui aturan
<a name="update-rules"></a>

Anda dapat memperbarui aturan pendengar kapan saja. Anda dapat memodifikasi prioritas, kondisi, kelompok target, dan bobot masing-masing kelompok target. Anda tidak dapat mengubah nama aturan.

**Untuk memperbarui aturan listener menggunakan konsol**

1. Buka konsol Amazon VPC di. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)

1. **Di panel navigasi, di bawah **VPC** Lattice, pilih Layanan.**

1. Pilih nama layanan untuk membuka halaman detailnya.

1. Pada tab **Routing**, pilih **Edit listener**.

1. Ubah prioritas aturan, kondisi, dan tindakan sesuai kebutuhan.

1. Tinjau pembaruan Anda dan pilih **Simpan perubahan**.

**Untuk memperbarui aturan menggunakan AWS CLI**  
Gunakan perintah [update-rule](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/update-rule.html).

## Menghapus peraturan
<a name="delete-rules"></a>

Anda dapat menghapus aturan non-default untuk pendengar kapan saja. Anda tidak dapat menghapus peraturan default untuk listener. Saat Anda menghapus pendengar, semua aturannya akan dihapus.

**Untuk menghapus aturan listener menggunakan konsol**

1. Buka konsol Amazon VPC di. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)

1. **Di panel navigasi, di bawah **VPC** Lattice, pilih Layanan.**

1. Pilih nama layanan untuk membuka halaman detailnya.

1. Pada tab **Routing**, pilih **Edit listener**.

1. Temukan aturannya dan pilih **Hapus**.

1. Pilih **Simpan perubahan**.

**Untuk menghapus aturan menggunakan AWS CLI**  
Gunakan perintah [hapus-peraturan](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/delete-rule.html).