Partilhar via

Cluster Managers - Update Relay Private Endpoint Connection

Serviço:
Operator Nexus - Network Cloud
Versão da API:
2026-01-01-preview

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-01-01-preview

Parâmetros do URI

Name Em Necessá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 um UUID.
api-version
 query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Corpo do Pedido

Name Necessário Tipo Description
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 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
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

Approve private endpoint connection
Reject private endpoint connection

Approve private endpoint connection

Pedido de amostra

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 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-01-01-preview

Reject private endpoint connection

Pedido de amostra

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 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-01-01-preview

Definições

Name Description
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

O erro de gerenciamento de recursos informações adicionais.
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 Description
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

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
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

Object

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

RelayPrivateEndpointConnectionState

Enumeração

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

Valor Description
Approved

A ligação ao endpoint privado está aprovada.
Rejected

A ligação ao endpoint privado é rejeitada.