Query Keys - Delete

Odstraní zadaný klíč dotazu. Na rozdíl od klíčů správce se klíče dotazů znovu negenerují. Proces opětovného vygenerování klíče dotazu spočívá v jeho odstranění a opětovném vytvoření. Při úspěšném smazání vrátí 200 (OK), 204 (Žádný obsah), pokud služba existuje, ale klíče dotazu nejsou nalezeny, nebo 404 (Nenalezeno), pokud služba není nalezena. POZNÁMKA: Chování při vracení 404 není v souladu s pokyny ARM. Klienti by měli očekávat odpověď 204 v budoucích verzích a vyhnout se novým závislostem na odpovědi 404.

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

Parametry identifikátoru URI

Název V Vyžadováno Typ Description
key
path True

string

Klíč dotazu, který má být odstraněn. Klíče dotazů jsou identifikovány hodnotou, nikoli názvem.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Název skupiny zdrojů. Název nerozlišuje velikost písmen.

searchServiceName
path True

string

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

Název služby Azure AI Vyhledávač přidružené k zadané skupině prostředků.

subscriptionId
path True

string (uuid)

ID cílového předplatného. Hodnota musí být UUID.

api-version
query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Název Vyžadováno Typ Description
x-ms-client-request-id

string (uuid)

Hodnota GUID vygenerovaná klientem, která identifikuje tento požadavek. Pokud je zadáno, budou tyto informace zahrnuty do informací o odpovědích jako způsob, jak sledovat požadavek.

Odpovědi

Název Typ Description
200 OK

Požadavek byl úspěšný.

204 No Content

Pro tento požadavek se nedá odeslat žádný obsah, ale hlavičky můžou být užitečné.

404 Not Found

Server nemůže najít požadovaný prostředek.

Other Status Codes

CloudError

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 služby Azure Active Directory.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Název Description
user_impersonation vydávat se za svůj uživatelský účet

Příklady

SearchDeleteQueryKey

Ukázkový požadavek

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=2026-11-01

Ukázková odpověď

Definice

Název Description
CloudError

Obsahuje informace o chybě rozhraní API.

CloudErrorBody

Popisuje konkrétní chybu rozhraní API s kódem chyby a zprávou.

CloudError

Obsahuje informace o chybě rozhraní API.

Název Typ Description
error

CloudErrorBody

Popisuje konkrétní chybu rozhraní API s kódem chyby a zprávou.

message

string

Stručný popis chyby, která naznačuje, co se nepovedlo (podrobnosti nebo informace o ladění najdete ve vlastnosti error.message).

CloudErrorBody

Popisuje konkrétní chybu rozhraní API s kódem chyby a zprávou.

Název Typ Description
code

string

Kód chyby, který popisuje chybový stav přesněji než stavový kód HTTP. Dá se použít k programovému zpracování konkrétních případů chyb.

details

CloudErrorBody[]

Obsahuje vnořené chyby, které souvisejí s touto chybou.

message

string

Zpráva, která podrobně popisuje chybu a poskytuje informace o ladění.

target

string

Cíl konkrétní chyby (například název chybné vlastnosti).