Admin Keys - Get

Szolgáltatás:: Search Management

API-verzió:: 2025-02-01-preview

Lekéri a megadott Azure AI Search szolgáltatás elsődleges és másodlagos rendszergazdai API-kulcsait.

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

URI-paraméterek

Név	In	Kötelező	Típus	Description
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	AdminKeyResult	A rendszergazdai kulcsok lekérése sikeresen megtörtént, és a válaszban szerepelnek. Az elsődleges vagy a másodlagos kulcs az "api-key" paraméter értékeként használható az Azure AI Search szolgáltatás REST API-jában vagy az SDK-ban, hogy bármilyen műveletet végrehajtson a keresési szolgáltatáson, beleértve a kiemelt műveleteket is. A kiemelt műveletek közé tartozik az erőforrások, például az indexek és adatforrások kezelése, valamint az adatok feltöltése, módosítása vagy törlése az indexekben.
Other Status Codes	CloudError	HTTP 404 (Nem található): Az előfizetés, az erőforráscsoport vagy a keresési szolgáltatás nem található. 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

SearchGetAdminKeys

Mintakérelem

HTTP

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/listAdminKeys?api-version=2025-02-01-preview

Mintaválasz

Állapotkód:: 200

{
  "primaryKey": "<your primary admin API key>",
  "secondaryKey": "<your secondary admin API key>"
}

Definíciók

Név	Description
AdminKeyResult	Egy adott Azure AI Search szolgáltatás elsődleges és másodlagos rendszergazdai API-kulcsait tartalmazó válasz.
CloudError	Api-hibával kapcsolatos információkat tartalmaz.
CloudErrorBody	Egy adott API-hibát ír le egy hibakóddal és egy üzenettel.

AdminKeyResult

Tárgy

Egy adott Azure AI Search szolgáltatás elsődleges és másodlagos rendszergazdai API-kulcsait tartalmazó válasz.

Név	Típus	Description
primaryKey	string	A keresési szolgáltatás elsődleges rendszergazdai API-kulcsa.
secondaryKey	string	A keresési szolgáltatás másodlagos rendszergazdai API-kulcsa.

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).