Items - Bulk Move Items

サービス:: Core

API バージョン:: v1

複数のアイテムを 1 つのフォルダーに移動します。子項目は、親アイテムと共に移動されます。子項目を親項目なしで移動することはできません。

注

この API はプレビューリリースの一部であり、評価と開発のみを目的として提供されます。フィードバックに基づいて変更される可能性があり、運用環境での使用はお勧めしません。

Permissions

呼び出し元には、ワークスペースに 対する共同作成者 以上のロールが必要です。

必要な委任されたスコープ

Workspace.ReadWrite.All

制限事項

1 つの要求に 50 個を超えるアイテムを含めることはできません。

サポートされている ID をMicrosoft Entraする

この API では、このセクションに記載されている Microsoft identities がサポートされています。

アイデンティティ	Support
User	イエス
サービスプリンシパルとマネージド ID	イエス

インターフェイス

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

URI パラメーター

名前	/	必須	型	説明
workspaceId	path	True	string (uuid)	ワークスペース ID。

要求本文

名前	必須	型	説明
items	True	string[] (uuid)	移動する要求された項目の ID。
targetFolderId		string (uuid)	移動先フォルダー ID。指定しない場合、ワークスペースは移動先フォルダーとして使用されます。

応答

名前型説明

200 OK

名前	型	説明
200 OK	MovedItems	要求は正常に完了し、すべての項目が移動されます。
429 Too Many Requests	ErrorResponse	サービスレートの制限を超えました。サーバーは、クライアントが追加の要求を送信するまでに待機する必要がある時間を秒単位で示す `Retry-After` ヘッダーを返します。ヘッダー Retry-After: integer
Other Status Codes	ErrorResponse	一般的なエラーコード: ItemNotFound - 要求された項目が見つかりませんでした。 FolderNotFound - 要求されたフォルダーが見つかりませんでした。 CannotMoveChildOnly - 子項目は、親項目なしで移動できません。要求に失敗した場合、項目は移動されません。

MovedItems

要求は正常に完了し、すべての項目が移動されます。

429 Too Many Requests

ErrorResponse

サービスレートの制限を超えました。サーバーは、クライアントが追加の要求を送信するまでに待機する必要がある時間を秒単位で示す Retry-After ヘッダーを返します。

ヘッダー

Retry-After: integer

Other Status Codes

ErrorResponse

一般的なエラーコード:

ItemNotFound - 要求された項目が見つかりませんでした。
FolderNotFound - 要求されたフォルダーが見つかりませんでした。
CannotMoveChildOnly - 子項目は、親項目なしで移動できません。

要求に失敗した場合、項目は移動されません。

例

Bulk move items into folder example

Bulk move items with the workspace as the destination example

Bulk move items into folder example

要求のサンプル

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"
  ]
}

応答のサンプル

状態コード:: 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

要求のサンプル

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"
  ]
}

応答のサンプル

状態コード:: 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"
    }
  ]
}

定義

名前	説明
BulkMoveItemsRequest	アイテムの一括移動要求。
EntireTenantPrincipal	テナントプリンシパルを表します
ErrorRelatedResource	エラー関連のリソース詳細オブジェクト。
ErrorResponse	エラー応答。
ErrorResponseDetails	エラー応答の詳細。
GroupDetails	グループ固有の詳細。プリンシパルの種類が `Group`場合に適用されます。
GroupPrincipal	セキュリティグループを表します。
GroupType	グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。
Item	項目オブジェクト。
ItemTag	アイテムに適用されるタグを表します。
ItemType	アイテムの種類。追加の項目の種類は、時間の経過と同時に追加される場合があります。
MovedItems
PrincipalType	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。
SensitivityLabel	アイテムに適用される秘密度ラベルを表します。
ServicePrincipalDetails	サービスプリンシパル固有の詳細。プリンシパルの種類が `ServicePrincipal`場合に適用されます。
ServicePrincipalPrincipal	Microsoft Entra サービスプリンシパルを表します。
ServicePrincipalProfileDetails	サービスプリンシパルプロファイルの詳細。プリンシパルの種類が `ServicePrincipalProfile`場合に適用されます。
ServicePrincipalProfilePrincipal	サービスプリンシパルプロファイルを表します。
UserDetails	ユーザープリンシパル固有の詳細。プリンシパルの種類が `User`場合に適用されます。
UserPrincipal	Microsoft Entra ユーザープリンシパルを表します。

BulkMoveItemsRequest

Object

アイテムの一括移動要求。

名前	型	説明
items	string[] (uuid)	移動する要求された項目の ID。
targetFolderId	string (uuid)	移動先フォルダー ID。指定しない場合、ワークスペースは移動先フォルダーとして使用されます。

EntireTenantPrincipal

Object

テナントプリンシパルを表します

名前	型	説明
displayName	string	プリンシパルの表示名。
id	string (uuid)	プリンシパルの ID。
type	string: EntireTenant	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。

ErrorRelatedResource

Object

エラー関連のリソース詳細オブジェクト。

名前	型	説明
resourceId	string	エラーに関係するリソース ID。
resourceType	string	エラーに関係するリソースの種類。

ErrorResponse

Object

エラー応答。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
moreDetails	ErrorResponseDetails[]	その他のエラーの詳細の一覧。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。
requestId	string (uuid)	エラーに関連付けられている要求の ID。

ErrorResponseDetails

Object

エラー応答の詳細。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。

GroupDetails

Object

グループ固有の詳細。プリンシパルの種類が Group場合に適用されます。

名前	型	説明
groupType	GroupType	グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。

GroupPrincipal

Object

セキュリティグループを表します。

名前	型	説明
displayName	string	プリンシパルの表示名。
groupDetails	GroupDetails	グループ固有の詳細。プリンシパルの種類が `Group`場合に適用されます。
id	string (uuid)	プリンシパルの ID。
type	string: Group	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。

GroupType

列挙

グループの種類。グループの種類は、時間の経過と同時に追加される場合があります。

値	説明
Unknown	プリンシパルグループの種類が不明です。
SecurityGroup	プリンシパルはセキュリティグループです。
DistributionList	プリンシパルは配布リストです。

Item

Object

項目オブジェクト。

名前	型	説明
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	アイテムの既定の ID。
description	string	アイテムの説明。
displayName	string	アイテムの表示名。
folderId	string (uuid)	フォルダー ID。
id	string (uuid)	アイテム ID。
sensitivityLabel	SensitivityLabel	項目の秘密度ラベル。
tags	ItemTag[]	適用されたタグの一覧。
type	ItemType	項目の種類。
workspaceId	string (uuid)	ワークスペース ID。

ItemTag

Object

アイテムに適用されるタグを表します。

名前	型	説明
displayName	string	タグの名前。
id	string (uuid)	タグ ID。

ItemType

列挙

アイテムの種類。追加の項目の種類は、時間の経過と同時に追加される場合があります。

値	説明
Dashboard	PowerBI ダッシュボード。
Report	PowerBI レポート。
SemanticModel	PowerBI セマンティックモデル。
PaginatedReport	PowerBI のページ分割されたレポート。
Datamart	PowerBI データマート。
Lakehouse	レイクハウス。
Eventhouse	イベントハウス。
Environment	環境。
KQLDatabase	KQL データベース。
KQLQueryset	KQL クエリセット。
KQLDashboard	KQL ダッシュボード。
DataPipeline	データパイプライン。
Notebook	ノートブック。
SparkJobDefinition	Spark ジョブ定義。
MLExperiment	機械学習の実験。
MLModel	機械学習モデル。
Warehouse	倉庫。
Eventstream	イベントストリーム。
SQLEndpoint	SQL エンドポイント。
MirroredWarehouse	ミラー化された倉庫。
MirroredDatabase	ミラー化されたデータベース。
Reflex	反射。
GraphQLApi	GraphQL 項目の API。
MountedDataFactory	MountedDataFactory。
SQLDatabase	SQLDatabase。
CopyJob	コピージョブ。
VariableLibrary	VariableLibrary。
Dataflow	データフロー。
ApacheAirflowJob	ApacheAirflowJob。
WarehouseSnapshot	Warehouse スナップショット。
DigitalTwinBuilder	DigitalTwinBuilder。
DigitalTwinBuilderFlow	デジタルツインビルダーフロー。
MirroredAzureDatabricksCatalog	ミラー化された Azure databricks カタログ。
Map	マップ。
AnomalyDetector	Anomaly Detector。
UserDataFunction	ユーザーデータ関数。
GraphModel	GraphModel。
GraphQuerySet	Graph QuerySet。
SnowflakeDatabase	Snowflake アカウントから作成された Iceberg テーブルを格納する Snowflake データベース。
OperationsAgent	OperationsAgent。
CosmosDBDatabase	Cosmos DB データベース。
Ontology	オントロジ。
EventSchemaSet	EventSchemaSet。
DataAgent	DataAgent。

MovedItems

Object

名前	型	説明
value	Item[]	項目の一覧。

PrincipalType

列挙

プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。

値	説明
User	プリンシパルは、Microsoft Entraユーザープリンシパルです。
ServicePrincipal	プリンシパルは、Microsoft Entraサービスプリンシパルです。
Group	プリンシパルはセキュリティグループです。
ServicePrincipalProfile	プリンシパルはサービスプリンシパルプロファイルです。
EntireTenant	プリンシパルは、すべてのテナントユーザーを表します。

SensitivityLabel

Object

アイテムに適用される秘密度ラベルを表します。

名前	型	説明
id	string (uuid)	秘密度ラベル ID。

ServicePrincipalDetails

Object

サービスプリンシパル固有の詳細。プリンシパルの種類が ServicePrincipal場合に適用されます。

名前	型	説明
aadAppId	string (uuid)	サービスプリンシパルの Microsoft Entra AppId。

ServicePrincipalPrincipal

Object

Microsoft Entra サービスプリンシパルを表します。

名前	型	説明
displayName	string	プリンシパルの表示名。
id	string (uuid)	プリンシパルの ID。
servicePrincipalDetails	ServicePrincipalDetails	サービスプリンシパル固有の詳細。プリンシパルの種類が `ServicePrincipal`場合に適用されます。
type	string: ServicePrincipal	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。

ServicePrincipalProfileDetails

Object

サービスプリンシパルプロファイルの詳細。プリンシパルの種類が ServicePrincipalProfile場合に適用されます。

名前	型	説明
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	サービスプリンシパルプロファイルの親プリンシパル。

ServicePrincipalProfilePrincipal

Object

サービスプリンシパルプロファイルを表します。

名前	型	説明
displayName	string	プリンシパルの表示名。
id	string (uuid)	プリンシパルの ID。
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	サービスプリンシパルプロファイルの詳細。プリンシパルの種類が `ServicePrincipalProfile`場合に適用されます。
type	string: ServicePrincipalProfile	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。

UserDetails

Object

ユーザープリンシパル固有の詳細。プリンシパルの種類が User場合に適用されます。

名前	型	説明
userPrincipalName	string	ユーザープリンシパル名。

UserPrincipal

Object

Microsoft Entra ユーザープリンシパルを表します。

名前	型	説明
displayName	string	プリンシパルの表示名。
id	string (uuid)	プリンシパルの ID。
type	string: User	プリンシパルの型。プリンシパルの種類は、時間の経過と同時に追加される場合があります。
userDetails	UserDetails	ユーザープリンシパル固有の詳細。プリンシパルの種類が `User`場合に適用されます。

次の方法で共有

Items - Bulk Move Items

Permissions

必要な委任されたスコープ

制限事項

サポートされている ID をMicrosoft Entraする

インターフェイス

URI パラメーター

要求本文

応答

例

Bulk move items into folder example

要求のサンプル

応答のサンプル

Bulk move items with the workspace as the destination example

要求のサンプル

応答のサンプル

定義

BulkMoveItemsRequest

EntireTenantPrincipal

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupPrincipal

GroupType

Item

ItemTag

ItemType

MovedItems

PrincipalType

SensitivityLabel

ServicePrincipalDetails

ServicePrincipalPrincipal

ServicePrincipalProfileDetails

ServicePrincipalProfilePrincipal

UserDetails

UserPrincipal