Private Endpoint Connections - Update

Служба:

AKS

Версия API:

2025-05-01

Обновляет подключение к частной конечной точке.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2025-05-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
privateEndpointConnectionName	path	True	string	Имя подключения частной конечной точки.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не зависит от регистра.
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	Имя ресурса управляемого кластера.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Обязательно	Тип	Описание
properties.privateLinkServiceConnectionState	True	PrivateLinkServiceConnectionState	Коллекция сведений о состоянии подключения между потребителем службы и поставщиком.
properties.privateEndpoint		PrivateEndpoint	Ресурс частной конечной точки.

Ответы

Имя	Тип	Описание
200 OK	PrivateEndpointConnection	Существующее подключение к частной конечной точке успешно обновлено.
201 Created	PrivateEndpointConnection	Новое подключение к частной конечной точке успешно создано.
Other Status Codes	CloudError	Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Update Private Endpoint Connection

Образец запроса

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/privateEndpointConnections/privateendpointconnection1?api-version=2025-05-01

{
  "properties": {
    "privateLinkServiceConnectionState": {
      "status": "Approved"
    }
  }
}

Пример ответа

Код состояния:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedCluster/clustername1/privateEndpointConnections/privateendpointconnection1",
  "name": "privateendpointconnection1",
  "type": "Microsoft.Network/privateLinkServices/privateEndpointConnections",
  "properties": {
    "privateEndpoint": {
      "id": "/subscriptions/subid2/resourceGroups/rg2/providers/Microsoft.Network/privateEndpoints/pe2"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved"
    },
    "provisioningState": "Succeeded"
  }
}

Код состояния:

201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedCluster/clustername1/privateEndpointConnections/privateendpointconnection1",
  "name": "privateendpointconnection1",
  "type": "Microsoft.Network/privateLinkServices/privateEndpointConnections",
  "properties": {
    "privateEndpoint": {
      "id": "/subscriptions/subid2/resourceGroups/rg2/providers/Microsoft.Network/privateEndpoints/pe2"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved"
    },
    "provisioningState": "Succeeded"
  }
}

Определения

Имя	Описание
CloudError	Ответ об ошибке службы контейнеров.
CloudErrorBody	Ответ об ошибке службы контейнеров.
ConnectionStatus	Состояние подключения службы приватного канала.
PrivateEndpoint	Частная конечная точка, к которой принадлежит подключение.
PrivateEndpointConnection	Подключение к частной конечной точке
PrivateEndpointConnectionProvisioningState	Текущее состояние подготовки.
PrivateLinkServiceConnectionState	Состояние подключения службы приватного канала.

CloudError

Object

Ответ об ошибке службы контейнеров.

Имя	Тип	Описание
error	CloudErrorBody	Сведения об ошибке.

CloudErrorBody

Object

Ответ об ошибке службы контейнеров.

Имя	Тип	Описание
code	string	Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
details	CloudErrorBody[]	Список дополнительных сведений об ошибке.
message	string	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
target	string	Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

ConnectionStatus

Перечисление

Состояние подключения службы приватного канала.

Значение	Описание
Approved
Disconnected
Pending
Rejected

PrivateEndpoint

Object

Частная конечная точка, к которой принадлежит подключение.

Имя	Тип	Описание
id	string	Идентификатор ресурса частной конечной точки

PrivateEndpointConnection

Object

Подключение к частной конечной точке

Имя	Тип	Описание
id	string	Идентификатор подключения частной конечной точки.
name	string	Имя подключения частной конечной точки.
properties.privateEndpoint	PrivateEndpoint	Ресурс частной конечной точки.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Коллекция сведений о состоянии подключения между потребителем службы и поставщиком.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Текущее состояние подготовки.
type	string	Тип ресурса.

PrivateEndpointConnectionProvisioningState

Перечисление

Текущее состояние подготовки.

Значение	Описание
Canceled
Creating
Deleting
Failed
Succeeded

PrivateLinkServiceConnectionState

Object

Состояние подключения службы приватного канала.

Имя	Тип	Описание
description	string	Описание подключения службы приватного канала.
status	ConnectionStatus	Состояние подключения службы приватного канала.