Search Management

REST API Manajemen Azure Cognitive Search menyediakan akses terprogram ke operasi administratif:

  • Membuat atau menghapus layanan pencarian
  • Membuat, meregenerasi, atau mengambil api-keys (kunci kueri atau admin)
  • Menambahkan atau menghapus replika dan partisi (menyesuaikan kapasitas)
  • Mengonfigurasi layanan pencarian untuk menggunakan titik akhir privat

Untuk semua tugas lain, seperti membuat dan mengkueri indeks, gunakan REST API Layanan Pencarian sebagai gantinya.

Untuk sepenuhnya mengelola layanan Anda secara terprogram, Anda memerlukan dua API: REST API Manajemen Azure Cognitive Search yang didokumentasikan di sini, ditambah Azure Resource Manager REST API umum. API Resource Manager digunakan untuk operasi tujuan umum yang tidak spesifik layanan, seperti mengkueri data langganan, mencantumkan lokasi geografis, dan sebagainya.

Koneksi ke titik akhir manajemen

Saat menyiapkan koneksi, mulailah dengan titik https://management.azure.comakhir Resource Manager . Permintaan HTTP mencakup titik akhir Resource Manager, ID langganan, penyedia (Microsoft.Search), dan versi API. Operasi ditentukan dalam isi permintaan.

Titik akhir yang sepenuhnya ditentukan memiliki komponen berikut:

https://management.azure.com/subscriptions/[subscriptionId]/resourceGroups/[resourceGroupName]/providers/Microsoft.Search/searchServices/[serviceName]?api-version=2020-08-01

Klien berikut umumnya digunakan untuk memanggil REST API manajemen:

Anda juga dapat menggunakan portal Azure.

Autentikasi dan kontrol akses

Hak administrasi disampaikan melalui peran dalam Azure Active Directory (AD). Praktik terbaik adalah menetapkan peran ke grup daripada pengguna individual. Pemilik langganan atau administrator global mengelola penugasan ini. Untuk informasi selengkapnya, lihat Menetapkan peran Azure AD ke grup.

Untuk manajemen layanan pencarian, peran yang didukung termasuk Pemilik, Kontributor, dan Pembaca. Untuk daftar lengkapnya, lihat Otorisasi berbasis peran.

API Manajemen di SDK lain

REST API bersifat dasar untuk Azure Cognitive Search, dan setiap perubahan pada model pemrograman tercermin dalam REST API terlebih dahulu.

Alternatifnya termasuk Azure SDK berikut, yang diperbarui secara independen pada jadwal rilis terpisah:

Lihat juga