แชร์ผ่าน

Folders - Update Folder

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

ปรับปรุงคุณสมบัติของโฟลเดอร์ที่ระบุ

หมายเหตุ

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

การอนุญาต

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

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

Workspace.ReadWrite.All

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

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

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

อินเตอร์เฟซ

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

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

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

string (uuid)

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

string (uuid)

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

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

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

string

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

การตอบสนอง

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

Folder

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

ErrorResponse

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

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

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

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

ตัวอย่าง

Update a folder example

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

PATCH https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/folders/aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb

{
  "displayName": "A new Folder name"
}

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

รหัสสถานะ:
200 
{
  "id": "aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb",
  "displayName": "A new Folder name",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
}

คำจำกัดความ

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

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

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

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

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

อัปเดตคําขอโฟลเดอร์

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

UpdateFolderRequest

ออบเจ็กต์

อัปเดตคําขอโฟลเดอร์

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

string

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