แชร์ผ่าน


Domains - Update 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 Request ถูกเอาออก
  • คุณสมบัติ contributorsScope การตอบกลับถูกลบ

สิทธิ์

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

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

Tenant.ReadWrite.All.

Limitations

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

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

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

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

อิน เทอร์ เฟซ

PATCH 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

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

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

ContributorsScopeType

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

description

string

คําอธิบายโดเมน คําอธิบายต้องมีอักขระไม่เกิน 256 ตัว

displayName

string

ชื่อโดเมนที่แสดง ชื่อที่แสดงต้องไม่เกิน 40 อักขระ

การตอบสนอง

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

DomainPreview

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

Other Status Codes

ErrorResponse

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

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

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

  • EntityConflict - การอัปเดตโดเมนล้มเหลวเนื่องจากมีชื่อที่แสดงโดเมนอยู่แล้ว

ตัวอย่าง

Update a domain example

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

PATCH https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f?preview=True

{
  "displayName": "Domain's new name",
  "description": "Domain's new description",
  "contributorsScope": "SpecificUsersAndGroups"
}

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

{
  "id": "f2f6a374-789e-4d1d-9cc7-6e0b934fc529",
  "displayName": "Domain's new name",
  "description": "Domain's new description",
  "parentDomainId": null,
  "contributorsScope": "SpecificUsersAndGroups"
}

คำจำกัดความ

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

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

DomainPreview
ErrorRelatedResource

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

ErrorResponse

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

ErrorResponseDetails

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

UpdateDomainRequestPreview

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

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

UpdateDomainRequestPreview

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

ContributorsScopeType

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

description

string

คําอธิบายโดเมน คําอธิบายต้องมีอักขระไม่เกิน 256 ตัว

displayName

string

ชื่อโดเมนที่แสดง ชื่อที่แสดงต้องไม่เกิน 40 อักขระ