Mengirim permintaan ke layanan
BERLAKU UNTUK: Pengembang | Premi
Kebijakan set-backend-service
menetapkan URL target untuk permintaan saat ini ke http://localhost:3500/v1.0/invoke/{app-id}[.{ns-name}]/method/{method-name}
, mengganti parameter templat dengan nilai yang ditentukan dalam pernyataan kebijakan.
Kebijakan tersebut mengasumsikan bahwa Dapr berjalan dalam kontainer sidecar di pod yang sama dengan gateway. Setelah menerima permintaan, runtime Dapr melakukan penemuan layanan dan pemanggilan aktual, termasuk kemungkinan terjemahan protokol antara HTTP dan gRPC, upaya ulang, pelacakan terdistribusi, dan penanganan kesalahan. Pelajari selengkapnya tentang integrasi Dapr dengan API Management.
Catatan
Tetapkan elemen kebijakan dan elemen turunan dalam urutan yang disediakan dalam pernyataan kebijakan. Pelajari lebih lanjut cara mengatur atau mengedit kebijakan API Management.
Pernyataan kebijakan
<set-backend-service backend-id="dapr" dapr-app-id="app-id" dapr-method="method-name" dapr-namespace="ns-name" />
Atribut
Atribut | Deskripsi | Wajib diisi | Default |
---|---|---|---|
backend-id | Harus diatur ke "dapr". | Ya | T/A |
dapr-app-id | Nama layanan mikro target. Digunakan untuk membentuk parameter appId di Dapr. Ekspresi kebijakan diizinkan. | Ya | T/A |
dapr-method | Nama metode atau URL untuk dipanggil pada layanan mikro target. Memetakan ke parameter method-name di Dapr. Ekspresi kebijakan diizinkan. | Ya | T/A |
dapr-namespace | Nama namespace tempat layanan mikro target berada di dalamnya. Digunakan untuk membentuk parameter appId di Dapr. Ekspresi kebijakan diizinkan. | No | T/A |
Penggunaan
- Bagian kebijakan: masuk
- Cakupan kebijakan: global, produk, API, operasi
- Gateway: dihost sendiri
Catatan penggunaan
Dukungan Dapr harus diaktifkan di gateway yang dihost sendiri.
Contoh
Contoh berikut menunjukkan memanggil metode bernama "back" pada layanan mikro yang disebut "echo". Kebijakan set-backend-service
ini menetapkan URL tujuan ke http://localhost:3500/v1.0/invoke/echo.echo-app/method/back
. Kebijakan forward-request
mengirimkan permintaan ke runtime Dapr, yang mengirimkannya ke layanan mikro.
Kebijakan forward-request
ditunjukkan di sini untuk mendapatkan kejelasan. Kebijakan ini biasanya "diwariskan" dari lingkup global melalui kata kunci base
.
<policies>
<inbound>
<base />
<set-backend-service backend-id="dapr" dapr-app-id="echo" dapr-method="back" dapr-namespace="echo-app" />
</inbound>
<backend>
<forward-request />
</backend>
<outbound>
<base />
</outbound>
<on-error>
<base />
</on-error>
</policies>
Kebijakan terkait
Konten terkait
Untuk informasi selengkapnya tentang bekerja dengan kebijakan, lihat:
- Tutorial: Mengubah dan melindungi API Anda
- Referensi Kebijakan untuk daftar lengkap pernyataan kebijakan dan pengaturannya
- Ekspresi kebijakan
- Mengatur atau mengedit kebijakan
- Menggunakan kembali konfigurasi kebijakan
- Repositori cuplikan kebijakan
- Toolkit kebijakan Azure API Management
- Kebijakan penulis menggunakan Microsoft Copilot di Azure