Admin Keys - Regenerate

Szolgáltatás:: Search Management

API-verzió:: 2024-03-01-preview

Újragenerálja az elsődleges vagy a másodlagos rendszergazdai API-kulcsot. Egyszerre csak egy kulcsot lehet újragenerálni.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/regenerateAdminKey/{keyKind}?api-version=2024-03-01-preview

URI-paraméterek

Név	In	Kötelező	Típus	Description
keyKind	path	True	AdminKeyKind	Megadja, hogy melyik kulcs legyen újragenerálva. Az érvényes értékek közé tartozik az "elsődleges" és a "másodlagos".
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 megadott rendszergazdai kulcs létrehozása sikeresen megtörtént. A válasz mindkét rendszergazdai kulcsot tartalmazza, beleértve az újonnan létrehozott kulcsot is.
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

SearchRegenerateAdminKey

Mintakérelem

HTTP

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/regenerateAdminKey/primary?api-version=2024-03-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
AdminKeyKind	Megadja, hogy melyik kulcs legyen újragenerálva. Az érvényes értékek közé tartozik az "elsődleges" és a "másodlagos".
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.

AdminKeyKind

Felsorolás

Megadja, hogy melyik kulcs legyen újragenerálva. Az érvényes értékek közé tartozik az "elsődleges" és a "másodlagos".

Érték	Description
primary	A keresési szolgáltatás elsődleges API-kulcsa.
secondary	A keresési szolgáltatás másodlagos API-kulcsa.

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