Managed Private Endpoints - Create Workspace Managed Private Endpoint
지정된 작업 영역에 관리형 프라이빗 엔드포인트를 만듭니다.
비고
이 API는 미리 보기 릴리스의 일부이며 평가 및 개발 목적으로만 제공됩니다. 피드백에 따라 변경 될 수 있으며 프로덕션 사용에는 권장되지 않습니다.
Permissions
호출자에게는 관리자 작업 영역 역할이 있어야 합니다.
필요한 위임된 범위
Workspace.ReadWrite.All.
Limitations
- 관리되는 프라이빗 엔드포인트를 만들려면 작업 영역이 지원되는 패브릭 용량에 있어야 합니다. 자세한 내용은 다음을 참조하세요. Microsoft Fabric 라이선스 유형.
Microsoft Entra 지원 ID
이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.
| Identity | Support |
|---|---|
| User | Yes |
| 서비스 주체 및 관리 ID | Yes |
Interface
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/managedPrivateEndpointsURI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
작업 영역 ID입니다. |
요청 본문
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| name | True |
string |
프라이빗 엔드포인트 이름입니다. 64자를 초과하면 안 됩니다. |
| targetPrivateLinkResourceId | True |
string |
프라이빗 엔드포인트를 만들어야 하는 데이터 원본의 리소스 ID입니다. |
| requestMessage |
string |
프라이빗 엔드포인트 요청을 승인하는 메시지입니다. 140자를 초과하면 안 됩니다. |
|
| targetFQDNs |
string[] |
프라이빗 엔드포인트와 연결할 FQDN(정규화된 도메인 이름)입니다. FQDN이 20개 이상일 수 없습니다. |
|
| targetSubresourceType |
string |
Private-link 리소스를 가리키는 하위 리소스입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 201 Created |
요청이 성공적으로 완료되었습니다. 헤더 Location: string |
|
| Other Status Codes |
일반적인 오류 코드:
|
예제
Create a managed private endpoint example
샘플 요청
POST https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/managedPrivateEndpoints
{
"name": "testprivatendpoint1",
"targetPrivateLinkResourceId": "/subscriptions/2374e587-d28b-4898-a39c-6070e078ae31/resourceGroups/testrg/providers/Microsoft.Sql/servers/testsql1",
"targetSubresourceType": "sqlServer",
"requestMessage": "Request message to approve private endpoint"
}
샘플 응답
Location: https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/managedPrivateEndpoints/59a92b06-6e5a-468c-b748-e28c8ff28da3{
"id": "59a92b06-6e5a-468c-b748-e28c8ff28da3",
"name": "SqlPE",
"targetPrivateLinkResourceId": "/subscriptions/e3bf3f1a-4d64-4e42-85e9-aa1b84e3874/resourceGroups/testRG/providers/Microsoft.SqlServer/SqlServer/sql1",
"provisioningState": "Provisioning",
"targetSubresourceType": "sqlServer"
}정의
| Name | Description |
|---|---|
|
Connection |
프라이빗 엔드포인트 연결 상태입니다. 시간이 지남에 따라 추가 연결 상태가 추가될 수 있습니다. |
|
Create |
관리되는 프라이빗 엔드포인트 요청 페이로드를 만듭니다. |
|
Error |
오류 관련 리소스 세부 정보 개체입니다. |
|
Error |
오류 응답입니다. |
|
Error |
오류 응답 세부 정보입니다. |
|
Managed |
관리되는 프라이빗 엔드포인트. |
|
Private |
프라이빗 엔드포인트 연결 상태 |
|
Private |
엔드포인트의 프로비전 상태입니다. |
ConnectionStatus
프라이빗 엔드포인트 연결 상태입니다. 시간이 지남에 따라 추가 연결 상태가 추가될 수 있습니다.
| 값 | Description |
|---|---|
| Pending |
승인 보류 중 |
| Approved |
승인된 엔드포인트 |
| Rejected |
엔드포인트가 거부됨 |
| Disconnected |
엔드포인트 연결이 끊어졌습니다. |
CreateManagedPrivateEndpointRequest
관리되는 프라이빗 엔드포인트 요청 페이로드를 만듭니다.
| Name | 형식 | Description |
|---|---|---|
| name |
string |
프라이빗 엔드포인트 이름입니다. 64자를 초과하면 안 됩니다. |
| requestMessage |
string |
프라이빗 엔드포인트 요청을 승인하는 메시지입니다. 140자를 초과하면 안 됩니다. |
| targetFQDNs |
string[] |
프라이빗 엔드포인트와 연결할 FQDN(정규화된 도메인 이름)입니다. FQDN이 20개 이상일 수 없습니다. |
| targetPrivateLinkResourceId |
string |
프라이빗 엔드포인트를 만들어야 하는 데이터 원본의 리소스 ID입니다. |
| targetSubresourceType |
string |
Private-link 리소스를 가리키는 하위 리소스입니다. |
ErrorRelatedResource
오류 관련 리소스 세부 정보 개체입니다.
| Name | 형식 | Description |
|---|---|---|
| resourceId |
string |
오류와 관련된 리소스 ID입니다. |
| resourceType |
string |
오류와 관련된 리소스의 형식입니다. |
ErrorResponse
오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| errorCode |
string |
오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다. |
| message |
string |
사용자가 읽을 수 있는 오류 표현입니다. |
| moreDetails |
추가 오류 세부 정보 목록입니다. |
|
| relatedResource |
오류 관련 리소스 세부 정보입니다. |
|
| requestId |
string |
오류와 연결된 요청의 ID입니다. |
ErrorResponseDetails
오류 응답 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| errorCode |
string |
오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다. |
| message |
string |
사용자가 읽을 수 있는 오류 표현입니다. |
| relatedResource |
오류 관련 리소스 세부 정보입니다. |
ManagedPrivateEndpoint
관리되는 프라이빗 엔드포인트.
| Name | 형식 | Description |
|---|---|---|
| connectionState |
프로비전된 엔드포인트의 엔드포인트 연결 상태입니다. |
|
| id |
string (uuid) |
관리되는 프라이빗 엔드포인트 ID입니다. |
| name |
string |
프라이빗 엔드포인트 이름입니다. |
| provisioningState |
엔드포인트의 프로비전 상태입니다. |
|
| targetPrivateLinkResourceId |
string |
프라이빗 엔드포인트가 만들어지는 데이터 원본의 리소스 ID |
| targetSubresourceType |
string |
Private-link 리소스를 가리키는 하위 리소스입니다. |
PrivateEndpointConnectionState
프라이빗 엔드포인트 연결 상태
| Name | 형식 | Description |
|---|---|---|
| actionsRequired |
string |
연결을 설정하는 데 필요한 작업입니다. |
| description |
string |
엔드포인트를 승인하거나 거부할 때 제공된 설명 메시지(있는 경우)입니다. |
| status |
연결 상태 |
PrivateEndpointProvisioningState
엔드포인트의 프로비전 상태입니다.
| 값 | Description |
|---|---|
| Provisioning |
프로비전의 프라이빗 엔드포인트가 진행 중입니다. |
| Succeeded |
프라이빗 엔드포인트 프로비전 성공 |
| Updating |
프라이빗 엔드포인트 업데이트 |
| Deleting |
프라이빗 엔드포인트 삭제 |
| Failed |
프라이빗 엔드포인트 프로비저닝 실패 |