แชร์ผ่าน

Folders - Create Folder

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

สร้างโฟลเดอร์ในพื้นที่ทํางานที่ระบุ

Note

API นี้เป็นส่วนหนึ่งของการเผยแพร่ตัวอย่าง และมีไว้เพื่อวัตถุประสงค์ในการประเมินและการพัฒนาเท่านั้น ซึ่งอาจเปลี่ยนแปลงตามคําติชมและไม่แนะนําสําหรับการใช้งานด้านการผลิต

Permissions

ผู้โทรต้องมีบทบาท ผู้สนับสนุน หรือพื้นที่ทํางานที่สูงกว่า

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

Workspace.ReadWrite.All

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

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

Identity Support
User Yes
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ Yes

Interface

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

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

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

string (uuid)

ID พื้นที่ทํางาน

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

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

string

ชื่อที่แสดงของโฟลเดอร์ ชื่อต้องมีคุณสมบัติตรงตามข้อกําหนดของชื่อโฟลเดอร์

parentFolderId

string (uuid)

ID โฟลเดอร์หลัก ถ้าไม่ได้ระบุ หรือ null โฟลเดอร์จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์หลัก

การตอบสนอง

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

Folder

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

ErrorResponse

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

  • FolderDisplayNameAlreadyInUse - ชื่อที่แสดงโฟลเดอร์ถูกใช้แล้ว

  • FolderNotFound - ไม่พบโฟลเดอร์ที่ร้องขอในพื้นที่ทํางาน

  • InvalidFolderDisplayName - ชื่อที่แสดงโฟลเดอร์ที่ระบุไม่ถูกต้อง

  • FolderDepthOutOfRange - โฟลเดอร์แม่มีความลึกสูงสุด ไม่สามารถสร้างโฟลเดอร์ย่อยใหม่ได้

  • WorkspaceNotSupported - ชนิดพื้นที่ทํางานที่ระบุไม่สนับสนุนโฟลเดอร์

.* TooManyFolders - พื้นที่ทํางานที่ระบุมีจํานวนโฟลเดอร์ถึงจํานวนสูงสุดแล้ว ไม่สามารถสร้างได้อีก

ตัวอย่าง

Create a folder under another folder example
Create a folder with the workspace as its parent folder example

Create a folder under another folder example

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

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/folders

{
  "displayName": "Q3",
  "parentFolderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
}

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

รหัสสถานะ:
201 
{
  "id": "ffffffff-5555-6666-7777-aaaaaaaaaaaa",
  "displayName": "Q3",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "parentFolderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
}

Create a folder with the workspace as its parent folder example

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

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/folders

{
  "displayName": "A folder"
}

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

รหัสสถานะ:
201 
{
  "id": "eeeeeeee-4444-5555-6666-ffffffffffff",
  "displayName": "A folder",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
}

คำจำกัดความ

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

สร้างส่วนข้อมูลการร้องขอของโฟลเดอร์
ErrorRelatedResource

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

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

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

วัตถุโฟลเดอร์

CreateFolderRequest

ออบเจ็กต์

สร้างส่วนข้อมูลการร้องขอของโฟลเดอร์

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

string

ชื่อที่แสดงของโฟลเดอร์ ชื่อต้องมีคุณสมบัติตรงตามข้อกําหนดของชื่อโฟลเดอร์

parentFolderId

string (uuid)

ID โฟลเดอร์หลัก ถ้าไม่ได้ระบุ หรือ null โฟลเดอร์จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์หลัก

ErrorRelatedResource

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponse

ออบเจ็กต์

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

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

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails

ErrorResponseDetails[]

รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource

ErrorRelatedResource

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

string

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

ErrorResponseDetails

ออบเจ็กต์

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

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

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource

ErrorRelatedResource

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

Folder

ออบเจ็กต์

วัตถุโฟลเดอร์

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

string

ชื่อที่แสดงของโฟลเดอร์
id

string (uuid)

ID โฟลเดอร์
parentFolderId

string (uuid)

ID โฟลเดอร์หลัก ถ้าโฟลเดอร์หลักเป็นพื้นที่ทํางาน parentFolderId ไม่ได้ระบุหรือเป็น null
workspaceId

string (uuid)

ID พื้นที่ทํางาน