Workspaces - Update Workspace

บริการ:

Core

เวอร์ชัน API:

v1

อัปเดตคุณสมบัติพื้นที่ทํางานที่ระบุ

การอนุญาต

ผู้เรียกต้องมีบทบาทพื้นที่ทํางาน ของผู้ดูแลระบบ

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

Workspace.ReadWrite.All

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

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

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

อินเตอร์เฟซ

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน

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

ชื่อ	พิมพ์	คำอธิบาย
description	string	คําอธิบายพื้นที่ทํางาน คําอธิบายต้องมีอักขระไม่เกิน 4000 ตัว
displayName	string	ชื่อที่แสดงของพื้นที่ทํางาน ชื่อที่แสดงต้องไม่เกิน 256 อักขระ ชื่อพื้นที่ทํางานภายในผู้เช่าต้องไม่ซ้ํากัน "การตรวจสอบผู้ดูแลระบบ" เป็นชื่อพื้นที่ทํางานที่สงวนไว้

การตอบสนอง

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

ตัวอย่าง

Update a workspace example

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

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/33bae707-5fe7-4352-89bd-061a1318b60a

{
  "displayName": "Workspace New displayName",
  "description": "Workspace New description"
}

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

รหัสสถานะ:

200

{
  "id": "33bae707-5fe7-4352-89bd-061a1318b60a",
  "displayName": "Workspace New displayName",
  "description": "Workspace New description",
  "type": "Workspace",
  "domainId": "686177b9-ef29-45e4-a5db-1786ca6dbb9f"
}

คำจำกัดความ

ชื่อ	คำอธิบาย
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
UpdateWorkspaceRequest	อัปเดตส่วนข้อมูลคําขอพื้นที่ทํางาน
Workspace	ออบเจ็กต์พื้นที่ทํางาน
WorkspaceType	ชนิดของพื้นที่ทํางาน คุณสามารถเพิ่มชนิดพื้นที่ทํางานเพิ่มเติมเมื่อเวลาผ่านไป

ErrorRelatedResource

ออบเจ็กต์

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

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

ออบเจ็กต์

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

ออบเจ็กต์

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

UpdateWorkspaceRequest

ออบเจ็กต์

อัปเดตส่วนข้อมูลคําขอพื้นที่ทํางาน

ชื่อ	พิมพ์	คำอธิบาย
description	string	คําอธิบายพื้นที่ทํางาน คําอธิบายต้องมีอักขระไม่เกิน 4000 ตัว
displayName	string	ชื่อที่แสดงของพื้นที่ทํางาน ชื่อที่แสดงต้องไม่เกิน 256 อักขระ ชื่อพื้นที่ทํางานภายในผู้เช่าต้องไม่ซ้ํากัน "การตรวจสอบผู้ดูแลระบบ" เป็นชื่อพื้นที่ทํางานที่สงวนไว้

Workspace

ออบเจ็กต์

ออบเจ็กต์พื้นที่ทํางาน

ชื่อ	พิมพ์	คำอธิบาย
apiEndpoint	string (uri)	URL HTTP ที่แสดงถึงจุดสิ้นสุด API เฉพาะสําหรับพื้นที่ทํางาน ค่าจุดสิ้นสุดนี้จะถูกส่งกลับเมื่อผู้ใช้เปิดใช้งานมากกว่า WorkspaceSpecificEndpoints อนุญาตให้เข้าถึง API ผ่านลิงก์ส่วนตัว
capacityId	string (uuid)	ID ของความจุที่มีการกําหนดพื้นที่ทํางานให้กับพื้นที่ทํางาน
description	string	คําอธิบายพื้นที่ทํางาน
displayName	string	ชื่อที่แสดงของพื้นที่ทํางาน
domainId	string (uuid)	ID ของโดเมนที่มีการกําหนดพื้นที่ทํางานให้
id	string (uuid)	ID พื้นที่ทํางาน
type	WorkspaceType	ประเภทพื้นที่ทํางาน

WorkspaceType

การแจงนับ

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

ค่า	คำอธิบาย
Personal	โฟลเดอร์ของฉันหรือพื้นที่ทํางานของฉันที่ใช้ในการจัดการรายการของผู้ใช้
Workspace	พื้นที่ทํางานที่ใช้ในการจัดการรายการ Fabric
AdminWorkspace	ผู้ดูแลระบบตรวจสอบพื้นที่ทํางาน ประกอบด้วยรายงานของผู้ดูแลระบบ เช่น รายงานการตรวจสอบและรายงานการใช้งานและการปรับใช้