Admin Keys - Regenerate
Birincil veya ikincil yönetici API anahtarını yeniden oluşturur. Aynı anda yalnızca bir anahtar yeniden oluşturabilirsiniz.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/regenerateAdminKey/{keyKind}?api-version=2023-11-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
key
|
path | True |
Yeniden oluşturulacak anahtarı belirtir. Geçerli değerler 'birincil' ve 'ikincil' değerlerini içerir. |
|
resource
|
path | True |
string |
Geçerli abonelik içindeki kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz. |
search
|
path | True |
string |
Belirtilen kaynak grubuyla ilişkili arama hizmetinin adı. |
subscription
|
path | True |
string |
Microsoft Azure aboneliğinin benzersiz tanımlayıcısı. Bu değeri Azure Resource Manager API'sinden, komut satırı araçlarından 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 GUID değeri. Belirtilirse, isteği izlemenin bir yolu olarak yanıt bilgilerine eklenir. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Belirtilen yönetici anahtarı başarıyla yeniden oluşturuldu. Her iki yönetici anahtarı da yeni oluşturulan anahtar dahil olmak üzere yanıta dahil edilir. |
|
Other Status Codes |
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
OAuth2 yetkilendirme akışını Microsoft Entra ID.
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
SearchRegenerateAdminKey
Örnek isteği
Örnek yanıt
{
"primaryKey": "<your primary admin API key>",
"secondaryKey": "<your secondary admin API key>"
}
Tanımlar
Name | Description |
---|---|
Admin |
Yeniden oluşturulacak anahtarı belirtir. Geçerli değerler 'birincil' ve 'ikincil' değerlerini içerir. |
Admin |
Belirli bir arama hizmeti için birincil ve ikincil yönetici API anahtarlarını içeren yanıt. |
Cloud |
API hatası hakkında bilgi içerir. |
Cloud |
Hata kodu ve ileti içeren belirli bir API hatası açıklanır. |
AdminKeyKind
Yeniden oluşturulacak anahtarı belirtir. Geçerli değerler 'birincil' ve 'ikincil' değerlerini içerir.
Name | Tür | Description |
---|---|---|
primary |
string |
Arama hizmetinin birincil API anahtarı. |
secondary |
string |
Arama hizmeti için ikincil API anahtarı. |
AdminKeyResult
Belirli bir arama 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
API hatası hakkında bilgi içerir.
Name | Tür | Description |
---|---|---|
error |
Hata kodu ve ileti içeren belirli bir API hatası açıklanır. |
CloudErrorBody
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 |
Bu hatayla ilgili iç içe 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ı). |