Domains - Create Domain

บริการ:

Admin

เวอร์ชัน API:

v1

สร้างโดเมนใหม่

โน้ต

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

สิทธิ์

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

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

Tenant.ReadWrite.All

ขีด จำกัด

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

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

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

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

อิน เทอร์ เฟซ

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

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
preview	query	True	boolean	พารามิเตอร์นี้ระบุเวอร์ชันของ API ที่จะใช้ ตั้งค่าเพื่อใช้ false เวอร์ชันที่วางจําหน่าย

เนื้อความของคำขอ

ชื่อ	จำเป็น	พิมพ์	คำอธิบาย
displayName	True	string	ชื่อโดเมนที่แสดง ชื่อที่แสดงต้องไม่เกิน 40 อักขระ
description		string	คําอธิบายโดเมน คําอธิบายต้องมีอักขระไม่เกิน 256 ตัว
parentDomainId		string (uuid)	ID ออบเจ็กต์หลักของโดเมน

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
201 Created	Domain	สร้างโดเมนเรียบร้อยแล้ว
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: EntityNotFound - สร้างโดเมนล้มเหลวเนื่องจากไม่พบ ID โดเมนหลัก EntityConflict - สร้างโดเมนล้มเหลวเนื่องจากมีชื่อที่แสดงโดเมนอยู่แล้ว InvalidInput - ID โดเมนหลักไม่ถูกต้อง

ตัวอย่าง

Create a domain example

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

HTTP

POST https://api.fabric.microsoft.com/v1/admin/domains?preview=false

{
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df"
}

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

รหัสสถานะ:

201

{
  "id": "9eba6944-daff-4441-b9b5-630ce34238fd",
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df"
}

คำจำกัดความ

ชื่อ	คำอธิบาย
CreateDomainRequest	คําขอส่วนข้อมูลสําหรับการสร้างโดเมนหรือโดเมนย่อย
Domain
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด

CreateDomainRequest

ออบเจ็กต์

คําขอส่วนข้อมูลสําหรับการสร้างโดเมนหรือโดเมนย่อย

ชื่อ	พิมพ์	คำอธิบาย
description	string	คําอธิบายโดเมน คําอธิบายต้องมีอักขระไม่เกิน 256 ตัว
displayName	string	ชื่อโดเมนที่แสดง ชื่อที่แสดงต้องไม่เกิน 40 อักขระ
parentDomainId	string (uuid)	ID ออบเจ็กต์หลักของโดเมน

Domain

ออบเจ็กต์

ชื่อ	พิมพ์	คำอธิบาย
defaultLabelId	string (uuid)	ป้ายชื่อระดับความลับเริ่มต้นของโดเมน
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	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด