Query Keys - Delete

Layanan:
Search Management
Versi API:
2025-02-01-preview

Menghapus kunci kueri yang ditentukan. Tidak seperti kunci admin, kunci kueri tidak diregenerasi. Proses untuk meregenerasi kunci kueri adalah menghapus lalu membuatnya kembali.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/deleteQueryKey/{key}?api-version=2025-02-01-preview

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
key
 path True

string

Kunci kueri yang akan dihapus. Kunci kueri diidentifikasi berdasarkan nilai, bukan berdasarkan nama.
resourceGroupName
 path True

string

Nama grup sumber daya dalam langganan saat ini. Anda dapat memperoleh nilai ini dari API Azure Resource Manager atau portal.
searchServiceName
 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.
subscriptionId
 path True

string

Pengidentifikasi unik untuk langganan Microsoft Azure. Anda dapat memperoleh nilai ini dari API Azure Resource Manager atau portal.
api-version
 query True

string

Versi API yang akan digunakan untuk setiap permintaan.

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

Kunci kueri berhasil dihapus.
204 No Content

Kunci kueri berhasil dihapus.
404 Not Found

Langganan, grup sumber daya, layanan pencarian, atau kunci kueri tidak dapat ditemukan.
Other Status Codes

CloudError

HTTP 409 (Konflik): Langganan yang ditentukan dinonaktifkan.

Keamanan

azure_auth

Menentukan alur pemberian implisit, seperti yang didukung pada platform Identitas Microsoft.

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

DELETE https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/deleteQueryKey/<a query API key>?api-version=2025-02-01-preview

Respon sampel

Kode status:
200
Kode status:
204
Kode status:
404

Definisi

Nama Deskripsi
CloudError

Berisi informasi tentang kesalahan API.
CloudErrorBody

Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan.

CloudError

Objek

Berisi informasi tentang kesalahan API.

Nama Jenis Deskripsi
error

CloudErrorBody

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

Objek

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

CloudErrorBody[]

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).