다음을 통해 공유


Private Endpoint Connections - Get

지정된 프라이빗 엔드포인트 연결을 가져옵니다.
프라이빗 클러스터에 대한 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/azure/aks/private-clusters

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
privateEndpointConnectionName
path True

string

프라이빗 엔드포인트 연결의 이름입니다.

resourceGroupName
path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

resourceName
path True

string

관리형 클러스터 리소스의 이름입니다.

regex 패턴: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

subscriptionId
path True

string

uuid

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

PrivateEndpointConnection

정상

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Get Private Endpoint Connection

샘플 요청

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

샘플 응답

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

정의

Name Description
CloudError

컨테이너 서비스의 오류 응답입니다.

CloudErrorBody

컨테이너 서비스의 오류 응답입니다.

ConnectionStatus

프라이빗 링크 서비스 연결 상태.

PrivateEndpoint

연결이 속한 프라이빗 엔드포인트입니다.

PrivateEndpointConnection

프라이빗 엔드포인트 연결

PrivateEndpointConnectionProvisioningState

현재 프로비저닝 상태입니다.

PrivateLinkServiceConnectionState

프라이빗 링크 서비스 연결의 상태입니다.

CloudError

컨테이너 서비스의 오류 응답입니다.

Name 형식 Description
error

CloudErrorBody

오류에 대한 세부 정보입니다.

CloudErrorBody

컨테이너 서비스의 오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.

details

CloudErrorBody[]

오류에 대한 추가 세부 정보 목록입니다.

message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

target

string

특정 오류의 대상입니다. 예를 들어 오류에 있는 속성의 이름입니다.

ConnectionStatus

프라이빗 링크 서비스 연결 상태.

Name 형식 Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PrivateEndpoint

연결이 속한 프라이빗 엔드포인트입니다.

Name 형식 Description
id

string

프라이빗 엔드포인트의 리소스 ID

PrivateEndpointConnection

프라이빗 엔드포인트 연결

Name 형식 Description
id

string

프라이빗 엔드포인트 연결의 ID입니다.

name

string

프라이빗 엔드포인트 연결의 이름입니다.

properties.privateEndpoint

PrivateEndpoint

프라이빗 엔드포인트의 리소스입니다.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

현재 프로비저닝 상태입니다.

type

string

리소스 종류입니다.

PrivateEndpointConnectionProvisioningState

현재 프로비저닝 상태입니다.

Name 형식 Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

PrivateLinkServiceConnectionState

프라이빗 링크 서비스 연결의 상태입니다.

Name 형식 Description
description

string

프라이빗 링크 서비스 연결 설명입니다.

status

ConnectionStatus

프라이빗 링크 서비스 연결 상태.