Admin Keys - Get
Mendapatkan kunci API admin utama dan sekunder untuk layanan Azure AI Search yang ditentukan.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/listAdminKeys?api-version=2025-05-01
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil. |
|
search
|
path | True |
string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ |
Nama layanan Azure AI Search yang terkait dengan grup sumber daya yang ditentukan. |
|
subscription
|
path | True |
string (uuid) |
ID langganan target. Nilainya harus sebuah UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang digunakan untuk operasi ini. |
Header Permintaan
| Nama | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
Nilai GUID yang dihasilkan klien yang mengidentifikasi permintaan ini. Jika ditentukan, ini akan disertakan dalam informasi respons sebagai cara untuk melacak permintaan. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Operasi Azure berhasil diselesaikan. |
|
| Other Status Codes |
Respons kesalahan tak terduga. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
| Nama | Deskripsi |
|---|---|
| user_impersonation | meniru akun pengguna Anda |
Contoh
SearchGetAdminKeys
Permintaan sampel
Respon sampel
{
"primaryKey": "<your primary admin API key>",
"secondaryKey": "<your secondary admin API key>"
}
Definisi
| Nama | Deskripsi |
|---|---|
|
Admin |
Respons yang berisi kunci API admin utama dan sekunder untuk layanan Pencarian Azure AI tertentu. |
|
Cloud |
Berisi informasi tentang kesalahan API. |
|
Cloud |
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan. |
AdminKeyResult
Respons yang berisi kunci API admin utama dan sekunder untuk layanan Pencarian Azure AI tertentu.
| Nama | Jenis | Deskripsi |
|---|---|---|
| primaryKey |
string |
Kunci API admin utama layanan pencarian. |
| secondaryKey |
string |
Kunci API admin sekunder dari layanan pencarian. |
CloudError
Berisi informasi tentang kesalahan API.
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan. |
|
| message |
string |
Deskripsi singkat tentang kesalahan yang mengisyaratkan apa yang salah (untuk informasi detail/penelusuran kesalahan merujuk ke properti 'error.message'). |
CloudErrorBody
Menjelaskan kesalahan API tertentu dengan kode kesalahan dan pesan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| code |
string |
Kode kesalahan yang menjelaskan kondisi kesalahan lebih tepat daripada kode status HTTP. Dapat digunakan untuk menangani kasus kesalahan tertentu secara terprogram. |
| details |
Berisi kesalahan berlapis yang terkait dengan kesalahan ini. |
|
| message |
string |
Pesan yang menjelaskan kesalahan secara rinci dan menyediakan informasi penelusuran kesalahan. |
| target |
string |
Target kesalahan tertentu (misalnya, nama properti dalam kesalahan). |