Memperbarui Pengindeks (Azure Cognitive Search REST API)
Anda dapat memperbarui definisi pengindeks yang ada menggunakan permintaan HTTP PUT. Tentukan nama pengindeks yang akan diperbarui pada URI permintaan:
PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Memperbarui definisi pengindeks tidak menjalankannya secara otomatis, tetapi tergantung pada modifikasi Anda dan sumber data terkait, reset dan eksekusi ulang mungkin diperlukan.
Parameter URI
| Parameter | Deskripsi |
|---|---|
| nama layanan | Wajib diisi. Atur ini ke nama unik yang ditentukan pengguna dari layanan pencarian Anda. |
| nama pengindeks | Wajib diisi. URI permintaan menentukan nama pengindeks 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 | Wajib diisi. api-key digunakan untuk mengautentikasi permintaan ke layanan Pencarian Anda. Ini adalah nilai string, unik untuk layanan Anda. Permintaan pembaruan harus menyertakan header yang api-key diatur ke kunci admin Anda (dibandingkan dengan kunci kueri). Anda dapat menemukan kunci API di dasbor layanan pencarian di portal Azure. |
Isi Permintaan
Sintaks isi permintaan sama dengan untuk Buat Pengindeks.
Saat memperbarui pengindeks yang ada, seluruh definisi diganti dengan konten isi permintaan. Secara umum, pola terbaik yang digunakan untuk pembaruan adalah mengambil definisi pengindeks dengan GET, memodifikasinya, lalu memperbaruinya dengan PUT.
Respons
Untuk permintaan yang berhasil: 201 Dibuat jika pengindeks baru dibuat, dan 204 Tidak Ada Konten jika pengindeks yang ada diperbarui.