Cluster Managers - Update Relay Private Endpoint Connection

Serviço:: Operator Nexus - Network Cloud

Versão da API:: 2026-07-01

Atualize a ligação privada ao endpoint para o namespace Azure Relay gerido pelo gestor de cluster especificado. Use esta operação para aprovar ou rejeitar um pedido pendente de ligação a endpoint privado para o namespace de relés gerido pelo gestor do cluster.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusterManagers/{clusterManagerName}/updateRelayPrivateEndpointConnection?api-version=2026-07-01

Parâmetros do URI

Name	Em	Obrigatório	Tipo	Descrição
clusterManagerName	path	True	string pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$	O nome do gerenciador de cluster.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	O ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Obrigatório	Tipo	Descrição
connectionState	True	RelayPrivateEndpointConnectionState	O estado a definir para a ligação ao endpoint privado.
privateEndpointResourceId	True	string (arm-id)	O ID do recurso do endpoint privado para ser permitido ou negado a ligação ao namespace do relé.
description		string	A descrição a associar à ligação do endpoint privado.

Respostas

Name	Tipo	Descrição
202 Accepted		Operação de recurso aceita. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Name

Tipo

Descrição

202 Accepted

Operação de recurso aceita.

Cabeçalhos

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Descrição
user_impersonation	assumir a identidade da sua conta de utilizador

Exemplos

Approve private endpoint connection

Reject private endpoint connection

Approve private endpoint connection

Pedido de amostra

HTTP

POST https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusterManagers/clusterManagerName/updateRelayPrivateEndpointConnection?api-version=2026-07-01

{
  "connectionState": "Approved",
  "description": "Approving private endpoint connection",
  "privateEndpointResourceId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.Network/privateEndpoints/privateEndpointName"
}

Resposta da amostra

Código de estado:: 202

Location: https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/locations/location/operationStatuses/operationId?api-version=2026-07-01

Reject private endpoint connection

Pedido de amostra

HTTP

POST https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusterManagers/clusterManagerName/updateRelayPrivateEndpointConnection?api-version=2026-07-01

{
  "connectionState": "Rejected",
  "description": "Rejecting private endpoint connection",
  "privateEndpointResourceId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.Network/privateEndpoints/privateEndpointName"
}

Resposta da amostra

Código de estado:: 202

Location: https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/locations/location/operationStatuses/operationId?api-version=2026-07-01

Definições

Name	Descrição
ClusterManagerUpdateRelayPrivateEndpointConnectionParameters	ClusterManagerUpdateRelayPrivateEndpointConnectionParameters representa o corpo do pedido para aprovar ou rejeitar a ligação ao endpoint privado do relé para o relé privado gerido por um gestor de cluster.
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
RelayPrivateEndpointConnectionState	O estado a definir para a ligação ao endpoint privado.

ClusterManagerUpdateRelayPrivateEndpointConnectionParameters

Object

ClusterManagerUpdateRelayPrivateEndpointConnectionParameters representa o corpo do pedido para aprovar ou rejeitar a ligação ao endpoint privado do relé para o relé privado gerido por um gestor de cluster.

Name	Tipo	Descrição
connectionState	RelayPrivateEndpointConnectionState	O estado a definir para a ligação ao endpoint privado.
description	string	A descrição a associar à ligação do endpoint privado.
privateEndpointResourceId	string (arm-id)	O ID do recurso do endpoint privado para ser permitido ou negado a ligação ao namespace do relé.

ErrorAdditionalInfo

Object

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Descrição
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O alvo do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

RelayPrivateEndpointConnectionState

Enumeração

O estado a definir para a ligação ao endpoint privado.

Valor	Descrição
Approved	A ligação ao endpoint privado está aprovada.
Rejected	A ligação ao endpoint privado é rejeitada.