Admin Keys - Get

Hizmet:: Search Management

API Sürümü:: 2024-03-01-preview

Belirtilen Azure AI Search hizmeti için birincil ve ikincil yönetici API anahtarlarını alır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string	Geçerli abonelik içindeki kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
searchServiceName	path	True	string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$	Belirtilen kaynak grubuyla ilişkili Azure AI Search hizmetinin adı.
subscriptionId	path	True	string	Microsoft Azure aboneliğinin benzersiz tanımlayıcısı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
api-version	query	True	string	Her istek için kullanılacak API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-request-id		string (uuid)	Bu isteği tanımlayan istemci tarafından oluşturulan BIR GUID değeri. Belirtilirse, isteği izlemenin bir yolu olarak yanıt bilgilerine eklenir.

Yanıtlar

Name	Tür	Description
200 OK	AdminKeyResult	Yönetici anahtarları başarıyla alındı ve yanıtta yer alır. Arama hizmetinizde ayrıcalıklı işlemler de dahil olmak üzere tüm işlemleri gerçekleştirmek için Azure AI Search hizmeti REST API veya SDK'sında 'api-key' parametresinin değeri olarak birincil veya ikincil anahtarı kullanabilirsiniz. Ayrıcalıklı işlemler dizinler ve veri kaynakları gibi kaynakları yönetmenin yanı sıra dizinlerinizdeki verileri karşıya yükleme, değiştirme veya silme işlemlerini içerir.
Other Status Codes	CloudError	HTTP 404 (Bulunamadı): Abonelik, kaynak grubu veya arama hizmeti bulunamadı. HTTP 409 (Çakışma): Belirtilen abonelik devre dışı bırakıldı.

Güvenlik

azure_auth

Microsoft Identity platformunda desteklendiği gibi örtük bir verme akışı belirtir.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

SearchGetAdminKeys

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 200

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

Tanımlar

Name	Description
AdminKeyResult	Belirli bir Azure AI Search hizmeti için birincil ve ikincil yönetici API anahtarlarını içeren yanıt.
CloudError	API hatası hakkında bilgi içerir.
CloudErrorBody	Hata kodu ve ileti içeren belirli bir API hatası açıklanır.

AdminKeyResult

Nesne

Belirli bir Azure AI Search hizmeti için birincil ve ikincil yönetici API anahtarlarını içeren yanıt.

Name	Tür	Description
primaryKey	string	Arama hizmetinin birincil yönetici API anahtarı.
secondaryKey	string	Arama hizmetinin ikincil yönetici API anahtarı.

CloudError

Nesne

API hatası hakkında bilgi içerir.

Name	Tür	Description
error	CloudErrorBody	Hata kodu ve ileti içeren belirli bir API hatası açıklanır.
message	string	Neyin yanlış gittiğini gösteren hatanın kısa bir açıklaması (ayrıntılar/hata ayıklama bilgileri için 'error.message' özelliğine bakın).

CloudErrorBody

Nesne

Hata kodu ve ileti içeren belirli bir API hatası açıklanır.

Name	Tür	Description
code	string	Http durum kodundan daha kesin bir şekilde hata koşulunu açıklayan bir hata kodu. Belirli hata durumlarını program aracılığıyla işlemek için kullanılabilir.
details	CloudErrorBody[]	Bu hatayla ilgili iç içe yerleştirilmiş hatalar içerir.
message	string	Hatayı ayrıntılı olarak açıklayan ve hata ayıklama bilgileri sağlayan bir ileti.
target	string	Belirli bir hatanın hedefi (örneğin, hatadaki özelliğin adı).