แชร์ผ่าน

Items - List Item Connections

บริการ:
Core
เวอร์ชัน API:
v1

แสดงรายการการเชื่อมต่อที่รายการที่ระบุเชื่อมต่ออยู่
API นี้สนับสนุน การแบ่งหน้า

สิทธิ์

ผู้เรียกต้องมีสิทธิ์ ในการอ่านและเขียน สําหรับรายการ

จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์

สําหรับรายการ API ใช้ชนิดขอบเขตเหล่านี้:

  • ขอบเขตทั่วไป: Item.ReadWrite.All
  • ขอบเขตเฉพาะ: itemTypeReadWrite.All (ตัวอย่างเช่น: Notebook.ReadWrite.All)

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต ให้ดูบทความ ขอบเขต

ข้อจำกัด

API นี้ถูกบล็อกสําหรับรายการที่มีป้ายชื่อระดับความลับที่ได้รับการป้องกัน เว้นแต่ว่าผู้เรียกมีสิทธิ์การใช้งานในการลบป้ายชื่อระดับความลับ

ข้อมูลประจําตัวที่สนับสนุนของ Microsoft Entra

API นี้สนับสนุนข้อมูลประจําตัวของ Microsoft แสดงรายการในส่วนนี้

เอกลักษณ์ สนับสนุน
ผู้ใช้ ใช่
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ ใช่

อิน เทอร์ เฟซ

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/connections
ด้วยพารามิเตอร์ที่เลือกได้: 
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/connections?continuationToken={continuationToken}

พารามิเตอร์ URI

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

string (uuid)

รหัสสินค้า
workspaceId
 path True

string (uuid)

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

string

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

การตอบสนอง

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

ItemConnections

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

ErrorResponse

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

  • ItemNotFound - บ่งชี้ว่าเซิร์ฟเวอร์ไม่พบรายการที่ร้องขอ

ตัวอย่าง

List item connections - Semantic Model Direct Lake example
List item connections example
List item connections with continuation example

List item connections - Semantic Model Direct Lake example

คำขอตัวอย่าง

GET https://api.fabric.microsoft.com/v1/workspaces/4b218778-e7a5-4d73-8187-f10824047715/items/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7/connections

คำตอบตัวอย่าง

รหัสสถานะ:
200 
{
  "value": [
    {
      "connectivityType": "Automatic",
      "connectionDetails": {
        "type": "SQL",
        "path": "xqoruksalslrtkdxe2bvrlwgsi-5j2iqepw1i3ucdp6bepe62hcii.datawarehouse.fabric.microsoft.com;532183f5-ac60-4d12-0fc5-4094532f14b5"
      }
    }
  ]
}

List item connections example

คำขอตัวอย่าง

GET https://api.fabric.microsoft.com/v1/workspaces/4b218778-e7a5-4d73-8187-f10824047715/items/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7/connections

คำตอบตัวอย่าง

รหัสสถานะ:
200 
{
  "value": [
    {
      "connectivityType": "ShareableCloud",
      "displayName": "ContosoConnection1",
      "id": "6952a7b2-aea3-414f-9d85-6c0fe5d34539",
      "connectionDetails": {
        "type": "Web",
        "path": "https://www.contoso.com"
      }
    },
    {
      "connectivityType": "OnPremisesGateway",
      "displayName": "ContosoConnection2",
      "id": "0b9af1bd-e974-4893-8947-d89d5a560385",
      "gatewayId": "58376c10-5f61-4024-887e-748df4beae45",
      "connectionDetails": {
        "type": "SQL",
        "path": "contoso.database.windows.net;sales"
      }
    }
  ]
}

List item connections with continuation example

คำขอตัวอย่าง

GET https://api.fabric.microsoft.com/v1/workspaces/4b218778-e7a5-4d73-8187-f10824047715/items/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7/connections

คำตอบตัวอย่าง

รหัสสถานะ:
200 
{
  "value": [
    {
      "connectivityType": "Automatic",
      "connectionDetails": {
        "type": "SQL",
        "path": "xqoruksalslrtkdxe2bvrlwgsi-5j2iqepw1i3ucdp6bepe62hcii.datawarehouse.fabric.microsoft.com;532183f5-ac60-4d12-0fc5-4094532f14b5"
      }
    }
  ]
}

คำจำกัดความ

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

ชนิดการเชื่อมต่อของการเชื่อมต่อ ประเภทการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
ErrorRelatedResource

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

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

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

รายละเอียดการเชื่อมต่อผลลัพธ์สําหรับการดําเนินการรายการ

ConnectivityType

การแจงนับ

ชนิดการเชื่อมต่อของการเชื่อมต่อ ประเภทการเชื่อมต่อเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

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

การเชื่อมต่อเชื่อมต่อผ่านระบบคลาวด์และสามารถแชร์กับผู้อื่นได้
PersonalCloud

การเชื่อมต่อเชื่อมต่อผ่านระบบคลาวด์และไม่สามารถแชร์กับผู้อื่นได้
OnPremisesGateway

การเชื่อมต่อจะเชื่อมต่อผ่านเกตเวย์ข้อมูลภายในองค์กร
OnPremisesGatewayPersonal

การเชื่อมต่อจะเชื่อมต่อผ่านเกตเวย์ข้อมูลภายในองค์กรส่วนบุคคล
VirtualNetworkGateway

การเชื่อมต่อจะเชื่อมต่อผ่านเกตเวย์ข้อมูลเครือข่ายเสมือน
Automatic

การเชื่อมต่อเชื่อมต่อผ่านระบบคลาวด์โดยใช้การเชื่อมต่อข้อมูลโดยนัย ตัวเลือกนี้พร้อมใช้งานสําหรับสถานการณ์เฉพาะเช่น แบบจําลองความหมายที่ใช้ Sign-On เดี่ยว (SSO)"
None

การเชื่อมต่อไม่ถูกผูกไว้

ErrorRelatedResource

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponse

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

ออบเจ็กต์

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

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

string

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

string

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

ErrorRelatedResource

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

ItemConnection

ออบเจ็กต์
ชื่อ พิมพ์ คำอธิบาย
connectionDetails

ListConnectionDetails

รายละเอียดการเชื่อมต่อของการเชื่อมต่อ
connectivityType

ConnectivityType

ชนิดการเชื่อมต่อของการเชื่อมต่อ
displayName

string

ชื่อที่แสดงของการเชื่อมต่อ ความยาวสูงสุดคือ 200 อักขระ
gatewayId

string (uuid)

ID ออปเจ็กต์เกตเวย์ของการเชื่อมต่อ
id

string (uuid)

ID ออปเจ็กต์ของการเชื่อมต่อ

ItemConnections

ออบเจ็กต์
ชื่อ พิมพ์ คำอธิบาย
continuationToken

string

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

string

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

ItemConnection[]

รายการการเชื่อมต่อหน่วยข้อมูล

ListConnectionDetails

ออบเจ็กต์

รายละเอียดการเชื่อมต่อผลลัพธ์สําหรับการดําเนินการรายการ

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

string

เส้นทางของการเชื่อมต่อ
type

string

ชนิดของการเชื่อมต่อ