Items - Bulk Move Items

Layanan:: Core

Versi API:: v1

Pindahkan beberapa item ke folder. Item anak-anak dipindahkan dengan item induknya. Anda tidak dapat memindahkan item anak tanpa item induknya.

Nota

API ini adalah bagian dari rilis Pratinjau dan disediakan hanya untuk tujuan evaluasi dan pengembangan. Ini dapat berubah berdasarkan umpan balik dan tidak disarankan untuk penggunaan produksi.

Permissions

Pemanggil harus memiliki peran kontributor atau lebih tinggi di ruang kerja.

Cakupan yang Didelegasikan yang Diperlukan

Workspace.ReadWrite.All

Keterbatasan

Satu permintaan tidak boleh berisi lebih dari 50 item.

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas	Support
Pengguna	Yes
Prinsipal Layanan dan Identitas Terkelola	Yes

Antarmuka

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

Parameter URI

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

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
items	True	string[] (uuid)	ID item yang diminta untuk dipindahkan.
targetFolderId		string (uuid)	ID folder tujuan. Jika tidak disediakan, ruang kerja digunakan sebagai folder tujuan.

Respons

Nama	Jenis	Deskripsi
200 OK	MovedItems	Permintaan berhasil diselesaikan dan semua item dipindahkan.
Other Status Codes	ErrorResponse	Kode kesalahan umum: ItemNotFound - Item yang diminta tidak ditemukan. FolderNotFound - Tidak dapat menemukan folder yang diminta. CannotMoveChildOnly - Item anak tidak dapat dipindahkan tanpa item induknya. Jika permintaan gagal, tidak ada item yang dipindahkan.

Nama

Jenis

Deskripsi

200 OK

MovedItems

Permintaan berhasil diselesaikan dan semua item dipindahkan.

Other Status Codes

ErrorResponse

Kode kesalahan umum:

ItemNotFound - Item yang diminta tidak ditemukan.
FolderNotFound - Tidak dapat menemukan folder yang diminta.
CannotMoveChildOnly - Item anak tidak dapat dipindahkan tanpa item induknya.

Jika permintaan gagal, tidak ada item yang dipindahkan.

Contoh

Bulk move items into folder example

Bulk move items with the workspace as the destination example

Bulk move items into folder example

Permintaan sampel

HTTP

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

{
  "targetFolderId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
  "items": [
    "cccccccc-2222-3333-4444-dddddddddddd",
    "dddddddd-3333-4444-5555-eeeeeeeeeeee"
  ]
}

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "displayName": "MyLakehouse",
      "description": "A lakehouse used by the sales team.",
      "type": "Lakehouse",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    },
    {
      "id": "eeeeeeee-4444-5555-6666-ffffffffffff",
      "displayName": "MyLakehouse",
      "description": "A SQL endpoint who is the child of Lakehouse",
      "type": "SQLEndpoint",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    },
    {
      "id": "ffffffff-5555-6666-7777-aaaaaaaaaaaa",
      "displayName": "MyLakehouse",
      "description": "A Semantic model who is the child of SQLEndpoint",
      "type": "SemanticModel",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    },
    {
      "id": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
      "displayName": "Notebook",
      "description": "A notebook for refining year 2024 sales data analysis through machine learning algorithms.",
      "type": "SynapseNotebook",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    }
  ]
}

Bulk move items with the workspace as the destination example

Permintaan sampel

HTTP

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

{
  "items": [
    "cccccccc-2222-3333-4444-dddddddddddd",
    "dddddddd-3333-4444-5555-eeeeeeeeeeee"
  ]
}

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "displayName": "MyLakehouse",
      "description": "A lakehouse used by the sales team.",
      "type": "Lakehouse",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    },
    {
      "id": "eeeeeeee-4444-5555-6666-ffffffffffff",
      "displayName": "MyLakehouse",
      "description": "A SQL endpoint who is the child of Lakehouse",
      "type": "SQLEndpoint",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    },
    {
      "id": "ffffffff-5555-6666-7777-aaaaaaaaaaaa",
      "displayName": "MyLakehouse",
      "description": "A Semantic model who is the child of SQLEndpoint",
      "type": "SemanticModel",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    },
    {
      "id": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
      "displayName": "Notebook",
      "description": "A notebook for refining year 2024 sales data analysis through machine learning algorithms.",
      "type": "SynapseNotebook",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    }
  ]
}

Definisi

Nama	Deskripsi
BulkMoveItemsRequest	Permintaan item pemindahan massal.
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.
MovedItems

BulkMoveItemsRequest

Objek

Permintaan item pemindahan massal.

Nama	Jenis	Deskripsi
items	string[] (uuid)	ID item yang diminta untuk dipindahkan.
targetFolderId	string (uuid)	ID folder tujuan. Jika tidak disediakan, ruang kerja digunakan sebagai folder tujuan.

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

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.

MovedItems

Objek

Nama	Jenis	Deskripsi
value	Item[]	Daftar item.

Bagikan melalui

Items - Bulk Move Items

Permissions

Cakupan yang Didelegasikan yang Diperlukan

Keterbatasan

Identitas yang didukung oleh Microsoft Entra

Antarmuka

Parameter URI

Isi Permintaan

Respons

Contoh

Bulk move items into folder example

Permintaan sampel

Respon sampel

Bulk move items with the workspace as the destination example

Permintaan sampel

Respon sampel

Definisi

BulkMoveItemsRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

Item

ItemTag

ItemType

MovedItems