Query Keys - Delete

Szolgáltatás:
Search Management
API-verzió:
2025-02-01-preview

Törli a megadott lekérdezési kulcsot. A rendszergazdai kulcsokkal ellentétben a lekérdezési kulcsok nem jönnek létre újra. A lekérdezési kulcs újragenerálásának folyamata a törlés, majd az újbóli létrehozása.

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

URI-paraméterek

Név In Kötelező Típus Description
key
 path True

string

A törölni kívánt lekérdezési kulcs. A lekérdezési kulcsokat nem név, hanem érték azonosítja.
resourceGroupName
 path True

string

Az aktuális előfizetésen belüli erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
searchServiceName
 path True

string

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

A megadott erőforráscsoporthoz társított Azure AI Search szolgáltatás neve.
subscriptionId
 path True

string

A Microsoft Azure-előfizetés egyedi azonosítója. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
api-version
 query True

string

Az egyes kérésekhez használandó API-verzió.

Kérelem fejléce

Név Kötelező Típus Description
x-ms-client-request-id

string (uuid)

Egy ügyfél által létrehozott GUID-érték, amely azonosítja ezt a kérést. Ha meg van adva, ez a kérés nyomon követésének módjaként szerepelni fog a válaszinformációkban.

Válaszok

Név Típus Description
200 OK

A lekérdezési kulcs törlése sikeresen megtörtént.
204 No Content

A lekérdezési kulcs törlése sikeresen megtörtént.
404 Not Found

Az előfizetés, az erőforráscsoport, a keresési szolgáltatás vagy a lekérdezési kulcs nem található.
Other Status Codes

CloudError

HTTP 409 (Ütközés): A megadott előfizetés le van tiltva.

Biztonság

azure_auth

Implicit engedélyezési folyamatot határoz meg a Microsoft Identity platformon támogatott módon.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

SearchDeleteQueryKey

Mintakérelem

DELETE https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/deleteQueryKey/<a query API key>?api-version=2025-02-01-preview

Mintaválasz

Állapotkód:
200
Állapotkód:
204
Állapotkód:
404

Definíciók

Név Description
CloudError

Api-hibával kapcsolatos információkat tartalmaz.
CloudErrorBody

Egy adott API-hibát ír le egy hibakóddal és egy üzenettel.

CloudError

Tárgy

Api-hibával kapcsolatos információkat tartalmaz.

Név Típus Description
error

CloudErrorBody

Egy adott API-hibát ír le egy hibakóddal és egy üzenettel.
message

string

A hiba rövid leírása, amely arra utal, hogy mi történt (a részletekért/hibakeresési információkért tekintse meg a "error.message" tulajdonságot).

CloudErrorBody

Tárgy

Egy adott API-hibát ír le egy hibakóddal és egy üzenettel.

Név Típus Description
code

string

Hibakód, amely pontosabban írja le a hibafeltételt, mint egy HTTP-állapotkód. Adott hibaeseteket programozott módon is kezelhet.
details

CloudErrorBody[]

Beágyazott hibákat tartalmaz, amelyek ehhez a hibához kapcsolódnak.
message

string

A hibát részletesen leíró és hibakeresési információkat tartalmazó üzenet.
target

string

Az adott hiba célja (például a hiba tulajdonságának neve).