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. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Název skupiny prostředků. Název nerozlišuje malá a velká písmena. |
|
search
|
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ů. |
|
subscription
|
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 |
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
Ukázková odpověď
Definice
| Name | Description |
|---|---|
|
Cloud |
Obsahuje informace o chybě rozhraní API. |
|
Cloud |
Popisuje konkrétní chybu rozhraní API s kódem chyby a zprávou. |
CloudError
Obsahuje informace o chybě rozhraní API.
| Name | Typ | Description |
|---|---|---|
| error |
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 |
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ě). |