แชร์ผ่าน


Domains - Get Domain (preview)

ส่งกลับข้อมูลโดเมนที่ระบุ (ตัวอย่าง)

Note

API ตัวอย่างนี้จะถูกยกเลิกการสนับสนุนในวันที่ 31 มีนาคม 2026 และแทนที่ด้วยเวอร์ชันที่เสถียรซึ่งมีอยู่ที่นี่ เวอร์ชันใหม่จะทําให้เกิดการเปลี่ยนแปลงที่เสียหายและไม่สามารถเข้ากันได้แบบย้อนหลัง เมื่อเรียกใช้ API นี้ ผู้เรียกต้องระบุ true เป็นค่าสําหรับพารามิเตอร์ previewคิวรี

ประกาศการเลิกใช้

มีการนําพารามิเตอร์ preview คิวรีใหม่เข้ามาเพื่ออํานวยความสะดวกในการเปลี่ยนนี้:

  • ในขณะนี้previewพารามิเตอร์คิวรีมีค่าเริ่มต้นเป็นtrue
  • ตั้งค่าของ preview พารามิเตอร์คิวรีเพื่อใช้ false เวอร์ชันที่วางจําหน่ายของ API นี้
  • เริ่มต้นวันที่ 31 มีนาคม 2026 ค่าเริ่มต้นสําหรับ preview จะเปลี่ยนเป็นfalse

เราขอแนะนําให้โยกย้ายการรวมของคุณเพื่อใช้เวอร์ชันที่วางจําหน่ายโดยเร็วที่สุดโดยการระบุ false สําหรับ preview พารามิเตอร์คิวรี (ค่าเริ่มต้นสําหรับ preview พารามิเตอร์คิวรีจะถูกตั้งค่าเป็น false วันที่ไม่สนับสนุน API)

มีการเปลี่ยนแปลงที่เข้ากันไม่ได้ต่อไปนี้ถูกนํามาใช้ในรุ่นการเผยแพร่:

  • คุณสมบัติ contributorsScope การตอบกลับถูกลบ

สิทธิ์

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

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

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

Limitations

สูงสุด 25 คําขอต่อหนึ่งนาทีต่อเงินต้น

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

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

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

อิน เทอร์ เฟซ

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

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

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

string (uuid)

ID โดเมน

preview
query True

boolean

พารามิเตอร์นี้ระบุเวอร์ชันของ API ที่จะใช้ ตั้งค่าเพื่อใช้trueเวอร์ชันตัวอย่างที่อธิบายไว้ในหน้านี้ หรือเพื่อใช้falseเวอร์ชันเผยแพร่โดยละเอียดที่นี่ เริ่มต้นวันที่ 31 มีนาคม 2026 ค่าเริ่มต้นสําหรับ preview จะเปลี่ยนเป็นfalse

การตอบสนอง

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

DomainPreview

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

Other Status Codes

ErrorResponse

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

  • DomainNotFound - ไม่พบโดเมนที่ให้มา

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

ตัวอย่าง

Get a domain example

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

GET https://api.fabric.microsoft.com/v1/admin/domains/f2f6a374-789e-4d1d-9cc7-6e0b934fc529?preview=True

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

{
  "id": "f2f6a374-789e-4d1d-9cc7-6e0b934fc529",
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": null,
  "contributorsScope": "SpecificUsersAndGroups"
}

คำจำกัดความ

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

ขอบเขตผู้สนับสนุน ขอบเขตผู้สนับสนุนเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

DomainPreview
ErrorRelatedResource

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

ErrorResponse

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

ErrorResponseDetails

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

ContributorsScopeType

ขอบเขตผู้สนับสนุน ขอบเขตผู้สนับสนุนเพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

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

ผู้ใช้ของผู้เช่าทั้งหมด

SpecificUsersAndGroups

ผู้ใช้และกลุ่มที่เฉพาะเจาะจง

AdminsOnly

เฉพาะผู้ดูแลระบบผู้เช่าและโดเมนเท่านั้น

DomainPreview

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

ContributorsScopeType

ขอบเขตผู้สนับสนุนโดเมน

description

string

คําอธิบายของโดเมน

displayName

string

ชื่อของโดเมน

id

string (uuid)

ID ออบเจ็กต์ของโดเมน

parentDomainId

string (uuid)

ID ออบเจ็กต์หลักของโดเมน

ErrorRelatedResource

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

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

string

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

resourceType

string

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

ErrorResponse

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

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

string

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

message

string

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

moreDetails

ErrorResponseDetails[]

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

relatedResource

ErrorRelatedResource

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

requestId

string

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

ErrorResponseDetails

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

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

string

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

message

string

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

relatedResource

ErrorRelatedResource

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