Query Keys - Delete
Menghapus kunci kueri yang ditentukan. Tidak seperti kunci admin, kunci kueri tidak diregenerasi. Proses untuk meregenerasi kunci kueri adalah menghapus lalu membuatnya kembali. Mengembalikan 200 (OK) saat berhasil dihapus, 204 (Tidak Ada Konten) jika layanan ada tetapi kunci kueri tidak ditemukan, atau 404 (Tidak Ditemukan) jika layanan tidak ditemukan. CATATAN: Perilaku mengembalikan 404 tidak konsisten dengan pedoman ARM. Klien harus mengharapkan respons 204 di versi mendatang dan menghindari dependensi baru pada respons 404.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/deleteQueryKey/{key}?api-version=2025-05-01
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
key
|
path | True |
string |
Kunci kueri yang akan dihapus. Kunci kueri diidentifikasi berdasarkan nilai, bukan berdasarkan nama. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil. |
|
search
|
path | True |
string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ |
Nama layanan Azure AI Search yang terkait dengan grup sumber daya yang ditentukan. |
|
subscription
|
path | True |
string (uuid) |
ID langganan target. Nilainya harus sebuah UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang digunakan untuk operasi ini. |
Header Permintaan
| Nama | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
Nilai GUID yang dihasilkan klien yang mengidentifikasi permintaan ini. Jika ditentukan, ini akan disertakan dalam informasi respons sebagai cara untuk melacak permintaan. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Permintaan telah berhasil. |
|
| 204 No Content |
Tidak ada konten untuk dikirim untuk permintaan ini, tetapi header mungkin berguna. |
|
| 404 Not Found |
Server tidak dapat menemukan sumber daya yang diminta. |
|
| Other Status Codes |
Respons kesalahan tak terduga. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
| Nama | Deskripsi |
|---|---|
| user_impersonation | meniru akun pengguna Anda |
Contoh
SearchDeleteQueryKey
Permintaan sampel
Respon sampel
Definisi
| Nama | Deskripsi |
|---|---|
|
Cloud |
Berisi informasi tentang kesalahan API. |
|
Cloud |
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan. |
CloudError
Berisi informasi tentang kesalahan API.
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan. |
|
| message |
string |
Deskripsi singkat tentang kesalahan yang mengisyaratkan apa yang salah (untuk informasi detail/penelusuran kesalahan merujuk ke properti 'error.message'). |
CloudErrorBody
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| code |
string |
Kode kesalahan yang menjelaskan kondisi kesalahan lebih tepat daripada kode status HTTP. Dapat digunakan untuk menangani kasus kesalahan tertentu secara terprogram. |
| details |
Berisi kesalahan berlapis yang terkait dengan kesalahan ini. |
|
| message |
string |
Pesan yang menjelaskan kesalahan secara rinci dan menyediakan informasi penelusuran kesalahan. |
| target |
string |
Target kesalahan tertentu (misalnya, nama properti dalam kesalahan). |