Items - List Item Access Details

บริการ:

Admin

เวอร์ชัน API:

v1

โน้ต

API นี้อยู่ในตัวอย่าง

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

สิทธิ์

ผู้เรียกต้องเป็นผู้ดูแลระบบ Fabric หรือรับรองความถูกต้องโดยใช้โครงร่างสําคัญของบริการ

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

Tenant.Read.All หรือ Tenant.ReadWrite.All

ขีด จำกัด

สูงสุด 200 คําขอต่อชั่วโมง

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

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

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

อิน เทอร์ เฟซ

GET https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/items/{itemId}/users

ด้วยพารามิเตอร์ที่เลือกได้:

GET https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/items/{itemId}/users?type={type}

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
itemId	path	True	string uuid	รหัสสินค้า
workspaceId	path	True	string uuid	ID พื้นที่ทํางาน
type	query		string	ชนิดของสินค้า เมื่อทําการคิวรีสําหรับชนิดต่อไปนี้ พารามิเตอร์นี้จําเป็น: รายงาน แผงหน้าปัด SemanticModel แอป กระแสข้อมูล

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK	ItemAccessDetailsResponse	การดําเนินการสําเร็จ
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: ItemNotFound - ไม่มี ID รายการอยู่ InvalidItemType - ชนิดรายการไม่ถูกต้อง

ตัวอย่าง

List of users for given item ID and type example

List of users for given item ID example

List of users for given item ID and type example

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

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces/7f4496db-9929-47bd-89c0-d7eb2f517a98/items/f089354e-8366-4e18-aea3-4cb4a3a50b48/users?type=Report

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

รหัสสถานะ:

200

{
  "accessDetails": [
    {
      "principal": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Jacob Hancock",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "jacob@example.com"
        }
      },
      "itemAccessDetails": {
        "type": "Report",
        "permissions": [
          "Read",
          "Reshare"
        ],
        "additionalPermissions": [
          "ReadAll"
        ]
      }
    }
  ]
}

List of users for given item ID example

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

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces/7f4496db-9929-47bd-89c0-d7eb2f517a98/items/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

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

รหัสสถานะ:

200

{
  "accessDetails": [
    {
      "principal": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Jacob Hancock",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "jacob@example.com"
        }
      },
      "itemAccessDetails": {
        "type": "Notebook",
        "permissions": [
          "Read",
          "Reshare"
        ],
        "additionalPermissions": [
          "ReadAll",
          "viewOutput"
        ]
      }
    },
    {
      "principal": {
        "id": "c7db8e03-c8cb-4d4c-9f64-1dcd327c9d3c",
        "displayName": "Eric Solomon",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "eric@example.com"
        }
      },
      "itemAccessDetails": {
        "type": "Notebook",
        "permissions": [
          "Read",
          "Reshare",
          "Explore"
        ],
        "additionalPermissions": [
          "ReadAll"
        ]
      }
    },
    {
      "principal": {
        "id": "f51b705f-a409-4d40-9197-c5d5f349e2f0",
        "displayName": "TestSecurityGroup",
        "type": "Group",
        "groupDetails": {
          "groupType": "SecurityGroup"
        }
      },
      "itemAccessDetails": {
        "type": "Notebook",
        "permissions": [
          "Read",
          "Reshare"
        ],
        "additionalPermissions": []
      }
    }
  ]
}

คำจำกัดความ

ชื่อ	คำอธิบาย
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
GroupDetails	รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก Group
GroupType	ชนิดของกลุ่ม คุณสามารถเพิ่มชนิดกลุ่มเพิ่มเติมเมื่อเวลาผ่านไป
ItemAccessDetail	รายละเอียดสิทธิ์รายการ เช่น อ่าน และ แชร์ต่อ
ItemAccessDetails	รายละเอียดการเข้าถึงของผู้ใช้สําหรับรายการ
ItemAccessDetailsResponse	รายการของผู้ใช้ที่มีการเข้าถึงเอนทิตีที่ระบุ
ItemPermissions	สิทธิ์รายการ อาจเพิ่มสิทธิ์รายการเพิ่มเติมเมื่อเวลาผ่านไป
ItemType	ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
Principal	แสดงข้อมูลประจําตัวหรือกลุ่ม Microsoft Entra
PrincipalType	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป
ServicePrincipalDetails	รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก ServicePrincipal
ServicePrincipalProfileDetails	รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก ServicePrincipalProfile
UserDetails	รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก User

ErrorRelatedResource

ออบเจ็กต์

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

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

ออบเจ็กต์

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

ออบเจ็กต์

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

GroupDetails

ออบเจ็กต์

รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก Group

ชื่อ	พิมพ์	คำอธิบาย
groupType	GroupType	ชนิดของกลุ่ม คุณสามารถเพิ่มชนิดกลุ่มเพิ่มเติมเมื่อเวลาผ่านไป

GroupType

การแจงนับ

ชนิดของกลุ่ม คุณสามารถเพิ่มชนิดกลุ่มเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
DistributionList	หลักคือรายการการแจกจ่าย
SecurityGroup	หลักคือกลุ่มความปลอดภัย
Unknown	ไม่รู้จักชนิดกลุ่มหลัก

ItemAccessDetail

ออบเจ็กต์

รายละเอียดสิทธิ์รายการ เช่น อ่าน และ แชร์ต่อ

ชื่อ	พิมพ์	คำอธิบาย
additionalPermissions	string[]	สิทธิ์ปริมาณงาน เช่น readAll และ viewOutput
permissions	ItemPermissions[]	สิทธิ์รายการ เช่น อ่าน และ แชร์ต่อ
type	ItemType	ชนิดเอนทิตี

ItemAccessDetails

ออบเจ็กต์

รายละเอียดการเข้าถึงของผู้ใช้สําหรับรายการ

ชื่อ	พิมพ์	คำอธิบาย
itemAccessDetails	ItemAccessDetail	สิทธิ์รายการสําหรับผู้ใช้
principal	Principal	ข้อมูลเกี่ยวกับผู้ใช้ที่มีสิทธิ์เข้าถึงเอนทิตี

ItemAccessDetailsResponse

ออบเจ็กต์

รายการของผู้ใช้ที่มีการเข้าถึงเอนทิตีที่ระบุ

ชื่อ	พิมพ์	คำอธิบาย
accessDetails	ItemAccessDetails[]	รายการของผู้ใช้ที่มีการเข้าถึงเอนทิตี

ItemPermissions

การแจงนับ

สิทธิ์รายการ อาจเพิ่มสิทธิ์รายการเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Execute	ผู้ใช้สามารถดําเนินการและยกเลิกงานสินค้าได้
Explore	ผู้ใช้สามารถสร้างรายการบนรายการอื่น ๆ ได้
Read	ผู้ใช้สามารถอ่านเมตาดาต้าเกี่ยวกับรายการได้
Reshare	ผู้ใช้สามารถแชร์รายการกับผู้ใช้อื่นได้
Write	ผู้ใช้สามารถดําเนินการเขียนบนรายการได้

ItemType

การแจงนับ

ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Dashboard	แดชบอร์ด PowerBI
DataPipeline	ไปป์ไลน์ข้อมูล
Datamart	Datamart ของ PowerBI
Environment	สภาพแวดล้อม
Eventhouse	อาคารจัดงาน
Eventstream	เหตุการณ์กระแสข้อมูล
GraphQLApi	API สําหรับรายการ GraphQL
KQLDashboard	แดชบอร์ด KQL
KQLDatabase	ฐานข้อมูล KQL
KQLQueryset	ชุดคิวรี KQL
Lakehouse	เลคเฮ้าส์
MLExperiment	การทดลองการเรียนรู้ของเครื่อง
MLModel	แบบจําลองการเรียนรู้ของเครื่อง
MirroredDatabase	ฐานข้อมูลที่มิเรอร์
MirroredWarehouse	คลังสินค้าที่มิเรอร์
MountedDataFactory	เมาท์ DataFactory
Notebook	โน๊ตบุ๊ค
PaginatedReport	รายงานที่มีการแบ่งหน้าของ PowerBI
Reflex	รีเฟล็กซ์
Report	รายงาน PowerBI
SQLDatabase	SQLDatabase
SQLEndpoint	จุดสิ้นสุด SQL
SemanticModel	แบบจําลองความหมายของ PowerBI
SparkJobDefinition	ข้อกําหนดงานแบบประกายไฟ
Warehouse	คลังสินค้า

Principal

ออบเจ็กต์

แสดงข้อมูลประจําตัวหรือกลุ่ม Microsoft Entra

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
groupDetails	GroupDetails	รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก Group
id	string uuid	ID ของโครงร่างสําคัญ
servicePrincipalDetails	ServicePrincipalDetails	รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก ServicePrincipal
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก ServicePrincipalProfile
type	PrincipalType	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป
userDetails	UserDetails	รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก User

PrincipalType

การแจงนับ

ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Group	หลักคือกลุ่มความปลอดภัย
ServicePrincipal	หลักคือโครงร่างสําคัญของบริการ Microsoft Entra
ServicePrincipalProfile	หลักคือ โปรไฟล์โครงร่างสําคัญของบริการ
User	หลักคือผู้ใช้หลัก Microsoft Entra

ServicePrincipalDetails

ออบเจ็กต์

รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก ServicePrincipal

ชื่อ	พิมพ์	คำอธิบาย
aadAppId	string uuid	Microsoft Entra AppId ของบริการหลัก

ServicePrincipalProfileDetails

ออบเจ็กต์

รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก ServicePrincipalProfile

ชื่อ	พิมพ์	คำอธิบาย
parentPrincipal	Principal	โครงร่างสําคัญของโปรไฟล์บริการหลัก

UserDetails

ออบเจ็กต์

รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก User

ชื่อ	พิมพ์	คำอธิบาย
userPrincipalName	string	ชื่อหลักของผู้ใช้