Domains - List Role Assignments

บริการ:: Admin

เวอร์ชัน API:: v1

แสดงรายการการกําหนดบทบาทโดเมน

สิทธิ์

ผู้เรียกต้องเป็นผู้ดูแลระบบ Fabric

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

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

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

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

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

อิน เทอร์ เฟซ

GET https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/roleAssignments

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

GET https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/roleAssignments?continuationToken={continuationToken}

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
domainId	path	True	string (uuid)	ID โดเมน
continuationToken	query		string	โทเค็นสําหรับการเรียกใช้หน้าถัดไปของผลลัพธ์

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK	DomainRoleAssignments	คําขอเสร็จสมบูรณ์
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: DomainNotFound - ไม่พบโดเมนที่ให้มา UnknownError - เกิดข้อผิดพลาด

ชื่อ

พิมพ์

คำอธิบาย

200 OK

DomainRoleAssignments

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

Other Status Codes

ErrorResponse

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

DomainNotFound - ไม่พบโดเมนที่ให้มา
UnknownError - เกิดข้อผิดพลาด

ตัวอย่าง

List domain role assignments example

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

HTTP

GET https://api.fabric.microsoft.com/v1/admin/domains/00cb3785-58b5-408e-9e5f-7a26d28f0b9b/roleAssignments

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

รหัสสถานะ:: 200

{
  "value": [
    {
      "role": "Admin",
      "principal": {
        "displayName": "Eric Solomon",
        "id": "81fac5e1-2a81-421b-a168-110b1c72fa11",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "eric@microsoft.com"
        }
      }
    },
    {
      "role": "Contributor",
      "principal": {
        "id": "f51b705f-a409-4d40-9197-c5d5f349e2f0",
        "displayName": "TestSecurityGroup",
        "type": "Group",
        "groupDetails": {
          "groupType": "SecurityGroup"
        }
      }
    }
  ]
}

คำจำกัดความ

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

DomainRole

การแจงนับ

แสดงสมาชิกโดเมนตามชนิดคําขอของโครงร่างสําคัญ ประเภทคําขอเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Admin	ผู้ดูแลโดเมน
Contributor	ผู้สนับสนุนโดเมน

DomainRoleAssignment

ออบเจ็กต์

แสดงการกําหนดบทบาทโดเมน

ชื่อ	พิมพ์	คำอธิบาย
principal	Principal	ครูใหญ่
role	DomainRole	บทบาทโดเมนของโครงร่างสําคัญ

DomainRoleAssignments

ออบเจ็กต์

ตัวตัดการตอบสนองสําหรับรายการการกําหนดบทบาทโดเมนด้วยโทเค็นต่อเนื่อง

ชื่อ	พิมพ์	คำอธิบาย
continuationToken	string	โทเค็นสําหรับชุดผลลัพธ์ชุดถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง
continuationUri	string	URI ของชุดงานชุดผลลัพธ์ถัดไป ถ้าไม่มีระเบียนเพิ่มเติม จะถูกลบออกจากการตอบสนอง
value	DomainRoleAssignment[]	รายการการกําหนดบทบาทโดเมน

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

การแจงนับ

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

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

Principal

ออบเจ็กต์

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

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

PrincipalType

การแจงนับ

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

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

ServicePrincipalDetails

ออบเจ็กต์

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

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

ServicePrincipalProfileDetails

ออบเจ็กต์

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

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

UserDetails

ออบเจ็กต์

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

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

แชร์ผ่าน

Domains - List Role Assignments

สิทธิ์

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

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

อิน เทอร์ เฟซ

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

การตอบสนอง

ตัวอย่าง

List domain role assignments example

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

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

คำจำกัดความ

DomainRole

DomainRoleAssignment

DomainRoleAssignments

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupType

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UserDetails