Edit

Share via

Item management overview

  • Article

What is a Fabric item?

An item is a set of capabilities within an experience, for example: Data Engineering and Data Science. Users can create, edit, and delete items. Each item type provides different capabilities. For example, the Data Engineering experience includes the lakehouse, notebook, and Spark job definition items.

Fabric item CRUD APIs

You can use Fabric item CRUD APIs to manage your Fabric.

  • Create item: Create item with empty definition, create an item with definition, or create an item with a payload. You can't use both definition and payload in the same request.
  • Get item: Get properties of the item.
  • Delete item: Delete an item.
  • Update item: Update properties of the item.
  • List items: Retrieve a list of the items in the workspace.
  • Get item definition: Get the definition of the item, which can be used for item creation and updating definition later on.
  • Update item definition: Update the item definition (for example change visual name in a report).

The following section provides information about supported and unsupported item types.

Note

The following item types are not supported for any API:

  • Scorecard
  • Dataflow
  • Dataflow Gen 2

Item types API support

This section lists items that can be used without a definition for the following operations:

  • Create
  • Delete
  • Get
  • Update

The items are grouped by experience.

Data Factory

Item type Create (without definition) Get Update Delete List
DataPipeline ❌ ✅ ✅ ✅ ✅

Data Engineering

Item type Create (without definition) Get Update Delete List
Lakehouse ✅ ✅ ✅ ✅ ✅
Notebook ✅ ✅ ✅ ✅ ✅
SparkJobDefinition ✅ ✅ ✅ ✅ ✅

Data Science

Item type Create (without definition) Get Update Delete List
MLModel ✅ ✅ ✅ ✅ ✅
MLExperiment ✅ ✅ ✅ ✅ ✅

Data Warehouse

Item type Create (without definition) Create with payload/definition Get Update Delete List
Datamart ❌ ❌ ❌ ❌ ❌ ✅
MirroredDatabase ❌ ✅ ✅ ✅ ✅ ✅
MirroredWarehouse ❌ ❌ ❌ ❌ ❌ ✅
SQLEndpoint ❌ ❌ ❌ ❌ ❌ ✅
Warehouse ✅ ❌ ✅ ✅ ✅ ✅

Power BI

Item type Create (without definition) Get Update Delete List
Dashboard ❌ ❌ ❌ ❌ ✅
PaginatedReport ❌ ❌ ✅ ❌ ✅
Report ❌ ✅ ✅ ✅ ✅
SemanticModel ❌ ✅ ✅ ✅ ✅

Real-Time Intelligence

Item type Create Create with payload/definition Get Update Delete List
Eventhouse ✅ ❌ ✅ ✅ ✅ ✅
Eventstream ✅ ❌ ✅ ✅ ✅ ✅
KQLDatabase ✅ ✅ ✅ ✅ ✅ ✅
KQLQueryset ✅ ❌ ✅ ✅ ✅ ✅
KQLDashboard ✅ ✅ ✅ ✅ ✅ ✅

Related content