Cluster Managers - Update Relay Private Endpoint Connection

Usługa:

Operator Nexus - Network Cloud

Wersja interfejsu API:

2026-01-01-preview

Zaktualizuj prywatne połączenie końcowe dla przestrzeni nazw Azure Relay zarządzanej przez wskazanego menedżera klastra. Użyj tej operacji, aby zatwierdzić lub odrzucić oczekujące żądanie połączenia prywatnego punktu końcowego dla przestrzeni nazw relay zarządzanej przez menedżera klastra.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
clusterManagerName	path	True	string pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$	Nazwa menedżera klastra.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
connectionState	True	RelayPrivateEndpointConnectionState	Stan ustawiany dla połączenia prywatnego punktu końcowego.
privateEndpointResourceId	True	string (arm-id)	Identyfikator zasobu prywatnego punktu końcowego, któremu należy zezwolić lub odmówić połączenia z przestrzenią nazw relay.
description		string	Opis ma skojarzyć się z prywatnym połączeniem końcowym.

Odpowiedzi

Nazwa	Typ	Opis
202 Accepted		Zaakceptowano operację zasobu. Nagłówki Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Approve private endpoint connection

Reject private endpoint connection

Approve private endpoint connection

Przykładowe żądanie

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"
}

Przykładowa odpowiedź

Kod stanu:

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

Przykładowe żądanie

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"
}

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
ClusterManagerUpdateRelayPrivateEndpointConnectionParameters	ClusterManagerUpdateRelayPrivateEndpointConnectionParameters reprezentuje treść żądania o zatwierdzenie lub odrzucenie prywatnego połączenia przekaźnika dla prywatnego przekaźnika zarządzanego przez menedżera klastra.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
RelayPrivateEndpointConnectionState	Stan ustawiany dla połączenia prywatnego punktu końcowego.

ClusterManagerUpdateRelayPrivateEndpointConnectionParameters

Objekt

ClusterManagerUpdateRelayPrivateEndpointConnectionParameters reprezentuje treść żądania o zatwierdzenie lub odrzucenie prywatnego połączenia przekaźnika dla prywatnego przekaźnika zarządzanego przez menedżera klastra.

Nazwa	Typ	Opis
connectionState	RelayPrivateEndpointConnectionState	Stan ustawiany dla połączenia prywatnego punktu końcowego.
description	string	Opis ma skojarzyć się z prywatnym połączeniem końcowym.
privateEndpointResourceId	string (arm-id)	Identyfikator zasobu prywatnego punktu końcowego, któremu należy zezwolić lub odmówić połączenia z przestrzenią nazw relay.

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

RelayPrivateEndpointConnectionState

Wyliczenie

Stan ustawiany dla połączenia prywatnego punktu końcowego.

Wartość	Opis
Approved	Prywatne połączenie z punktem końcowym zostaje zatwierdzone.
Rejected	Prywatne połączenie z punktem końcowym zostaje odrzucone.