Bagikan melalui

Items - Update Item

  • Referensi
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 kontributor atau peran yang lebih tinggi di ruang kerja.

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

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.
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.
id

string

uuid

ID item.
type

ItemType

Jenis item.
workspaceId

string

uuid

ID ruang kerja.

ItemType

Enumeration

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

Nilai Deskripsi
Dashboard

Dasbor PowerBI.
DataPipeline

Alur data.
Datamart

Datamart PowerBI.
Environment

Lingkungan.
Eventhouse

Sebuah rumah acara.
Eventstream

Eventstream.
GraphQLApi

API untuk item GraphQL.
KQLDashboard

Dasbor KQL.
KQLDatabase

Database KQL.
KQLQueryset

Set kueri KQL.
Lakehouse

Sebuah lakehouse.
MLExperiment

Eksperimen pembelajaran mesin.
MLModel

Model pembelajaran mesin.
MirroredDatabase

Database cermin.
MirroredWarehouse

Sebuah gudang cermin.
MountedDataFactory

A MountedDataFactory.
Notebook

Buku catatan.
PaginatedReport

Laporan paginasi PowerBI.
Reflex

Sebuah Refleks.
Report

Laporan PowerBI.
SQLDatabase

Sebuah SQLDatabase.
SQLEndpoint

Titik akhir SQL.
SemanticModel

Model semantik PowerBI.
SparkJobDefinition

Definisi pekerjaan spark.
Warehouse

Sebuah gudang.

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.