แชร์ผ่าน

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

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

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

ผู้ดูแลระบบตรวจสอบพื้นที่ทํางาน ประกอบด้วยรายงานของผู้ดูแลระบบ เช่น รายงานการตรวจสอบและรายงานการใช้งานและการปรับใช้