Items - Update Logical Id

บริการ:

Core

เวอร์ชัน API:

v1

อัพเดต ID เชิงตรรกะสําหรับสินค้าที่ระบุ
อินสแตนซ์รายการที่สอดคล้องกันใช้ ID แบบลอจิคัลเดียวกันร่วมกัน ใช้การดําเนินงานนี้เพื่อแก้ไขข้อขัดแย้งของรหัสเชิงตรรกะ ก่อนที่จะเปลี่ยน ID เชิงตรรกะ ให้ตรวจสอบการทํางานอัตโนมัติใดก็ตามที่ขึ้นอยู่กับค่าปัจจุบันและอัปเดตตามความจําเป็น มิฉะนั้น การทํางานอัตโนมัติเหล่านั้นอาจล้มเหลวในการค้นหารายการหรือล้มเหลวเนื่องจากมีชื่อที่แสดงซ้ํา สําหรับข้อมูลเพิ่มเติม โปรดดู แก้ไขข้อขัดแย้งของรหัสตรรกะใน Microsoft Fabric

การอนุญาต

ผู้เรียกต้องมีสิทธิ์ ในการอ่านและเขียน สําหรับรายการ

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

สําหรับรายการ API ใช้หนึ่งในประเภทขอบเขตต่อไปนี้:

• ขอบเขตทั่วไป: Item.ReadWrite.All.
• ขอบเขตเฉพาะ: itemType ReadWrite.All (ตัวอย่างเช่น Notebook.ReadWrite.All)

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต ดูขอบเขต

Limitations

• ID ตรรกะต้องไม่เป็น GUID ว่าง (00000000-0000-0000-0000-000000000000)
• ID เชิงตรรกะต้องไม่ซ้ํากันภายในพื้นที่ทํางาน
• การดําเนินการไม่ได้รับการสนับสนุนในขณะที่การดําเนินการ CI/CD ทํางานอยู่ในพื้นที่ทํางาน

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

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

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

ส่วนติดต่อ

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/logicalId

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
itemId	path	True	string (uuid)	รหัสสินค้า
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน

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

ชื่อ	จำเป็น	พิมพ์	คำอธิบาย
logicalId	True	string (uuid)	รหัสตรรกะที่จะอัพเดตสําหรับสินค้า

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK	LogicalIdResponse	คําขอเสร็จสมบูรณ์
429 Too Many Requests	ErrorResponse	เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ Retry-After ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม ส่วนหัว Retry-After: integer
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: ItemNotFound - ไม่พบรายการที่ร้องขอ ActiveCiCdOperationInProgress - การดําเนินการ CI/CD ทํางานอยู่ในพื้นที่ทํางาน

ตัวอย่าง

Update logical ID example

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

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715/logicalId

{
  "logicalId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}

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

รหัสสถานะ:

200

{
  "logicalId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
}

คำจำกัดความ

ชื่อ	คำอธิบาย
ErrorParameter	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
LogicalIdResponse	การตอบสนองรหัสตรรกะ
UpdateLogicalIdRequest	อัปเดตส่วนข้อมูลคําขอรหัสตรรกะ

ErrorParameter

วัตถุ

พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
message	string	คําอธิบายที่มนุษย์สามารถอ่านได้ของความหมายของพารามิเตอร์
name	string	ตัวระบุพารามิเตอร์
value	string	ค่าพารามิเตอร์

ErrorRelatedResource

วัตถุ

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

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

ErrorResponse

วัตถุ

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

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

ErrorResponseDetails

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
parameters	ErrorParameter[]	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

LogicalIdResponse

วัตถุ

การตอบสนองรหัสตรรกะ

ชื่อ	พิมพ์	คำอธิบาย
logicalId	string (uuid)	ID เชิงตรรกะของสินค้า

UpdateLogicalIdRequest

วัตถุ

อัปเดตส่วนข้อมูลคําขอรหัสตรรกะ

ชื่อ	พิมพ์	คำอธิบาย
logicalId	string (uuid)	รหัสตรรกะที่จะอัพเดตสําหรับสินค้า