Items - Update Item

Layanan:

Core

Versi API:

v1

Memperbarui properti item yang ditentukan.
API ini didukung untuk sejumlah jenis item, menemukan jenis item yang didukung dan informasi tentang struktur definisinya di Gambaran umum manajemen item.

Izin

Pemanggil harus memiliki izin baca dan tulis untuk item tersebut.

Cakupan yang Didelegasikan yang Diperlukan

Untuk API item, gunakan jenis cakupan ini:

• Cakupan generik: Item.ReadWrite.All
• Cakupan spesifik: itemType. ReadWrite.All (misalnya: Notebook.ReadWrite.All)

untuk informasi selengkapnya tentang cakupan, lihat: artikel cakupan .

Identitas yang didukung Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas	Dukung
Pengguna	Ya
perwakilan Layanan dan identitas terkelola	Saat tipe item dalam panggilan didukung. Periksa API yang sesuai untuk jenis item yang Anda panggil, untuk melihat apakah panggilan Anda didukung. Misalnya, model semantik didukung.

Antarmuka

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

Parameter URI

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

Isi Permintaan

Nama	Jenis	Deskripsi
description	string	Deskripsi item. Panjang maksimum adalah 256 karakter.
displayName	string	Nama tampilan item. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.

Respons

Nama	Jenis	Deskripsi
200 OK	Item	Permintaan berhasil diselesaikan.
Other Status Codes	ErrorResponse	Kode kesalahan umum: ItemNotFound - Item yang diminta tidak ditemukan. InvalidRequest - Permintaan pembaruan tidak valid.

Contoh

Update an item example

Permintaan sampel

HTTP

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

{
  "displayName": "Item's New name",
  "description": "Item's New description"
}

Respon sampel

Kode status:

200

{
  "displayName": "Item's New name",
  "description": "Item's New description",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Definisi

Nama	Deskripsi
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
Item	Objek item.
ItemTag	Mewakili tag yang diterapkan pada item.
ItemType	Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.
UpdateItemRequest	Perbarui permintaan item.

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.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.
requestId	string	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail 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.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.

Item

Objek

Objek item.

Nama	Jenis	Deskripsi
description	string	Deskripsi item.
displayName	string	Nama tampilan item.
folderId	string (uuid)	ID folder.
id	string (uuid)	ID item.
tags	ItemTag[]	Daftar tag yang diterapkan.
type	ItemType	Jenis item.
workspaceId	string (uuid)	ID ruang kerja.

ItemTag

Objek

Mewakili tag yang diterapkan pada item.

Nama	Jenis	Deskripsi
displayName	string	Nama dari tag.
id	string (uuid)	ID tag.

ItemType

Enumerasi

Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Dashboard	Dasbor PowerBI.
Report	Laporan PowerBI.
SemanticModel	Model semantik PowerBI.
PaginatedReport	Laporan paginasi PowerBI.
Datamart	Datamart PowerBI.
Lakehouse	Sebuah lakehouse.
Eventhouse	Sebuah rumah acara.
Environment	Lingkungan.
KQLDatabase	Database KQL.
KQLQueryset	Set kueri KQL.
KQLDashboard	Dasbor KQL.
DataPipeline	Alur data.
Notebook	Buku catatan.
SparkJobDefinition	Definisi pekerjaan spark.
MLExperiment	Eksperimen pembelajaran mesin.
MLModel	Model pembelajaran mesin.
Warehouse	Sebuah gudang.
Eventstream	Eventstream.
SQLEndpoint	Titik akhir SQL.
MirroredWarehouse	Sebuah gudang cermin.
MirroredDatabase	Database cermin.
Reflex	Sebuah Refleks.
GraphQLApi	API untuk item GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Sebuah SQLDatabase.
CopyJob	Pekerjaan Penyalinan.
VariableLibrary	VariabelLibrary.
Dataflow	Aliran Data.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Rekam jepret gudang.
DigitalTwinBuilder	Sebuah DigitalTwinBuilder.
DigitalTwinBuilderFlow	Alur Pembangun Kembar Digital.
MirroredAzureDatabricksCatalog	Katalog azure databricks cermin.
Map	Peta.
AnomalyDetector	Detektor Anomali.
UserDataFunction	Fungsi data pengguna.
GraphModel	Sebuah GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake Database untuk menyimpan tabel Iceberg yang dibuat dari akun Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Database Cosmos DB.
Ontology	Ontologi.
EventSchemaSet	An EventSchemaSet.

UpdateItemRequest

Objek

Perbarui permintaan item.

Nama	Jenis	Deskripsi
description	string	Deskripsi item. Panjang maksimum adalah 256 karakter.
displayName	string	Nama tampilan item. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.