Query Keys - Delete

Tar bort den angivna frågenyckeln. Till skillnad från administratörsnycklar återskapas inte frågenycklar. Processen för att återskapa en frågenyckel är att ta bort och sedan återskapa den. Returnerar 200 (OK) vid lyckad radering, 204 (Inget innehåll) om tjänsten finns men söknycklarna inte hittas, eller 404 (Ej hittad) om tjänsten inte hittas. OBS: Beteendet för att returnera 404 är inkonsekvent med ARM:s riktlinjer. Klienter bör förvänta sig ett 204-svar i framtida versioner och undvika nya beroenden av 404-svaret.

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

URI-parametrar

Name I Obligatorisk Typ Description
key
path True

string

Frågenyckeln som ska tas bort. Frågenycklar identifieras med ett värde, inte ett namn.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

searchServiceName
path True

string

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

Namnet på den Azure AI-sökning-tjänst som är associerad med den angivna resursgruppen.

subscriptionId
path True

string (uuid)

ID för målprenumerationen. Värdet måste vara ett UUID.

api-version
query True

string

minLength: 1

Den API-version som ska användas för den här åtgärden.

Begärandehuvud

Name Obligatorisk Typ Description
x-ms-client-request-id

string (uuid)

Ett klientgenererat GUID-värde som identifierar den här begäran. Om det anges inkluderas detta i svarsinformationen som ett sätt att spåra begäran.

Svar

Name Typ Description
200 OK

Begäran har slutförts.

204 No Content

Det finns inget innehåll att skicka för den här begäran, men rubrikerna kan vara användbara.

404 Not Found

Servern kan inte hitta den begärda resursen.

Other Status Codes

CloudError

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

SearchDeleteQueryKey

Exempelbegäran

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

Exempelsvar

Definitioner

Name Description
CloudError

Innehåller information om ett API-fel.

CloudErrorBody

Beskriver ett visst API-fel med en felkod och ett meddelande.

CloudError

Innehåller information om ett API-fel.

Name Typ Description
error

CloudErrorBody

Beskriver ett visst API-fel med en felkod och ett meddelande.

message

string

En kort beskrivning av felet som antyder vad som gick fel (mer information/felsökningsinformation finns i egenskapen "error.message").

CloudErrorBody

Beskriver ett visst API-fel med en felkod och ett meddelande.

Name Typ Description
code

string

En felkod som beskriver feltillståndet mer exakt än en HTTP-statuskod. Kan användas för att programmatiskt hantera specifika felfall.

details

CloudErrorBody[]

Innehåller kapslade fel som är relaterade till det här felet.

message

string

Ett meddelande som beskriver felet i detalj och ger felsökningsinformation.

target

string

Målet för det specifika felet (till exempel namnet på den felaktiga egenskapen).