Items - Create Item

Layanan:
Core
Versi API:
v1

Membuat item di ruang kerja yang ditentukan.
API ini didukung untuk sejumlah jenis item, menemukan jenis item yang didukung dalam gambaran umum manajemen item . Anda dapat menggunakan API definisi Dapatkan item untuk mendapatkan definisi item.

API ini mendukung operasi jangka panjang (LRO).

Izin

Pemanggil harus memiliki peran ruang kerja kontributor .

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 .

Keterbatasan

  • Untuk membuat item Fabric non-PowerBI, ruang kerja harus berada pada kapasitas Fabric yang didukung. Untuk informasi selengkapnya, lihat jenis lisensi Microsoft Fabric.
  • Untuk membuat item PowerBI, pengguna harus memiliki lisensi yang sesuai. Untuk informasi selengkapnya, lihat jenis lisensi Microsoft Fabric.
  • Saat membuat item, gunakan creationPayload atau definition, tetapi jangan gunakan keduanya secara bersamaan.

Batas Pengendalian

Jenis Batas Value
Kuota Terpadu untuk API Platform 200 panggilan/menit
Batas API 200 panggilan/menit

Microsoft Entra identitas yang didukung

API ini mendukung Microsoft identities yang tercantum di bagian ini.

Identitas Dukung
Pengguna Ya
Prinsipal 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

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
workspaceId
 path True

string (uuid)

ID ruang kerja.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
displayName True

string

Nama tampilan item. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.
type True

ItemType

Jenis item.
creationPayload

object

Sekumpulan properti yang digunakan untuk membuat item. Halaman Buat Item dari jenis yang relevan menunjukkan apakah creationPayload didukung dan mencantumkan properti item. Gunakan creationPayload atau definition. Anda tidak dapat menggunakan keduanya secara bersamaan.
definition

ItemDefinition

Definisi item. Halaman Buat Item dari jenis yang relevan menunjukkan apakah definisi didukung dan merinci strukturnya. Gunakan definition atau creationPayload. Anda tidak dapat menggunakan keduanya secara bersamaan.
description

string

Deskripsi item. Panjang maksimum adalah 256 karakter.
folderId

string (uuid)

ID folder. Jika tidak ditentukan atau null, item dibuat dengan ruang kerja sebagai foldernya.
sensitivityLabelSettings

SensitivityLabelSettings

Pengaturan label sensitivitas untuk item.

Respons

Nama Jenis Deskripsi
201 Created

Item

Berhasil dibuat
202 Accepted

Permintaan diterima, provisi item sedang berlangsung

Header

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

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

Header

Retry-After: integer
Other Status Codes

ErrorResponse

Kode kesalahan umum:

  • InvalidItemType - Tipe item tidak valid.

  • ItemDisplayNameAlreadyInUse - Nama tampilan item sudah digunakan.

  • CorruptedPayload - Payload yang disediakan rusak.

  • FolderNotFound - Tidak dapat menemukan folder yang diminta.

  • WorkspaceItemsLimitExceeded - Batas item ruang kerja terlampaui.

Contoh

Create an item example
Create an item in folder example
Create an item with sensitivity label strategy example

Create an item example

Permintaan sampel

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items

{
  "displayName": "Item 1",
  "type": "Lakehouse"
}

Respon sampel

Kode status:
201 
{
  "displayName": "Item 1",
  "description": "",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Kode status:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create an item in folder example

Permintaan sampel

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items

{
  "displayName": "Item 1",
  "type": "Lakehouse",
  "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
}

Respon sampel

Kode status:
201 
{
  "displayName": "Item 1",
  "description": "",
  "type": "Lakehouse",
  "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "id": "cccccccc-2222-3333-4444-dddddddddddd",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
Kode status:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0000aaaa-11bb-cccc-dd22-eeeeee333333
x-ms-operation-id: 0000aaaa-11bb-cccc-dd22-eeeeee333333
Retry-After: 30

Create an item with sensitivity label strategy example

Permintaan sampel

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items

{
  "displayName": "Item with label",
  "type": "Lakehouse",
  "sensitivityLabelSettings": {
    "labelId": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f",
    "sensitivityLabelApplyStrategy": "ApplyOrFail"
  }
}

Respon sampel

Kode status:
201 
{
  "displayName": "Item 1",
  "description": "",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
Kode status:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Definisi

Nama Deskripsi
CreateItemRequest

Buat payload permintaan item.
EntireTenantPrincipal

Mewakili perwakilan penyewa
ErrorRelatedResource

Objek detail sumber daya terkait kesalahan.
ErrorResponse

Respons kesalahan.
ErrorResponseDetails

Detail respons kesalahan.
GroupDetails

Mengelompokkan detail spesifik. Berlaku ketika jenis utama Group.
GroupPrincipal

Mewakili grup keamanan.
GroupType

Jenis grup. Jenis grup tambahan dapat ditambahkan dari waktu ke waktu.
Item

Objek item.
ItemDefinition

Objek definisi item.
ItemDefinitionPart

Objek bagian definisi item.
ItemTag

Mewakili tag yang diterapkan pada item.
ItemType

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

Jenis payload bagian definisi. Jenis payload tambahan dapat ditambahkan dari waktu ke waktu.
PrincipalType

Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.
SensitivityLabel

Mewakili label sensitivitas yang diterapkan ke item.
SensitivityLabelApplyStrategy

Strategi untuk menerapkan label sensitivitas. Nilai defaultnya adalah ApplyOrFail. Jenis tambahan dapat ditambahkan dari waktu ke waktu.
SensitivityLabelSettings

Pengaturan label sensitivitas.
ServicePrincipalDetails

Detail spesifik perwakilan layanan. Berlaku ketika jenis utama ServicePrincipal.
ServicePrincipalPrincipal

Mewakili perwakilan layanan Microsoft Entra.
ServicePrincipalProfileDetails

Detail profil perwakilan layanan. Berlaku ketika jenis utama ServicePrincipalProfile.
ServicePrincipalProfilePrincipal

Mewakili profil perwakilan layanan.
UserDetails

Detail spesifik perwakilan pengguna. Berlaku ketika jenis utama User.
UserPrincipal

Mewakili prinsipal pengguna Microsoft Entra.

CreateItemRequest

Objek

Buat payload permintaan item.

Nama Jenis Deskripsi
creationPayload

object

Sekumpulan properti yang digunakan untuk membuat item. Halaman Buat Item dari jenis yang relevan menunjukkan apakah creationPayload didukung dan mencantumkan properti item. Gunakan creationPayload atau definition. Anda tidak dapat menggunakan keduanya secara bersamaan.
definition

ItemDefinition

Definisi item. Halaman Buat Item dari jenis yang relevan menunjukkan apakah definisi didukung dan merinci strukturnya. Gunakan definition atau creationPayload. Anda tidak dapat menggunakan keduanya secara bersamaan.
description

string

Deskripsi item. Panjang maksimum adalah 256 karakter.
displayName

string

Nama tampilan item. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item.
folderId

string (uuid)

ID folder. Jika tidak ditentukan atau null, item dibuat dengan ruang kerja sebagai foldernya.
sensitivityLabelSettings

SensitivityLabelSettings

Pengaturan label sensitivitas untuk item.
type

ItemType

Jenis item.

EntireTenantPrincipal

Objek

Mewakili perwakilan penyewa

Nama Jenis Deskripsi
displayName

string

Nama tampilan utama.
id

string (uuid)

Id utama.
type string:

EntireTenant

Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

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

ErrorRelatedResource

Detail sumber daya terkait kesalahan.
requestId

string (uuid)

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.

GroupDetails

Objek

Mengelompokkan detail spesifik. Berlaku ketika jenis utama Group.

Nama Jenis Deskripsi
groupType

GroupType

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

GroupPrincipal

Objek

Mewakili grup keamanan.

Nama Jenis Deskripsi
displayName

string

Nama tampilan utama.
groupDetails

GroupDetails

Mengelompokkan detail spesifik. Berlaku ketika jenis utama Group.
id

string (uuid)

Id utama.
type string:

Group

Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

GroupType

Enumerasi

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

Nilai Deskripsi
Unknown

Jenis grup utama tidak diketahui.
SecurityGroup

Prinsipal adalah kelompok keamanan.
DistributionList

Prinsipal adalah daftar distribusi.

Item

Objek

Objek item.

Nama Jenis Deskripsi
defaultIdentity Principal:

Identitas default item.
description

string

Deskripsi item.
displayName

string

Nama tampilan item.
folderId

string (uuid)

ID folder.
id

string (uuid)

ID item.
sensitivityLabel

SensitivityLabel

Label sensitivitas item.
tags

ItemTag[]

Daftar tag yang diterapkan.
type

ItemType

Jenis item.
workspaceId

string (uuid)

ID ruang kerja.

ItemDefinition

Objek

Objek definisi item.

Nama Jenis Deskripsi
format

string

Format definisi item.
parts

ItemDefinitionPart[]

Daftar bagian definisi.

ItemDefinitionPart

Objek

Objek bagian definisi item.

Nama Jenis Deskripsi
path

string

Jalur bagian item.
payload

string

Payload bagian item.
payloadType

PayloadType

Jenis payload.

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

A DataAgent.
MirroredCatalog

A MirroredCatalog.
AppBackend

An AppBackend.
OrgApp

Aplikasi Org.
OrgAppAudience

Audiens Aplikasi Org.
DataBuildToolJob

A DataBuildToolJob.
AzureDatabricksStorage

Item penyimpanan yang didukung OneLake untuk Azure Databricks.
Plan

Sebuah rencana.

PayloadType

Enumerasi

Jenis payload bagian definisi. Jenis payload tambahan dapat ditambahkan dari waktu ke waktu.

Nilai Deskripsi
InlineBase64

Dasar Sebaris 64.

PrincipalType

Enumerasi

Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

Nilai Deskripsi
User

Prinsipal adalah prinsipal pengguna Microsoft Entra.
ServicePrincipal

Perwakilan adalah perwakilan layanan Microsoft Entra.
Group

Prinsipal adalah kelompok keamanan.
ServicePrincipalProfile

Perwakilan adalah profil perwakilan layanan.
EntireTenant

Perwakilan mewakili semua pengguna penyewa.

SensitivityLabel

Objek

Mewakili label sensitivitas yang diterapkan ke item.

Nama Jenis Deskripsi
id

string (uuid)

ID label sensitivitas.

SensitivityLabelApplyStrategy

Enumerasi

Strategi untuk menerapkan label sensitivitas. Nilai defaultnya adalah ApplyOrFail. Jenis tambahan dapat ditambahkan dari waktu ke waktu.

Nilai Deskripsi
ApplyOrFail

Terapkan label sensitivitas atau gagal operasi jika tidak dapat diterapkan.
Ignore

Abaikan label sensitivitas jika tidak dapat diterapkan dan lanjutkan dengan operasi tanpa menerapkan label.

SensitivityLabelSettings

Objek

Pengaturan label sensitivitas.

Nama Jenis Deskripsi
labelId

string (uuid)

ID label sensitivitas.
sensitivityLabelApplyStrategy

SensitivityLabelApplyStrategy

Strategi untuk menerapkan label sensitivitas.

ServicePrincipalDetails

Objek

Detail spesifik perwakilan layanan. Berlaku ketika jenis utama ServicePrincipal.

Nama Jenis Deskripsi
aadAppId

string (uuid)

AppId Microsoft Entra perwakilan layanan.

ServicePrincipalPrincipal

Objek

Mewakili perwakilan layanan Microsoft Entra.

Nama Jenis Deskripsi
displayName

string

Nama tampilan utama.
id

string (uuid)

Id utama.
servicePrincipalDetails

ServicePrincipalDetails

Detail spesifik perwakilan layanan. Berlaku ketika jenis utama ServicePrincipal.
type string:

ServicePrincipal

Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

ServicePrincipalProfileDetails

Objek

Detail profil perwakilan layanan. Berlaku ketika jenis utama ServicePrincipalProfile.

Nama Jenis Deskripsi
parentPrincipal Principal:

Perwakilan induk profil perwakilan layanan.

ServicePrincipalProfilePrincipal

Objek

Mewakili profil perwakilan layanan.

Nama Jenis Deskripsi
displayName

string

Nama tampilan utama.
id

string (uuid)

Id utama.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Detail profil perwakilan layanan. Berlaku ketika jenis utama ServicePrincipalProfile.
type string:

ServicePrincipalProfile

Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.

UserDetails

Objek

Detail spesifik perwakilan pengguna. Berlaku ketika jenis utama User.

Nama Jenis Deskripsi
userPrincipalName

string

Nama prinsipal pengguna.

UserPrincipal

Objek

Mewakili prinsipal pengguna Microsoft Entra.

Nama Jenis Deskripsi
displayName

string

Nama tampilan utama.
id

string (uuid)

Id utama.
type string:

User

Jenis prinsipal. Jenis utama tambahan dapat ditambahkan dari waktu ke waktu.
userDetails

UserDetails

Detail spesifik perwakilan pengguna. Berlaku ketika jenis utama User.