다음을 통해 공유


Private Link Resources - List By Server

SQL Server에 대한 프라이빗 링크 리소스를 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/privateLinkResources?api-version=2025-01-01

URI 매개 변수

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

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.

serverName
path True

string

서버의 이름입니다.

subscriptionId
path True

string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True

string

요청에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

PrivateLinkResourceListResult

프라이빗 링크 리소스를 성공적으로 검색했습니다.

Other Status Codes

ErrorResponse

오류 응답: ***

  • 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다.

  • 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다.

  • 400 TokenTooLong - 제공된 토큰이 너무 깁니다.

  • 404 OperationIdNotFound - ID가 있는 작업이 없습니다.

  • 404 OperationIdNotFound - ID가 있는 작업이 없습니다.

  • 409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다.

  • 409 OperationCancelled - 사용자가 작업을 취소했습니다.

  • 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.

  • 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.

  • 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

샘플 요청

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/test-svr/privateLinkResources?api-version=2025-01-01

샘플 응답

{
  "value": [
    {
      "id": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/test-svr/privateLinkResources/plr",
      "name": "plr",
      "type": "Microsoft.Sql/servers/privateLinkResources",
      "properties": {
        "groupId": "sqlServer",
        "requiredMembers": [
          "sqlServer"
        ]
      }
    }
  ]
}

정의

Name Description
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

PrivateLinkResource

프라이빗 링크 리소스

PrivateLinkResourceListResult

프라이빗 링크 리소스 목록

PrivateLinkResourceProperties

프라이빗 링크 리소스의 속성입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

PrivateLinkResource

프라이빗 링크 리소스

Name 형식 Description
id

string

리소스 ID입니다.

name

string

리소스 이름입니다.

properties

PrivateLinkResourceProperties

프라이빗 링크 리소스 그룹 ID입니다.

type

string

리소스 종류입니다.

PrivateLinkResourceListResult

프라이빗 링크 리소스 목록

Name 형식 Description
nextLink

string

결과의 다음 페이지를 검색하는 링크입니다.

value

PrivateLinkResource[]

결과 배열입니다.

PrivateLinkResourceProperties

프라이빗 링크 리소스의 속성입니다.

Name 형식 Description
groupId

string

프라이빗 링크 리소스 그룹 ID입니다.

requiredMembers

string[]

프라이빗 링크 리소스에는 멤버 이름이 필요합니다.

requiredZoneNames

string[]

프라이빗 링크 리소스에는 영역 이름이 필요합니다.