แชร์ผ่าน


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

ชื่อ ใน จำเป็น พิมพ์ คำอธิบาย
workspaceId
path True

string (uuid)

ID พื้นที่ทํางาน

continuationToken
query

string

โทเค็นสําหรับการเรียกใช้หน้าถัดไปของผลลัพธ์

การตอบสนอง

ชื่อ พิมพ์ คำอธิบาย
200 OK

ManagedPrivateEndpoints

คําขอเสร็จสมบูรณ์

Other Status Codes

ErrorResponse

รหัสข้อผิดพลาดทั่วไป:

  • UnknownError - เกิดข้อผิดพลาด

ตัวอย่าง

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

คำจำกัดความ

ชื่อ คำอธิบาย
ConnectionStatus

สถานะการเชื่อมต่อปลายทางส่วนตัว สถานะการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ErrorRelatedResource

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

การตอบสนองข้อผิดพลาด

ErrorResponseDetails

รายละเอียดการตอบสนองข้อผิดพลาด

ManagedPrivateEndpoint

จุดปลายทางส่วนตัวที่มีการจัดการ

ManagedPrivateEndpoints
PrivateEndpointConnectionState

สถานะการเชื่อมต่อปลายทางส่วนตัว

PrivateEndpointProvisioningState

สถานะการเตรียมใช้งานของปลายทาง

ConnectionStatus

สถานะการเชื่อมต่อปลายทางส่วนตัว สถานะการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า คำอธิบาย
Pending

ค้างอยู่รอการอนุมัติ

Approved

อนุมัติปลายทางแล้ว

Rejected

จุดสิ้นสุดที่ถูกปฏิเสธ

Disconnected

จุดสิ้นสุดถูกยกเลิกการเชื่อมต่อ

ErrorRelatedResource

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ชื่อ พิมพ์ คำอธิบาย
resourceId

string

ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

resourceType

string

ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

การตอบสนองข้อผิดพลาด

ชื่อ พิมพ์ คำอธิบาย
errorCode

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้

message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้

moreDetails

ErrorResponseDetails[]

รายการรายละเอียดข้อผิดพลาดเพิ่มเติม

relatedResource

ErrorRelatedResource

รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

requestId

string

รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

รายละเอียดการตอบสนองข้อผิดพลาด

ชื่อ พิมพ์ คำอธิบาย
errorCode

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้

message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้

relatedResource

ErrorRelatedResource

รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ManagedPrivateEndpoint

จุดปลายทางส่วนตัวที่มีการจัดการ

ชื่อ พิมพ์ คำอธิบาย
connectionState

PrivateEndpointConnectionState

สถานะการเชื่อมต่อปลายทางของจุดสิ้นสุดที่เตรียมใช้งาน

id

string (uuid)

จัดการรหัสจุดปลายทางส่วนตัวแล้ว

name

string

ชื่อจุดปลายทางส่วนตัว

provisioningState

PrivateEndpointProvisioningState

สถานะการเตรียมใช้งานของปลายทาง

targetPrivateLinkResourceId

string

รหัสทรัพยากรของแหล่งข้อมูลที่สร้างจุดปลายทางส่วนตัวขึ้น

targetSubresourceType

string

ทรัพยากรย่อยชี้ไปยังที่เก็บลิงก์ส่วนตัว

ManagedPrivateEndpoints

ชื่อ พิมพ์ คำอธิบาย
continuationToken

string

โทเค็นสําหรับชุดผลลัพธ์ชุดถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง

continuationUri

string

URI ของชุดงานชุดผลลัพธ์ถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง

value

ManagedPrivateEndpoint[]

รายการของจุดปลายทางส่วนตัวที่มีการจัดการ

PrivateEndpointConnectionState

สถานะการเชื่อมต่อปลายทางส่วนตัว

ชื่อ พิมพ์ คำอธิบาย
actionsRequired

string

การดําเนินการที่จําเป็นเพื่อสร้างการเชื่อมต่อ

description

string

ข้อความคําอธิบาย (ถ้ามี) ที่มีให้ในการอนุมัติหรือปฏิเสธจุดสิ้นสุด

status

ConnectionStatus

สถานะการเชื่อมต่อ

PrivateEndpointProvisioningState

สถานะการเตรียมใช้งานของปลายทาง

ค่า คำอธิบาย
Provisioning

จุดสิ้นสุดส่วนตัวในการเตรียมใช้งานอยู่ในระหว่างดําเนินการ

Succeeded

การเตรียมใช้งานจุดสิ้นสุดส่วนตัวสําเร็จ

Updating

การอัปเดตจุดสิ้นสุดส่วนตัว

Deleting

การลบปลายทางส่วนตัว

Failed

การเตรียมใช้งานจุดสิ้นสุดส่วนตัวล้มเหลว