Private Endpoint Connections - Update
Verilen kaynak grubundaki arama hizmetine özel uç nokta bağlantısı Güncelleştirmeler.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2024-03-01-preview
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
private
|
path | True |
string |
Belirtilen kaynak grubuyla Azure AI Arama hizmeti özel uç nokta bağlantısının adı. |
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 Azure AI Arama hizmeti adı. Normal ifade deseni: |
subscription
|
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 GUID değeri. Belirtilirse, isteği izlemenin bir yolu olarak yanıt bilgilerine eklenir. |
İstek Gövdesi
Name | Tür | Description |
---|---|---|
properties |
Azure AI Arama hizmeti mevcut özel uç nokta bağlantısının özelliklerini açıklar. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Mevcut özel uç nokta bağlantı tanımı başarıyla güncelleştirildi. |
|
Other Status Codes |
HTTP 400 (Hatalı İstek): Verilen özel uç nokta bağlantı adı veya özel uç nokta bağlantı tanımı geçersiz. Ayrıntılar için yanıttaki hata koduna ve iletiye bakın. HTTP 404 (Bulunamadı): Abonelik, kaynak grubu, arama hizmeti veya özel uç nokta bağlantısı 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
PrivateEndpointConnectionUpdate
Örnek isteği
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/privateEndpointConnections/testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546?api-version=2024-03-01-preview
{
"properties": {
"privateLinkServiceConnectionState": {
"status": "Rejected",
"description": "Rejected for some reason."
}
}
}
Örnek yanıt
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/privateEndpointConnections/testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546",
"name": "testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546",
"type": "Microsoft.Search/searchServices/privateEndpointConnections",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/privateEndpoints/testEndpoint"
},
"privateLinkServiceConnectionState": {
"status": "Rejected",
"description": "Rejected for some reason.",
"actionsRequired": "None"
}
}
}
Tanımlar
Name | Description |
---|---|
Cloud |
API hatası hakkında bilgi içerir. |
Cloud |
Hata kodu ve ileti içeren belirli bir API hatası açıklanır. |
Private |
Microsoft.Network sağlayıcısından özel uç nokta kaynağı. |
Private |
Azure AI Arama hizmeti mevcut özel uç nokta bağlantısını açıklar. |
Private |
Arama hizmetine var olan bir özel uç nokta bağlantısının özelliklerini açıklar. |
Private |
Özel bağlantı hizmeti bağlantısının sağlama durumu. Geçerli değerler Güncelleştirme, Silme, Başarısız, Başarılı, Tamamlanmadı veya İptal Edildi değerleridir. |
Private |
Özel uç noktaya var olan bir Azure Özel Bağlantı hizmeti bağlantısının geçerli durumunu açıklar. |
Private |
Özel bağlantı hizmeti bağlantısının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir. |
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. |
|
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
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ı). |
PrivateEndpoint
Microsoft.Network sağlayıcısından özel uç nokta kaynağı.
Name | Tür | Description |
---|---|---|
id |
string |
Microsoft.Network sağlayıcısından gelen özel uç nokta kaynağının kaynak kimliği. |
PrivateEndpointConnection
Azure AI Arama hizmeti mevcut özel uç nokta bağlantısını açıklar.
Name | Tür | Description |
---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Kaynağın adı |
properties |
Azure AI Arama hizmeti mevcut özel uç nokta bağlantısının özelliklerini açıklar. |
|
type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProperties
Arama hizmetine var olan bir özel uç nokta bağlantısının özelliklerini açıklar.
Name | Tür | Description |
---|---|---|
groupId |
string |
Özel bağlantı hizmetinin ait olduğu Azure kaynağının grup kimliği. |
privateEndpoint |
Microsoft.Network sağlayıcısından özel uç nokta kaynağı. |
|
privateLinkServiceConnectionState |
Özel uç noktaya var olan bir Azure Özel Bağlantı hizmeti bağlantısının geçerli durumunu açıklar. |
|
provisioningState |
Özel bağlantı hizmeti bağlantısının sağlama durumu. Geçerli değerler Güncelleştirme, Silme, Başarısız, Başarılı, Tamamlanmadı veya İptal Edildi değerleridir. |
PrivateLinkServiceConnectionProvisioningState
Özel bağlantı hizmeti bağlantısının sağlama durumu. Geçerli değerler Güncelleştirme, Silme, Başarısız, Başarılı, Tamamlanmadı veya İptal Edildi değerleridir.
Name | Tür | Description |
---|---|---|
Canceled |
string |
Özel bağlantı hizmeti bağlantı kaynağı için sağlama isteği iptal edildi. |
Deleting |
string |
Özel bağlantı hizmeti bağlantısı siliniyor. |
Failed |
string |
Özel bağlantı hizmeti bağlantısı sağlanamadı veya silinemedi. |
Incomplete |
string |
Özel bağlantı hizmeti bağlantı kaynağı için sağlama isteği kabul edildi, ancak oluşturma işlemi henüz başlamadı. |
Succeeded |
string |
Özel bağlantı hizmeti bağlantısı sağlamayı tamamladı ve onay için hazır. |
Updating |
string |
Özel bağlantı hizmeti bağlantısı, tamamen işlevsel olması için diğer kaynaklarla birlikte oluşturulma aşamasındadır. |
PrivateLinkServiceConnectionState
Özel uç noktaya var olan bir Azure Özel Bağlantı hizmeti bağlantısının geçerli durumunu açıklar.
Name | Tür | Default value | Description |
---|---|---|---|
actionsRequired |
string |
None |
Gerekli olabilecek ek eylemlerin açıklaması. |
description |
string |
Özel bağlantı hizmeti bağlantı durumunun açıklaması. |
|
status |
Özel bağlantı hizmeti bağlantısının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir. |
PrivateLinkServiceConnectionStatus
Özel bağlantı hizmeti bağlantısının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir.
Name | Tür | Description |
---|---|---|
Approved |
string |
Özel uç nokta bağlantısı onaylandı ve kullanıma hazır. |
Disconnected |
string |
Özel uç nokta bağlantısı hizmetten kaldırıldı. |
Pending |
string |
Özel uç nokta bağlantısı oluşturuldu ve onay bekliyor. |
Rejected |
string |
Özel uç nokta bağlantısı reddedildi ve kullanılamaz. |