Menetapkan variabel
BERLAKU UNTUK: Semua tingkatAN API Management
Kebijakan set-variable mendeklarasikan variabel konteks dan menetapkan nilai yang ditentukan melalui ungkapan atau string literal. Jika ekspresi berisi harfiah, ekspresi akan dikonversi menjadi string dan jenis nilainya adalah System.String.
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-variable name="variable name" value="Expression | String literal" />
Atribut
| Atribut | Deskripsi | Wajib |
|---|---|---|
| nama | Nama variabel. Ekspresi kebijakan tidak diizinkan. | Ya |
| value | Nilai variabel. Ini bisa menjadi ungkapan atau nilai literal. Ekspresi kebijakan diizinkan. | Ya |
Penggunaan
- Bagian kebijakan: masuk, keluar, backend, saat terjadi kesalahan
- Cakupan kebijakan: global, ruang kerja, produk, API, operasi
- Gateway: klasik, v2, konsumsi, dihost sendiri, ruang kerja
Jenis yang diizinkan
Ungkapan yang digunakan dalam kebijakan set-variable harus mengembalikan salah satu dari jenis dasar berikut.
- System.Boolean
- System.SByte
- System.Byte
- System.UInt16
- System.UInt32
- System.UInt64
- System.Int16
- System.Int32
- System.Int64
- System.Decimal
- System.Single
- System.Double
- System.Guid
- System.String
- System.Char
- System.DateTime
- System.TimeSpan
- System.Byte?
- System.UInt16?
- System.UInt32?
- System.UInt64?
- System.Int16?
- System.Int32?
- System.Int64?
- System.Decimal?
- System.Single?
- System.Double?
- System.Guid?
- System.String?
- System.Char?
- System.DateTime?
Contoh
Contoh berikut menunjukkan set-variable kebijakan di bagian masuk. Kebijakan variabel yang ditetapkan ini membuat variabel isMobile Boolean konteks yang disetel ke benar jika User-Agent header permintaan berisi teks iPad atau iPhone.
<set-variable name="IsMobile" value="@(context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPad") || context.Request.Headers.GetValueOrDefault("User-Agent","").Contains("iPhone"))" />
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 di Azure