Items - Update Logical Id

Layanan:: Core

Versi API:: v1

Memperbarui ID logis untuk item yang ditentukan.
Instans item yang sesuai berbagi ID logis yang sama. Gunakan operasi ini untuk mengatasi konflik ID logis. Sebelum mengubah ID logis, tinjau otomatisasi apa pun yang bergantung pada nilainya saat ini dan perbarui sesuai kebutuhan. Jika tidak, otomatisasi tersebut mungkin gagal menemukan item atau gagal karena nama tampilan duplikat. Untuk informasi selengkapnya, lihat Mengatasi konflik ID logis di Microsoft Fabric.

Permissions

Pemanggil harus memiliki izin baca dan tulis untuk item tersebut.

Cakupan Didelegasikan yang Diperlukan

Untuk API item, gunakan salah satu jenis cakupan berikut:

Cakupan generik: Item.ReadWrite.All.
Cakupan tertentu: itemType. ReadWrite.All (misalnya, Notebook.ReadWrite.All).

Untuk informasi selengkapnya tentang cakupan, lihat Cakupan.

Limitations

ID logis tidak boleh berupa GUID kosong (00000000-0000-0000-0000-000000000000).
ID logis harus unik dalam ruang kerja.
Operasi tidak didukung saat operasi CI/CD aktif di ruang kerja.

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas	Support
User	Yes
Prinsipal Layanan dan Identitas Terkelola	Yes

Interface

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
itemId	path	True	string (uuid)	ID item.
workspaceId	path	True	string (uuid)	ID ruangkerja.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
logicalId	True	string (uuid)	ID logis yang akan diperbarui untuk item.

Respons

Nama Jenis Deskripsi

200 OK

Nama	Jenis	Deskripsi
200 OK	LogicalIdResponse	Permintaan berhasil diselesaikan.
429 Too Many Requests	ErrorResponse	Batas tarif layanan terlampaui. Server mengembalikan header `Retry-After` yang menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan. Header Retry-After: integer
Other Status Codes	ErrorResponse	Kode kesalahan umum: ItemNotFound - Item yang diminta tidak ditemukan. ActiveCiCdOperationInProgress - Operasi CI/CD aktif di ruang kerja.

LogicalIdResponse

Permintaan berhasil diselesaikan.

429 Too Many Requests

ErrorResponse

Batas tarif layanan terlampaui. Server mengembalikan header Retry-After yang menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan.

Header

Retry-After: integer

Other Status Codes

ErrorResponse

Kode kesalahan umum:

ItemNotFound - Item yang diminta tidak ditemukan.
ActiveCiCdOperationInProgress - Operasi CI/CD aktif di ruang kerja.

Contoh

Update logical ID example

Permintaan sampel

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"
}

Respon sampel

Kode status:: 200

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

Definisi

Nama	Deskripsi
ErrorParameter	Parameter terstruktur yang menyediakan konteks tambahan yang dapat dibaca mesin tentang kesalahan.
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Rincian respons kesalahan.
LogicalIdResponse	Respons ID logis.
UpdateLogicalIdRequest	Perbarui payload permintaan ID logis.

ErrorParameter

Objek

Parameter terstruktur yang menyediakan konteks tambahan yang dapat dibaca mesin tentang kesalahan.

Nama	Jenis	Deskripsi
message	string	Deskripsi yang dapat dibaca manusia tentang arti parameter.
name	string	Pengidentifikasi parameter.
value	string	Nilai parameter.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama	Jenis	Deskripsi
resourceId	string	ID sumber daya yang terlibat dalam kesalahan.
resourceType	string	Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
isRetriable	boolean	Jika benar, permintaan dapat dicoba kembali. `Retry-After` Gunakan header respons untuk menentukan penundaan, jika tersedia.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
parameters	ErrorParameter[]	Parameter terstruktur menyediakan konteks tambahan yang dapat dibaca mesin tentang kesalahan.
relatedResource	ErrorRelatedResource	Detail dari sumber daya yang terkait dengan kesalahan.
requestId	string (uuid)	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Rincian respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
parameters	ErrorParameter[]	Parameter terstruktur menyediakan konteks tambahan yang dapat dibaca mesin tentang kesalahan.
relatedResource	ErrorRelatedResource	Detail dari sumber daya yang terkait dengan kesalahan.

LogicalIdResponse

Objek

Respons ID logis.

Nama	Jenis	Deskripsi
logicalId	string (uuid)	ID logis item.

UpdateLogicalIdRequest

Objek

Perbarui payload permintaan ID logis.

Nama	Jenis	Deskripsi
logicalId	string (uuid)	ID logis yang akan diperbarui untuk item.