Private Endpoint Connections - Update

Hizmet:: Search Management

API Sürümü:: 2026-11-01

Belirli bir kaynak grubundaki arama hizmetine özel uç nokta bağlantısını güncelleştirir.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2026-11-01

URI Parametreleri

Veri Akışı Adı	İçinde	Gerekli	Tür	Description
privateEndpointConnectionName	path	True	string	Belirtilen kaynak grubuyla Azure Yapay Zeka Arama hizmetine özel uç nokta bağlantısının adı.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
searchServiceName	path	True	string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$	Belirtilen kaynak grubuyla ilişkili Azure Yapay Zeka Arama hizmetinin adı.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Başlığı

Veri Akışı Adı	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.

İstek Gövdesi

Veri Akışı Adı	Tür	Description
properties	PrivateEndpointConnectionProperties	Azure Yapay Zeka Arama hizmetine var olan özel uç nokta bağlantısının özelliklerini açıklar.

Yanıtlar

Veri Akışı Adı	Tür	Description
200 OK	PrivateEndpointConnection	Kaynak 'PrivateEndpointConnection' güncelleştirme işlemi başarılı oldu
Other Status Codes	CloudError	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

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

Kapsamlar

Veri Akışı Adı	Description
user_impersonation	kullanıcı hesabınızı taklit etme

Örnekler

PrivateEndpointConnectionUpdate

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/privateEndpointConnections/testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546?api-version=2026-11-01

{
  "properties": {
    "privateLinkServiceConnectionState": {
      "description": "Rejected for some reason.",
      "status": "Rejected"
    }
  }
}

const { SearchManagementClient } = require("@azure/arm-search");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to updates a private endpoint connection to the search service in the given resource group.
 *
 * @summary updates a private endpoint connection to the search service in the given resource group.
 * x-ms-original-file: 2026-11-01/UpdatePrivateEndpointConnection.json
 */
async function privateEndpointConnectionUpdate() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new SearchManagementClient(credential, subscriptionId);
  const result = await client.privateEndpointConnections.update(
    "rg1",
    "mysearchservice",
    "testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546",
    {
      properties: {
        privateLinkServiceConnectionState: {
          description: "Rejected for some reason.",
          status: "Rejected",
        },
      },
    },
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Örnek yanıt

Durum kodu:: 200

{
  "name": "testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546",
  "type": "Microsoft.Search/searchServices/privateEndpointConnections",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/privateEndpointConnections/testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546",
  "properties": {
    "privateEndpoint": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/privateEndpoints/testEndpoint"
    },
    "privateLinkServiceConnectionState": {
      "description": "Rejected for some reason.",
      "actionsRequired": "None",
      "status": "Rejected"
    }
  }
}

Tanımlar

Veri Akışı Adı	Description
CloudError	API hatası hakkında bilgi içerir.
CloudErrorBody	Hata kodu ve ileti içeren belirli bir API hatası açıklanır.
createdByType	Kaynağı oluşturan kimliğin türü.
PrivateEndpointConnection	Azure Yapay Zeka Arama hizmetine olan mevcut bir özel uç nokta bağlantısını tanımlar.
PrivateEndpointConnectionProperties	Arama hizmetine var olan özel uç nokta bağlantısının özelliklerini açıklar.
PrivateEndpointConnectionPropertiesPrivateEndpoint	Microsoft.Network sağlayıcısından özel uç nokta kaynağı.
PrivateEndpointConnectionPropertiesPrivateLinkServiceConnectionState	Özel uç noktaya var olan bir Azure Özel Bağlantı hizmeti bağlantısının geçerli durumunu açıklar.
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ı, Tamamlanmamış veya İptal Edildi değerleridir.
PrivateLinkServiceConnectionStatus	Özel bağlantı hizmeti bağlantısının durumu. Geçerli değerler Beklemede, Onaylandı, Reddedildi veya Bağlantısı Kesildi şeklindedir.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

CloudError

Nesne

API hatası hakkında bilgi içerir.

Veri Akışı Adı	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.

Veri Akışı Adı	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, hatalı özelliğin adı).

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key