แชร์ผ่าน

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

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

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

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