Query Keys - Delete

Törli a megadott lekérdezési kulcsot. A rendszergazdai kulcsokkal ellentétben a lekérdezési kulcsok nem jönnek létre újra. A lekérdezési kulcs újragenerálásának folyamata a törlés, majd az újbóli létrehozása. Sikeres törléskor 200 (OK), 204 (Tartalom Nincs), ha a szolgáltatás létezik, de a lekérdezési kulcsok nem találhatók, vagy 404 (Nem talált), ha a szolgáltatás nem található. MEGJEGYZÉS: A 404-es visszaküldés viselkedése ellentmond az ARM irányelveivel. Az ügyfeleknek a jövőbeli verziókban 204-es választ kell várniuk, és elkerülniük kell az új függőségeket a 404-es válaszon.

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

URI-paraméterek

Név In Kötelező Típus Description
key
path True

string

A törölni kívánt lekérdezési kulcs. A lekérdezési kulcsokat nem név, hanem érték azonosítja.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

searchServiceName
path True

string

pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$

A megadott erőforráscsoporthoz társított Azure AI Search szolgáltatás neve.

subscriptionId
path True

string (uuid)

A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.

api-version
query True

string

minLength: 1

A művelethez használandó API-verzió.

Kérelem fejléce

Név Kötelező Típus Description
x-ms-client-request-id

string (uuid)

Egy ügyfél által létrehozott GUID-érték, amely azonosítja ezt a kérést. Ha meg van adva, ez a kérés nyomon követésének módjaként szerepelni fog a válaszinformációkban.

Válaszok

Név Típus Description
200 OK

A kérés sikeres volt.

204 No Content

A kéréshez nincs elküldhető tartalom, de a fejlécek hasznosak lehetnek.

404 Not Found

A kiszolgáló nem találja a kért erőforrást.

Other Status Codes

CloudError

Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

SearchDeleteQueryKey

Mintakérelem

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

Mintaválasz

Definíciók

Név Description
CloudError

Api-hibával kapcsolatos információkat tartalmaz.

CloudErrorBody

Egy adott API-hibát ír le egy hibakóddal és egy üzenettel.

CloudError

Api-hibával kapcsolatos információkat tartalmaz.

Név Típus Description
error

CloudErrorBody

Egy adott API-hibát ír le egy hibakóddal és egy üzenettel.

message

string

A hiba rövid leírása, amely arra utal, hogy mi történt (a részletekért/hibakeresési információkért tekintse meg a "error.message" tulajdonságot).

CloudErrorBody

Egy adott API-hibát ír le egy hibakóddal és egy üzenettel.

Név Típus Description
code

string

Hibakód, amely pontosabban írja le a hibafeltételt, mint egy HTTP-állapotkód. Adott hibaeseteket programozott módon is kezelhet.

details

CloudErrorBody[]

Beágyazott hibákat tartalmaz, amelyek ehhez a hibához kapcsolódnak.

message

string

A hibát részletesen leíró és hibakeresési információkat tartalmazó üzenet.

target

string

Az adott hiba célja (például a hiba tulajdonságának neve).