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. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
search
|
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. |
|
subscription
|
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 |
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
Przykładowa odpowiedź
Definicje
| Nazwa | Opis |
|---|---|
|
Cloud |
Zawiera informacje o błędzie interfejsu API. |
|
Cloud |
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 |
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 |
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). |