Sdílet prostřednictvím

Items - Bulk Move Items

Služba:
Core
Verze rozhraní API:
v1

Přesunutí více položek do složky Podřízené položky se přesunou s nadřazenými položkami. Podřízené položky nemůžete přesouvat bez nadřazených položek.

Poznámka:

Toto rozhraní API je součástí verze Preview a poskytuje se pouze pro účely vyhodnocení a vývoje. Může se změnit na základě zpětné vazby a nedoporučuje se pro produkční použití.

Povolení

Volající musí mít v pracovním prostoru roli přispěvatele nebo vyšší.

Požadované delegovaná rozsahy

Workspace.ReadWrite.All

Omezení

Jeden požadavek nemůže obsahovat více než 50 položek.

Podporované identity v Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita Support
Uživatel Ano
Hlavní služba a Spravované identity Ano

Rozhraní

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
workspaceId
 path True

string (uuid)

Identifikátor pracovního prostoru.

Text požadavku

Name Vyžadováno Typ Description
items True

string[] (uuid)

ID požadovaných položek k přesunutí
targetFolderId

string (uuid)

ID cílové složky. Pokud není zadaný, použije se pracovní prostor jako cílová složka.

Odpovědi

Name Typ Description
200 OK

MovedItems

Žádost byla úspěšně dokončena a všechny položky se přesunou.
Other Status Codes

ErrorResponse

Běžné kódy chyb:

  • ItemNotFound – Požadovaná položka nebyla nalezena.

  • FolderNotFound – Požadovanou složku se nepodařilo najít.

  • CannotMoveChildOnly – Podřízenou položku nelze přesunout bez nadřazené položky.

Pokud požadavek selhal, nepřesouvají se žádné položky.

Příklady

Bulk move items into folder example
Bulk move items with the workspace as the destination example

Bulk move items into folder example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
    }
  ]
}

Definice

Name Description
BulkMoveItemsRequest

Žádost o hromadné přesunutí položek
ErrorRelatedResource

Chyba související s objektem podrobností o prostředku.
ErrorResponse

Odpověď na chybu.
ErrorResponseDetails

Podrobnosti o odpovědi na chybu.
Item

Objekt položky.
ItemTag

Představuje značku použitou u položky.
ItemType

Typ položky. V průběhu času je možné přidat další typy položek.
MovedItems

BulkMoveItemsRequest

Objekt

Žádost o hromadné přesunutí položek

Name Typ Description
items

string[] (uuid)

ID požadovaných položek k přesunutí
targetFolderId

string (uuid)

ID cílové složky. Pokud není zadaný, použije se pracovní prostor jako cílová složka.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name Typ Description
resourceId

string

ID prostředku, které je součástí chyby.
resourceType

string

Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
moreDetails

ErrorResponseDetails[]

Seznam dalších podrobností o chybě
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou
requestId

string

ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou

Item

Objekt

Objekt položky.

Name Typ Description
description

string

Popis položky.
displayName

string

Zobrazovaný název položky.
folderId

string (uuid)

ID složky.
id

string (uuid)

ID položky.
tags

ItemTag[]

Seznam použitých značek
type

ItemType

Typ položky.
workspaceId

string (uuid)

Identifikátor pracovního prostoru.

ItemTag

Objekt

Představuje značku použitou u položky.

Name Typ Description
displayName

string

Název značky.
id

string (uuid)

ID značky.

ItemType

Výčet

Typ položky. V průběhu času je možné přidat další typy položek.

Hodnota Description
Dashboard

Řídicí panel PowerBI
Report

Sestava PowerBI
SemanticModel

Sémantický model PowerBI
PaginatedReport

Stránkovaná sestava PowerBI
Datamart

Datový diagram PowerBI
Lakehouse

Jezero.
Eventhouse

Eventhouse.
Environment

Prostředí.
KQLDatabase

Databáze KQL.
KQLQueryset

Sada dotazů KQL.
KQLDashboard

Řídicí panel KQL.
DataPipeline

Datový kanál.
Notebook

Poznámkový blok.
SparkJobDefinition

Definice úlohy Sparku.
MLExperiment

Experiment strojového učení.
MLModel

Model strojového učení.
Warehouse

Sklad.
Eventstream

Eventstream.
SQLEndpoint

Koncový bod SQL.
MirroredWarehouse

Zrcadlený sklad.
MirroredDatabase

Zrcadlené databáze.
Reflex

A Reflex.
GraphQLApi

Rozhraní API pro položku GraphQL
MountedDataFactory

A MountedDataFactory.
SQLDatabase

Databáze SQLDatabase.
CopyJob

Úloha kopírování.
VariableLibrary

ProměnnáLibrary.
Dataflow

Tok dat.
ApacheAirflowJob

An ApacheAirflowJob.
WarehouseSnapshot

Snímek skladu.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Tok digitálního dvojčete.
MirroredAzureDatabricksCatalog

Zrcadlený katalog Azure Databricks.
Map

Mapa.
AnomalyDetector

Detektor anomálií.
UserDataFunction

Funkce uživatelských dat.
GraphModel

A GraphModel.
GraphQuerySet

Sada dotazů grafu.
SnowflakeDatabase

Snowflake Database pro ukládání tabulek Iceberg vytvořených z účtu Snowflake.
OperationsAgent

A OperationsAgent.
CosmosDBDatabase

Databáze Cosmos DB.
Ontology

Ontologie.
EventSchemaSet

An EventSchemaSet.

MovedItems

Objekt
Name Typ Description
value

Item[]

Seznam položek