Query Keys - Delete

Odstraní zadaný klíč dotazu. Na rozdíl od klíčů správce se klíče dotazu nevygenerují znovu. Proces opětovného vygenerování klíče dotazu je odstranit a pak ho znovu vytvořit. 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=2025-05-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
key
path True

string

Klíč dotazu, který se má odstranit. Klíče dotazů se identifikují podle hodnoty, nikoli podle názvu.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.

searchServiceName
path True

string

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

Název služby Azure AI Search 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

Name 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

Name 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 Azure Active Directory OAuth2

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

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

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=2025-05-01

Ukázková odpověď

Definice

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

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

Name 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 vlastnosti v chybě).