Workspaces - Update Workspace

บริการ:

Core

เวอร์ชัน API:

v1

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

การอนุญาต

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

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

Workspace.ReadWrite.All

ขีดจํากัดการควบคุม

ประเภทขีดจํากัด	ค่า
โควตาแบบรวมสําหรับแพลตฟอร์ม API	โทร 200 ครั้ง/นาที
ขีดจํากัด API	โทร 200 ครั้ง/นาที

ข้อมูลประจําตัวที่สนับสนุนของ 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	คําขอเสร็จสมบูรณ์
429 Too Many Requests	ErrorResponse	เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ Retry-After ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม ส่วนหัว Retry-After: integer
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",
  "capacityRegion": "East US"
}

คำจำกัดความ

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

CapacityRegion

การแจงนับ

ภูมิภาคของความจุที่เชื่อมโยงกับพื้นที่ทํางานนี้ อาจมีการเพิ่มค่าภูมิภาคความจุเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Australia East	ภูมิภาคออสเตรเลียตะวันออก
Australia Southeast	ภูมิภาคตะวันออกเฉียงใต้ของออสเตรเลีย
Brazil South	บราซิลใต้ภูมิภาค
Brazil Southeast	ภูมิภาคตะวันออกเฉียงใต้ของบราซิล
Canada Central	แคนาดาตอนกลางของภูมิภาค
Canada East	แคนาดาตะวันออก
Central India	ภูมิภาคอินเดียตอนกลาง
Central US	ภูมิภาคของสหรัฐอเมริกาตอนกลาง
Central US EUAP	ภูมิภาค EUAP ของสหรัฐอเมริกาตอนกลาง
East Asia	ภูมิภาคเอเชียตะวันออก
East US	ภูมิภาคสหรัฐอเมริกาตะวันออก
East US 2	ภูมิภาคสหรัฐอเมริกาฝั่งตะวันออก 2
France Central	ภูมิภาคส่วนกลางของฝรั่งเศส
France South	ภูมิภาคฝรั่งเศสตอนใต้
Germany Central	ภูมิภาคเยอรมนีตอนกลาง
Germany Northeast	เยอรมนีตะวันออกเฉียงเหนือ
Israel Central	อิสราเอลตอนกลาง
Italy North	ภูมิภาคอิตาลีเหนือ
Japan East	ญี่ปุ่นตะวันออก
Japan West	ญี่ปุ่นตะวันตก
Korea Central	เกาหลีตอนกลางภูมิภาค
Korea South	เกาหลีตอนใต้
Mexico Central	ภูมิภาคเม็กซิโกตอนกลาง
North Central US	ภูมิภาคสหรัฐอเมริกาตอนกลางทางเหนือ
North Europe	ภูมิภาคยุโรปเหนือ
Norway East	ภูมิภาคตะวันออกของนอร์เวย์
Norway West	ภูมิภาคนอร์เวย์ตะวันตก
Poland Central	ภูมิภาคตอนกลางของโปแลนด์
South Africa North	แอฟริกาใต้ในภูมิภาคเหนือ
South Africa West	ภูมิภาคแอฟริกาตะวันตกเฉียงใต้
South Central US	ภูมิภาคสหรัฐอเมริกาตอนกลางทางใต้
South India	ภูมิภาคอินเดียใต้
Southeast Asia	ภูมิภาคเอเชียตะวันออกเฉียงใต้
Spain Central	ภูมิภาคสเปนตอนกลาง
Sweden Central	ภูมิภาคกลางของสวีเดน
Switzerland North	สวิตเซอร์แลนด์เหนือ
Switzerland West	ภูมิภาคสวิตเซอร์แลนด์ตะวันตก
West Europe	ภูมิภาคยุโรปตะวันตก
West India	ภูมิภาคอินเดียตะวันตก
West US	ภูมิภาคสหรัฐอเมริกาตะวันตก
West US 2	US 2 ภูมิภาคตะวันตก
West US 3	US 3 ภูมิภาคตะวันตก
West Central US	ภูมิภาคสหรัฐอเมริกาตอนกลางทางตะวันตก
UAE Central	ภูมิภาคกลางของ UAE
UAE North	ภูมิภาค UAE North
Qatar Central	ภูมิภาคกาตาร์ตอนกลาง
Germany West Central	เยอรมนีตอนกลางทางตะวันตก
Germany North	ภูมิภาคเยอรมนีเหนือ
UK South	ภูมิภาคทางใต้ของสหราชอาณาจักร
UK West	ภูมิภาคตะวันตกของสหราชอาณาจักร
China North	จีนเหนือ
China East	ภูมิภาคตะวันออกของจีน
China East 2	จีนตะวันออก 2 ภูมิภาค
China East 3	จีนตะวันออก 3 ภูมิภาค
China North 2	จีนเหนือ 2 ภูมิภาค
China North 3	จีนเหนือ 3 ภูมิภาค

ErrorRelatedResource

วัตถุ

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

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

ErrorResponse

วัตถุ

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

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

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 ของความจุที่มีการกําหนดพื้นที่ทํางานให้กับพื้นที่ทํางาน
capacityRegion	CapacityRegion	ภูมิภาคของความจุที่เชื่อมโยงกับพื้นที่ทํางานนี้
description	string	คําอธิบายพื้นที่ทํางาน
displayName	string	ชื่อที่แสดงของพื้นที่ทํางาน
domainId	string (uuid)	ID ของโดเมนที่มีการกําหนดพื้นที่ทํางานให้
id	string (uuid)	ID พื้นที่ทํางาน
tags	WorkspaceAppliedTag[]	รายการของแท็กที่ใช้
type	WorkspaceType	ประเภทพื้นที่ทํางาน

WorkspaceAppliedTag

วัตถุ

แสดงแท็กที่ถูกนําไปใช้

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อของแท็ก
id	string (uuid)	ID แท็ก

WorkspaceType

การแจงนับ

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

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