Bagikan melalui

Referensi kebijakan API Management

BERLAKU UNTUK: Semua tingkatAN API Management

Bagian ini menyediakan deskripsi singkat dan tautan ke artikel referensi untuk semua kebijakan API Management. Gateway API Management yang mendukung setiap kebijakan ditunjukkan. Untuk pengaturan dan contoh kebijakan terperinci, lihat artikel referensi tertaut.

Informasi lebih lanjut mengenai kebijakan:

Penting

Batasi tarif panggilan menurut langganan dan Atur kuota penggunaan menurut langganan memiliki dependensi pada kunci langganan. Kunci langganan tidak diperlukan saat kebijakan lain diterapkan.

Pembatasan tarif dan kuota

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Batasi tarif panggilan menurut langganan Mencegah lonjakan penggunaan API dengan membatasi tarif panggilan, per langganan. Ya Ya Ya Ya Ya
Batasi tarif panggilan menurut kunci Mencegah lonjakan penggunaan API dengan membatasi tarif panggilan, per basis kunci. Ya Ya Tidak Ya Ya
Mengatur kuota penggunaan menurut langganan Memungkinkan Anda menerapkan kuota volume panggilan dan/atau bandwidth terbarukan atau seumur hidup, per langganan. Ya Ya Ya Ya Ya
Atur kuota penggunaan menurut kunci Memungkinkan Anda memberlakukan kuota volume panggilan dan/atau bandwidth yang dapat diperbarui atau seumur hidup, berdasarkan tiap kunci. Ya Ya Tidak Ya Ya
Membatasi konkurensi Mencegah kebijakan tertutup dijalankan dengan lebih dari jumlah permintaan yang ditentukan pada satu waktu. Ya Ya Ya Ya Ya
Membatasi penggunaan token Layanan Azure OpenAI Mencegah lonjakan penggunaan AZURE OpenAI API dengan membatasi token model bahasa besar per kunci terhitung. Ya Ya Tidak Ya Ya
Membatasi penggunaan token API model bahasa besar Mencegah lonjakan penggunaan API model bahasa besar (LLM) dengan membatasi token LLM per kunci terhitung. Ya Ya Tidak Ya Ya

Autentikasi dan otorisasi

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Periksa header HTTP Memberlakukan keberadaan dan/atau nilai header HTTP. Ya Ya Ya Ya Ya
Mendapatkan konteks otorisasi Mendapatkan konteks otorisasi koneksi tertentu ke penyedia kredensial yang dikonfigurasi dalam instans API Management. Ya Ya Ya Tidak Tidak
Membatasi IP pemanggil Memfilter panggilan (memungkinkan/menolak) dari alamat IP dan/atau rentang alamat tertentu. Ya Ya Ya Ya Ya
Validasi token Microsoft Entra Memberlakukan keberadaan dan validitas Microsoft Entra (sebelumnya disebut Azure Active Directory) JWT yang diekstrak dari header HTTP, parameter kueri, atau nilai token tertentu. Ya Ya Ya Ya Ya
Memvalidasi JWT Memberlakukan keberadaan dan validitas JWT yang diekstrak dari header HTTP, parameter kueri, atau nilai token tertentu. Ya Ya Ya Ya Ya
Memvalidasi sertifikat klien Memberlakukan bahwa sertifikat yang disajikan oleh klien ke instans API Management cocok dengan aturan dan klaim validasi yang ditentukan. Ya Ya Ya Ya Ya
Mengautentikasi dengan Dasar Mengautentikasi dengan layanan backend menggunakan autentikasi Dasar. Ya Ya Ya Ya Ya
Mengautentikasi dengan sertifikat klien Mengautentikasi dengan layanan backend menggunakan sertifikat klien. Ya Ya Ya Ya Ya
Mengautentikasi dengan identitas terkelola Mengautentikasi dengan layanan backend menggunakan identitas terkelola. Ya Ya Ya Ya Tidak

Validasi konten

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Menerapkan pemeriksaan keamanan konten pada permintaan LLM Memberlakukan pengecekan keselamatan konten pada permintaan LLM (perintah) dengan mengirimkannya ke layanan Keamanan Konten Azure AI sebelum dikirim ke LLM backend. Ya Ya Ya Ya Ya
Memvalidasi konten Memvalidasi ukuran atau konten isi permintaan atau respons terhadap satu atau beberapa skema API. Format skema yang didukung adalah JSON dan XML. Ya Ya Ya Ya Ya
Memvalidasi permintaan GraphQL Memvalidasi dan memberikan otorisasi permintaan ke API GraphQL. Ya Ya Ya Ya Tidak
Memvalidasi permintaan OData Memvalidasi permintaan ke API OData untuk memastikan kesamaan dengan spesifikasi OData. Ya Ya Ya Ya Ya
Memvalidasi parameter Memvalidasi parameter header permintaan, kueri, atau jalur untuk memastikan kesesuaiannya dengan skema API. Ya Ya Ya Ya Ya
Validasi header Memvalidasi header respons terhadap skema API. Ya Ya Ya Ya Ya
Memvalidasi kode status Memvalidasi kode status HTTP sebagai respons terhadap skema API. Ya Ya Ya Ya Ya

Perutean

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Meneruskan permintaan Meneruskan permintaan ke layanan backend. Ya Ya Ya Ya Ya
Mengatur layanan backend Mengubah URL dasar layanan backend dari permintaan masuk ke URL atau backend. Mereferensikan sumber daya backend memungkinkan Anda mengelola URL dasar layanan backend dan pengaturan lainnya di satu tempat. Terapkan juga penyeimbangan beban lalu lintas di kumpulan layanan backend dan aturan pemutus arus untuk melindungi backend dari terlalu banyak permintaan. Ya Ya Ya Ya Ya
Mengatur proksi HTTP Memungkinkan Anda merutekan permintaan yang diteruskan melalui proksi HTTP. Ya Ya Ya Ya Ya

penyimpanan sementara

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Dapatkan dari cache Melakukan pencarian cache dan mengembalikan respons cache yang valid saat tersedia. Ya Ya Ya Ya Ya
Simpan ke cache Respons cache sesuai dengan konfigurasi kontrol cache yang ditentukan. Ya Ya Ya Ya Ya
Dapatkan nilai dari cache Mengambil item yang di-cache berdasarkan kunci. Ya Ya Ya Ya Ya
Simpan nilai dalam cache Menyimpan item dalam cache menurut kunci. Ya Ya Ya Ya Ya
Hapus nilai dari cache Menghapus item dalam cache menurut kunci. Ya Ya Ya Ya Ya
Mendapatkan respons cache permintaan Azure OpenAI API Melakukan pencarian di cache Azure OpenAI API menggunakan pencarian semantik dan mengembalikan respons cache yang valid saat tersedia. Ya Ya Ya Ya Tidak
Menyimpan respons permintaan Azure OpenAI API ke cache Respons cache sesuai dengan konfigurasi cache Azure OpenAI API. Ya Ya Ya Ya Tidak
Mendapatkan respons cache permintaan API model bahasa besar Melakukan pencarian dalam cache API model bahasa besar menggunakan pencarian semantik dan mengembalikan respons cache yang valid saat tersedia. Ya Ya Ya Ya Tidak
Menyimpan respons permintaan API model bahasa besar ke cache Meng-cache respons sesuai dengan konfigurasi cache API model bahasa berskala besar. Ya Ya Ya Ya Tidak

Transformasi

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Atur metode permintaan Memungkinkan Anda mengubah metode HTTP untuk permintaan. Ya Ya Ya Ya Ya
Atur kode status Mengubah kode status HTTP ke nilai yang ditentukan. Ya Ya Ya Ya Ya
Atur variabel Mempertahankan nilai dalam variabel konteks bernama untuk akses nanti. Ya Ya Ya Ya Ya
Tentukan isi Mengatur isi pesan untuk permintaan atau respons. Ya Ya Ya Ya Ya
Mengatur header HTTP Menetapkan nilai ke header respons dan/atau permintaan yang sudah ada atau menambahkan respons baru dan/atau header permintaan. Ya Ya Ya Ya Ya
Mengatur parameter string kueri Menambahkan, mengganti nilai, atau menghapus parameter string kueri permintaan. Ya Ya Ya Ya Ya
Menulis ulang URL Mengonversi URL permintaan dari bentuk publiknya ke bentuk yang diharapkan oleh layanan web. Ya Ya Ya Ya Ya
Mengonversi JSON ke XML Mengonversi isi permintaan atau respons dari JSON ke XML. Ya Ya Ya Ya Ya
Mengonversi XML ke JSON Mengonversi isi permintaan atau respons dari XML ke JSON. Ya Ya Ya Ya Ya
Menemukan dan mengganti string dalam konten Menemukan substring permintaan atau respons dan menggantinya dengan substring yang berbeda. Ya Ya Ya Ya Ya
Menutupi URL dalam konten Mengubah (menyembunyikan) tautan di isi respons sehingga menunjukkan ke tautan yang setara melalui gateway. Ya Ya Ya Ya Ya
Mengubah XML menggunakan XSLT Menerapkan transformasi XSL ke XML dalam isi permintaan atau respons. Ya Ya Ya Ya Ya
Mengembalikan respons Membatalkan eksekusi alur dan mengembalikan respons yang ditentukan langsung ke pemanggil. Ya Ya Ya Ya Ya
Respons tiruan Membatalkan eksekusi pipeline dan mengembalikan respons tiruan langsung ke pemanggil. Ya Ya Ya Ya Ya

Lintas domain

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Perbolehkan panggilan lintas domain Membuat API dapat diakses dari klien berbasis browser Adobe Flash dan Microsoft Silverlight. Ya Ya Ya Ya Ya
CORS Menambahkan dukungan berbagi sumber daya lintas asal (CORS) ke operasi atau API untuk memungkinkan panggilan lintas domain dari klien berbasis browser. Ya Ya Ya Ya Ya
JSONP Menambahkan dukungan JSON dengan padding (JSONP) ke operasi atau API untuk memungkinkan panggilan lintas domain dari klien berbasis browser JavaScript. Ya Ya Ya Ya Ya

Integrasi dan komunikasi eksternal

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Kirim permintaan Mengirim permintaan ke URL yang ditentukan. Ya Ya Ya Ya Ya
Kirim permintaan satu arah Mengirim permintaan ke URL yang ditentukan tanpa menunggu respons. Ya Ya Ya Ya Ya
Log ke hub peristiwa Mengirim pesan dalam format yang ditentukan ke hub peristiwa yang ditentukan oleh entitas Pencatat. Ya Ya Ya Ya Ya
Mengirim pesan ke Azure Service Bus (pratinjau) Mengirim pesan ke antrean atau topik Azure Service Bus. Ya Tidak Tidak Tidak Tidak
Mengirim permintaan ke layanan (Dapr) Menggunakan runtime Dapr untuk menemukan dan berkomunikasi dengan layanan mikro Dapr dengan andal. Untuk mempelajari selengkapnya tentang pemanggilan layanan di Dapr, lihat deskripsi dalam file README ini. Tidak Tidak Tidak Ya Tidak
Mengirim pesan ke topik Pub/Sub (Dapr) Menggunakan runtime Dapr untuk menerbitkan pesan ke topik Terbitkan/Berlangganan. Untuk mempelajari selengkapnya tentang pesan Terbitkan/Berlangganan di Dapr, lihat deskripsi dalam file README ini. Tidak Tidak Tidak Ya Tidak
Memicu pengikatan output (Dapr) Menggunakan runtime Dapr untuk memanggil sistem eksternal melalui pengikatan output. Untuk mempelajari selengkapnya tentang pengikatan di Dapr, lihat deskripsi dalam file README ini. Tidak Tidak Tidak Ya Tidak

Pencatatan

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Jejak Menambahkan jejak khusus ke output pelacakan permintaan di konsol pengujian, telemetri "Application Insights", dan log sumber daya. Ya Ya1 Ya Ya Ya
Memancarkan metrik Mengirim metrik kustom ke Application Insights saat dieksekusi. Ya Ya Ya Ya Ya
Mengeluarkan metrik token Azure OpenAI Mengirim metrik ke Application Insights untuk konsumsi token model bahasa besar melalui API layanan Azure OpenAI. Ya Ya Tidak Ya Ya
Menghasilkan metrik token API model bahasa besar Mengirim metrik ke Application Insights untuk konsumsi token model bahasa besar (LLM) melalui API LLM. Ya Ya Tidak Ya Ya

1 Di gateway V2, trace kebijakan saat ini tidak menambahkan output pelacakan di konsol pengujian.

Pemecah masalah GraphQL

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Sumber data Azure SQL untuk resolver Mengonfigurasi permintaan Azure SQL dan respons opsional untuk menyelesaikan data untuk jenis objek dan bidang dalam skema GraphQL. Ya Ya Tidak Tidak Tidak
Sumber data Cosmos DB untuk resolver Mengonfigurasi permintaan Cosmos DB dan respons opsional untuk menyelesaikan data untuk jenis objek dan bidang dalam skema GraphQL. Ya Ya Tidak Tidak Tidak
Sumber data HTTP untuk resolver Mengonfigurasi permintaan HTTP dan secara opsional respons HTTP untuk menyelesaikan data untuk jenis objek dan bidang dalam skema GraphQL. Ya Ya Ya Tidak Tidak
Menerbitkan peristiwa ke langganan GraphQL Menerbitkan peristiwa ke satu atau beberapa langganan yang ditentukan dalam skema API GraphQL. Konfigurasikan kebijakan dalam pemecah masalah GraphQL untuk bidang terkait dalam skema untuk jenis operasi lain seperti mutasi. Ya Ya Ya Tidak Tidak

Gateway AI

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Membatasi penggunaan token Layanan Azure OpenAI Mencegah lonjakan penggunaan AZURE OpenAI API dengan membatasi token model bahasa besar per kunci terhitung. Ya Ya Tidak Ya Ya
Membatasi penggunaan token API model bahasa besar Mencegah lonjakan penggunaan API model bahasa besar (LLM) dengan membatasi token LLM per kunci terhitung. Ya Ya Tidak Ya Ya
Mengeluarkan metrik token Azure OpenAI Mengirim metrik ke Application Insights untuk konsumsi token model bahasa besar melalui API layanan Azure OpenAI. Ya Ya Tidak Ya Ya
Menghasilkan metrik token API model bahasa besar Mengirim metrik ke Application Insights untuk konsumsi token model bahasa besar (LLM) melalui API LLM. Ya Ya Tidak Ya Ya
Mendapatkan respons cache permintaan Azure OpenAI API Melakukan pencarian di cache Azure OpenAI API menggunakan pencarian semantik dan mengembalikan respons cache yang valid saat tersedia. Ya Ya Ya Ya Tidak
Mendapatkan respons cache permintaan API model bahasa besar Melakukan pencarian dalam cache API model bahasa besar menggunakan pencarian semantik dan mengembalikan respons cache yang valid saat tersedia. Ya Ya Ya Ya Tidak
Menyimpan respons permintaan Azure OpenAI API ke cache Respons cache sesuai dengan konfigurasi cache Azure OpenAI API. Ya Ya Ya Ya Tidak
Menyimpan respons permintaan API model bahasa besar ke cache Meng-cache respons sesuai dengan konfigurasi cache API model bahasa berskala besar. Ya Ya Ya Ya Tidak
Menerapkan pemeriksaan keamanan konten pada permintaan LLM Memberlakukan pengecekan keselamatan konten pada permintaan LLM (perintah) dengan mengirimkannya ke layanan Keamanan Konten Azure AI sebelum dikirim ke LLM backend. Ya Ya Ya Ya Ya

Kontrol dan alur kebijakan

Policy Deskripsi Klasik V2 Konsumsi Hosting Mandiri Ruang kerja
Alur kontrol Menerapkan pernyataan kebijakan secara kondisional berdasarkan hasil evaluasi ekspresi Boolean. Ya Ya Ya Ya Ya
Sertakan fragmen Menyisipkan fragmen kebijakan dalam definisi kebijakan. Ya Ya Ya Ya Ya
Pengulangan Coba lagi eksekusi pernyataan kebijakan yang diapit, jika dan hingga kondisi terpenuhi. Eksekusi akan berulang pada interval waktu yang ditentukan dan hingga hitungan percobaan ulang yang ditentukan. Ya Ya Ya Ya Ya
Tunggu Menunggu permintaan Kirim yang diapit, Dapatkan nilai dari cache, atau kebijakan pengendalian alur selesai sebelum melanjutkan. Ya Ya Ya Ya Ya

Konten terkait

Untuk informasi selengkapnya tentang mengelola kebijakan, lihat:

  • Last updated on