Cluster Managers - Update Relay Private Endpoint Connection

Serviço:

Operator Nexus - Network Cloud

Versão da API:

2026-01-01-preview

Atualize a conexão do endpoint privado para o namespace Azure Relay gerenciado pelo gerenciador de cluster especificado. Use essa operação para aprovar ou rejeitar uma solicitação pendente de conexão de endpoint privado para o namespace de relé gerenciado pelo gerenciador do cluster.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
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)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
connectionState	True	RelayPrivateEndpointConnectionState	O estado a ser definido para a conexão de endpoint privado.
privateEndpointResourceId	True	string (arm-id)	O ID do recurso do endpoint privado para ser permitido ou negado na conexão com o namespace do relé.
description		string	A descrição para associar à conexão do endpoint privado.

Respostas

Nome	Tipo	Description
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

Azure Active Directory OAuth2 Flow.

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Approve private endpoint connection

Reject private endpoint connection

Approve private endpoint connection

Solicitação de exemplo

HTTP

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

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

Resposta de exemplo

Código de status:

202

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

Reject private endpoint connection

Solicitação de exemplo

HTTP

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

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

Resposta de exemplo

Código de status:

202

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

Definições

Nome	Description
ClusterManagerUpdateRelayPrivateEndpointConnectionParameters	ClusterManagerUpdateRelayPrivateEndpointConnectionParameters representa o corpo da solicitação para aprovar ou rejeitar a conexão do endpoint privado do relé para o relé privado gerenciado por um gerenciador de cluster.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
RelayPrivateEndpointConnectionState	O estado a ser definido para a conexão de endpoint privado.

ClusterManagerUpdateRelayPrivateEndpointConnectionParameters

Objeto

ClusterManagerUpdateRelayPrivateEndpointConnectionParameters representa o corpo da solicitação para aprovar ou rejeitar a conexão do endpoint privado do relé para o relé privado gerenciado por um gerenciador de cluster.

Nome	Tipo	Description
connectionState	RelayPrivateEndpointConnectionState	O estado a ser definido para a conexão de endpoint privado.
description	string	A descrição para associar à conexão do endpoint privado.
privateEndpointResourceId	string (arm-id)	O ID do recurso do endpoint privado para ser permitido ou negado na conexão com o namespace do relé.

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

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

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
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 destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

RelayPrivateEndpointConnectionState

Enumeração

O estado a ser definido para a conexão de endpoint privado.

Valor	Description
Approved	A conexão do endpoint privado é aprovada.
Rejected	A conexão do endpoint privado é rejeitada.