แชร์ผ่าน

Workspaces - Create Workspace

บริการ:
Core
เวอร์ชัน API:
v1

สร้างพื้นที่ทํางานใหม่

สิทธิ์

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

Workspace.ReadWrite.All

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

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

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

อินเทอร์เฟซ

POST https://api.fabric.microsoft.com/v1/workspaces

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

ชื่อ จำเป็น พิมพ์ คำอธิบาย
displayName True

string

ชื่อที่แสดงของพื้นที่ทํางาน
ชื่อที่แสดงต้องไม่เกิน 256 อักขระ
อนุญาตเฉพาะชื่อพื้นที่ทํางานที่ไม่ได้ใช้เท่านั้น
"การตรวจสอบผู้ดูแลระบบ" เป็นชื่อพื้นที่ทํางานที่สงวนไว้
capacityId

string (uuid)

ID ของความจุเพื่อกําหนดพื้นที่ทํางาน
description

string

คําอธิบายพื้นที่ทํางาน
คําอธิบายต้องมีอักขระไม่เกิน 4000 ตัว
domainId

string (uuid)

ID ของโดเมนเพื่อกําหนดพื้นที่ทํางาน

การตอบสนอง

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

Workspace

สร้างเสร็จเรียบร้อยแล้ว

ส่วนหัว

Location: string
Other Status Codes

ErrorResponse

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

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

  • InsufficientPermissionsToDomain - สิทธิ์ของผู้ใช้ไปยังโดเมนไม่เพียงพอที่จะดําเนินการ

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

ตัวอย่าง

Create a workspace example

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

POST https://api.fabric.microsoft.com/v1/workspaces

{
  "displayName": "New workspace"
}

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

รหัสสถานะ:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb22287ff
{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb22287ff",
  "displayName": "New workspace",
  "description": "",
  "type": "Workspace"
}

คำจำกัดความ

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

สร้างส่วนข้อมูลคําขอของพื้นที่ทํางาน
ErrorRelatedResource

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

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

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

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

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

CreateWorkspaceRequest

ออบเจ็กต์

สร้างส่วนข้อมูลคําขอของพื้นที่ทํางาน

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

string (uuid)

ID ของความจุเพื่อกําหนดพื้นที่ทํางาน
description

string

คําอธิบายพื้นที่ทํางาน
คําอธิบายต้องมีอักขระไม่เกิน 4000 ตัว
displayName

string

ชื่อที่แสดงของพื้นที่ทํางาน
ชื่อที่แสดงต้องไม่เกิน 256 อักขระ
อนุญาตเฉพาะชื่อพื้นที่ทํางานที่ไม่ได้ใช้เท่านั้น
"การตรวจสอบผู้ดูแลระบบ" เป็นชื่อพื้นที่ทํางานที่สงวนไว้
domainId

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

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

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

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