Managed Private Endpoints - List Workspace Managed Private Endpoints
แสดงรายการจุดปลายทางส่วนตัวที่มีการจัดการที่เชื่อมโยงกับพื้นที่ทํางานที่ระบุ
Note
API นี้เป็นส่วนหนึ่งของการเผยแพร่ตัวอย่าง และมีไว้เพื่อวัตถุประสงค์ในการประเมินและการพัฒนาเท่านั้น ซึ่งอาจเปลี่ยนแปลงตามคําติชมและไม่แนะนําสําหรับการใช้งานด้านการผลิต
Permissions
ผู้เรียกต้องมีบทบาท ของผู้ชม หรือสูงกว่าพื้นที่ทํางาน
จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์
Workspace.Read.All หรือ Workspace.ReadWrite.All
ข้อมูลประจําตัวที่สนับสนุนของ Microsoft Entra
API นี้สนับสนุนข้อมูลประจําตัวของ Microsoft แสดงรายการในส่วนนี้
| Identity | Support |
|---|---|
| User | Yes |
| บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ | Yes |
Interface
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/managedPrivateEndpoints
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/managedPrivateEndpoints?continuationToken={continuationToken}
พารามิเตอร์ URI
| ชื่อ | ใน | จำเป็น | พิมพ์ | คำอธิบาย |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
ID พื้นที่ทํางาน |
|
continuation
|
query |
string |
โทเค็นสําหรับการเรียกใช้หน้าถัดไปของผลลัพธ์ |
การตอบสนอง
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| 200 OK |
คําขอเสร็จสมบูรณ์ |
|
| Other Status Codes |
รหัสข้อผิดพลาดทั่วไป:
|
ตัวอย่าง
| List managed private endpoints in workspace example |
| List managed private endpoints in workspace with continuation example |
List managed private endpoints in workspace example
คำขอตัวอย่าง
GET https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/managedPrivateEndpoints
คำตอบตัวอย่าง
{
"value": [
{
"id": "59a92b06-6e5a-468c-b748-e28c8ff28da3",
"name": "SqlPE",
"targetPrivateLinkResourceId": "/subscriptions/e3bf3f1a-4d64-4e42-85e9-aa1b84e3874/resourceGroups/testRG/providers/Microsoft.SqlServer/SqlServer/sql1",
"provisioningState": "Succeeded",
"connectionState": {
"status": "Approved",
"description": "Endpoint approved"
},
"targetSubresourceType": "sqlServer"
},
{
"id": "1b56faf6-9cb8-4506-8c6c-83e0aece804f",
"name": "BlobPE",
"targetPrivateLinkResourceId": "/subscriptions/73310022-c811-4844-8b73-f9baa17c0d08/resourceGroups/testRG2/providers/Microsoft.Storage/storageAccounts/storage1",
"provisioningState": "Succeeded",
"connectionState": {
"status": "Approved",
"description": "Endpoint approval provided"
},
"targetSubresourceType": "blob"
}
]
}
List managed private endpoints in workspace with continuation example
คำขอตัวอย่าง
GET https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/managedPrivateEndpoints
คำตอบตัวอย่าง
{
"value": [
{
"id": "59a92b06-6e5a-468c-b748-e28c8ff28da3",
"name": "SqlPE",
"targetPrivateLinkResourceId": "/subscriptions/e3bf3f1a-4d64-4e42-85e9-aa1b84e3874/resourceGroups/testRG/providers/Microsoft.SqlServer/SqlServer/sql1",
"provisioningState": "Succeeded",
"connectionState": {
"status": "Approved",
"description": "Endpoint approved"
},
"targetSubresourceType": "sqlServer"
},
{
"id": "1b56faf6-9cb8-4506-8c6c-83e0aece804f",
"name": "BlobPE",
"targetPrivateLinkResourceId": "/subscriptions/73310022-c811-4844-8b73-f9baa17c0d08/resourceGroups/testRG2/providers/Microsoft.Storage/storageAccounts/storage1",
"provisioningState": "Succeeded",
"connectionState": {
"status": "Approved",
"description": "Endpoint approval provided"
},
"targetSubresourceType": "blob"
}
],
"continuationToken": "LDEsMTAwMDAwLDA%3D",
"continuationUri": "https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/managedPrivateEndpoints?continuationToken=LDEsMTAwMDAwLDA%3D"
}
คำจำกัดความ
| ชื่อ | คำอธิบาย |
|---|---|
|
Connection |
สถานะการเชื่อมต่อปลายทางส่วนตัว สถานะการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป |
|
Error |
ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
|
Error |
การตอบสนองข้อผิดพลาด |
|
Error |
รายละเอียดการตอบสนองข้อผิดพลาด |
|
Managed |
จุดปลายทางส่วนตัวที่มีการจัดการ |
|
Managed |
|
|
Private |
สถานะการเชื่อมต่อปลายทางส่วนตัว |
|
Private |
สถานะการเตรียมใช้งานของปลายทาง |
ConnectionStatus
สถานะการเชื่อมต่อปลายทางส่วนตัว สถานะการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
| ค่า | คำอธิบาย |
|---|---|
| Pending |
ค้างอยู่รอการอนุมัติ |
| Approved |
อนุมัติปลายทางแล้ว |
| Rejected |
จุดสิ้นสุดที่ถูกปฏิเสธ |
| Disconnected |
จุดสิ้นสุดถูกยกเลิกการเชื่อมต่อ |
ErrorRelatedResource
ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| resourceId |
string |
ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
| resourceType |
string |
ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
ErrorResponse
การตอบสนองข้อผิดพลาด
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| errorCode |
string |
ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้ |
| message |
string |
การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้ |
| moreDetails |
รายการรายละเอียดข้อผิดพลาดเพิ่มเติม |
|
| relatedResource |
รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
|
| requestId |
string |
รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด |
ErrorResponseDetails
รายละเอียดการตอบสนองข้อผิดพลาด
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| errorCode |
string |
ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้ |
| message |
string |
การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้ |
| relatedResource |
รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
ManagedPrivateEndpoint
จุดปลายทางส่วนตัวที่มีการจัดการ
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| connectionState |
สถานะการเชื่อมต่อปลายทางของจุดสิ้นสุดที่เตรียมใช้งาน |
|
| id |
string (uuid) |
จัดการรหัสจุดปลายทางส่วนตัวแล้ว |
| name |
string |
ชื่อจุดปลายทางส่วนตัว |
| provisioningState |
สถานะการเตรียมใช้งานของปลายทาง |
|
| targetPrivateLinkResourceId |
string |
รหัสทรัพยากรของแหล่งข้อมูลที่สร้างจุดปลายทางส่วนตัวขึ้น |
| targetSubresourceType |
string |
ทรัพยากรย่อยชี้ไปยังที่เก็บลิงก์ส่วนตัว |
ManagedPrivateEndpoints
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| continuationToken |
string |
โทเค็นสําหรับชุดผลลัพธ์ชุดถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง |
| continuationUri |
string |
URI ของชุดงานชุดผลลัพธ์ถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง |
| value |
รายการของจุดปลายทางส่วนตัวที่มีการจัดการ |
PrivateEndpointConnectionState
สถานะการเชื่อมต่อปลายทางส่วนตัว
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| actionsRequired |
string |
การดําเนินการที่จําเป็นเพื่อสร้างการเชื่อมต่อ |
| description |
string |
ข้อความคําอธิบาย (ถ้ามี) ที่มีให้ในการอนุมัติหรือปฏิเสธจุดสิ้นสุด |
| status |
สถานะการเชื่อมต่อ |
PrivateEndpointProvisioningState
สถานะการเตรียมใช้งานของปลายทาง
| ค่า | คำอธิบาย |
|---|---|
| Provisioning |
จุดสิ้นสุดส่วนตัวในการเตรียมใช้งานอยู่ในระหว่างดําเนินการ |
| Succeeded |
การเตรียมใช้งานจุดสิ้นสุดส่วนตัวสําเร็จ |
| Updating |
การอัปเดตจุดสิ้นสุดส่วนตัว |
| Deleting |
การลบปลายทางส่วนตัว |
| Failed |
การเตรียมใช้งานจุดสิ้นสุดส่วนตัวล้มเหลว |