Memperbarui Pengindeks (Azure AI 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 | 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 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.