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.

Lihat juga