Memperbarui peta sinonim (Azure AI Search REST API)
Menimpa definisi peta sinonim yang ada dengan versi yang direvisi.
PUT https://[service name].search.windows.net/synonymmaps/[synonymmap name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Parameter URI
| Parameter | Deskripsi |
|---|---|
| nama layanan | Wajib diisi. Atur ini ke nama unik yang ditentukan pengguna dari layanan pencarian Anda. |
| nama peta sinonim | Wajib diisi. URI permintaan menentukan nama peta sinonim yang akan diperbarui. |
| versi-api | Wajib diisi. Versi stabil saat ini adalah api-version=2020-06-30. Lihat versi API untuk versi lainnya. |
Judul Permintaan
Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.
| Bidang | Deskripsi |
|---|---|
| Jenis-Konten | Wajib diisi. Atur titik akhir ini ke application/json |
| api-key | Opsional jika Anda menggunakan peran Azure dan token pembawa disediakan berdasarkan permintaan, jika tidak, kunci diperlukan. Kunci api adalah string unik yang dihasilkan sistem yang mengautentikasi permintaan ke layanan pencarian Anda. Permintaan pembaruan harus menyertakan header yang api-key diatur ke kunci admin Anda (dibandingkan dengan kunci kueri). Lihat Menyambungkan ke Pencarian Azure AI menggunakan autentikasi kunci untuk detailnya. |
Isi Permintaan
Sintaks isi permintaan sama dengan untuk Buat Peta Sinonim.
Saat memperbarui peta sinonim yang ada, seluruh definisi diganti dengan konten isi permintaan. Secara umum, pola terbaik yang digunakan untuk pembaruan adalah mengambil definisi dengan GET, memodifikasinya, lalu memperbaruinya dengan PUT.
Respons
Untuk permintaan yang berhasil, "201 Dibuat" jika peta sinonim baru dibuat, dan "204 Tanpa Konten" jika peta sinonim yang ada diperbarui
Secara default isi respons akan kosong. Namun, jika Prefer header permintaan diatur ke return=representation, isi respons akan berisi JSON untuk peta sinonim yang diperbarui atau dibuat. Dalam hal ini, kode status keberhasilan akan menjadi "201 Dibuat" jika peta sinonim baru dibuat dan "200 OK" jika peta sinonim yang ada diperbarui.