Query Keys - Delete

Usuwa określony klucz zapytania. W przeciwieństwie do kluczy administracyjnych klucze zapytań nie są generowane ponownie. Proces ponownego generowania klucza zapytania polega na usunięciu, a następnie ponownym utworzeniu go. Zwraca 200 (OK) po pomyślnym ususzczeniu, 204 (Brak treści), jeśli usługa istnieje, ale klucze zapytań nie znalezione, lub 404 (Nie znalezione), jeśli usługa nie zostanie znaleziona. UWAGA: Zachowanie zwracającego 404 jest niezgodne z wytycznymi ARM. Klienci powinni spodziewać się odpowiedzi 204 w przyszłych wersjach i unikać nowych zależności od odpowiedzi 404.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
key
path True

string

Klucz zapytania do usunięcia. Klucze zapytań są identyfikowane według wartości, a nie według nazwy.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

searchServiceName
path True

string

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

Nazwa usługi Azure AI Search skojarzonej z określoną grupą zasobów.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa Wymagane Typ Opis
x-ms-client-request-id

string (uuid)

Wartość identyfikatora GUID wygenerowana przez klienta, która identyfikuje to żądanie. Jeśli zostanie określony, zostanie to uwzględnione w informacjach o odpowiedzi jako sposób śledzenia żądania.

Odpowiedzi

Nazwa Typ Opis
200 OK

Żądanie zakończyło się pomyślnie.

204 No Content

Brak zawartości do wysłania dla tego żądania, ale nagłówki mogą być przydatne.

404 Not Found

Serwer nie może odnaleźć żądanego zasobu.

Other Status Codes

CloudError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

SearchDeleteQueryKey

Przykładowe żądanie

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

Przykładowa odpowiedź

Definicje

Nazwa Opis
CloudError

Zawiera informacje o błędzie interfejsu API.

CloudErrorBody

Opisuje określony błąd interfejsu API z kodem błędu i komunikatem.

CloudError

Zawiera informacje o błędzie interfejsu API.

Nazwa Typ Opis
error

CloudErrorBody

Opisuje określony błąd interfejsu API z kodem błędu i komunikatem.

message

string

Krótki opis błędu, który wskazuje, co poszło nie tak (aby uzyskać szczegółowe informacje/debugowanie, zapoznaj się z właściwością "error.message").

CloudErrorBody

Opisuje określony błąd interfejsu API z kodem błędu i komunikatem.

Nazwa Typ Opis
code

string

Kod błędu opisujący warunek błędu dokładniej niż kod stanu HTTP. Może służyć do programowego obsługi określonych przypadków błędów.

details

CloudErrorBody[]

Zawiera zagnieżdżone błędy związane z tym błędem.

message

string

Komunikat opisujący szczegółowo błąd i zawierający informacje o debugowaniu.

target

string

Element docelowy określonego błędu (na przykład nazwa właściwości w błędzie).