Atur kode status
BERLAKU UNTUK: Semua tingkatAN API Management
Kebijakan set-status menyetel kode status HTTP ke nilai yang ditentukan.
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-status code="HTTP status code" reason="description"/>
Atribut
| Atribut | Deskripsi | Wajib diisi | Default |
|---|---|---|---|
| kode | Bilangan bulat. Kode status HTTP yang akan dikembalikan. Ekspresi kebijakan diizinkan. | Ya | T/A |
| reason | String. Deskripsi alasan untuk mengembalikan kode status. Ekspresi kebijakan diizinkan. | Ya | T/A |
Penggunaan
- Bagian kebijakan: masuk, keluar, backend, saat terjadi kesalahan
- Cakupan kebijakan: global, ruang kerja, produk, API, operasi
- Gateway: klasik, v2, konsumsi, dihost sendiri
Contoh
Contoh ini menunjukkan cara mengembalikan respons 401 jika token otorisasi tidak valid. Untuk informasi selengkapnya, lihat Menggunakan layanan eksternal dari layanan Azure API Management.
<choose>
<when condition="@((bool)((IResponse)context.Variables["tokenstate"]).Body.As<JObject>()["active"] == false)">
<return-response response-variable-name="existing response variable">
<set-status code="401" reason="Unauthorized" />
<set-header name="WWW-Authenticate" exists-action="override">
<value>Bearer error="invalid_token"</value>
</set-header>
</return-response>
</when>
</choose>
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
- Kebijakan penulis menggunakan Microsoft Copilot untuk Azure