แชร์ผ่าน

Folders - Move 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/{folderId}/move

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

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

string (uuid)

ID โฟลเดอร์
workspaceId
 path True

string (uuid)

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

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

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

string (uuid)

ID โฟลเดอร์ปลายทาง ถ้าไม่มี จะใช้พื้นที่ทํางานเป็นโฟลเดอร์ปลายทาง

การตอบสนอง

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

Folder

คําขอเสร็จสมบูรณ์
Other Status Codes

ErrorResponse

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

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

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

  • InfiniteFolderHierarchyLoop - โฟลเดอร์ไม่สามารถย้ายไปยังที่ลงจุดใด ๆ ของโฟลเดอร์ได้

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

ตัวอย่าง

Move a folder into another folder example
Move a folder with the workspace as the destination example

Move a folder into another folder example

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

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

{
  "targetFolderId": "cccccccc-8888-9999-0000-dddddddddddd"
}

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

รหัสสถานะ:
200 
{
  "id": "dddddddd-9999-0000-1111-eeeeeeeeeeee",
  "displayName": "Q2",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "parentFolderId": "cccccccc-8888-9999-0000-dddddddddddd"
}

Move a folder with the workspace as the destination example

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

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

{}

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

รหัสสถานะ:
200 
{
  "id": "dddddddd-9999-0000-1111-eeeeeeeeeeee",
  "displayName": "Q2",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
}

คำจำกัดความ

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

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

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

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

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

ย้ายคําขอโฟลเดอร์

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 พื้นที่ทํางาน

MoveFolderRequest

ออบเจ็กต์

ย้ายคําขอโฟลเดอร์

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

string (uuid)

ID โฟลเดอร์ปลายทาง ถ้าไม่มี จะใช้พื้นที่ทํางานเป็นโฟลเดอร์ปลายทาง