Delen via


Items - Bulk Move Items

Meerdere items naar een map verplaatsen. Onderliggende items worden verplaatst met hun bovenliggende items. U kunt onderliggende items niet verplaatsen zonder hun bovenliggende items.

Opmerking

Deze API maakt deel uit van een preview-versie en is alleen beschikbaar voor evaluatie- en ontwikkelingsdoeleinden. Het kan veranderen op basis van feedback en wordt niet aanbevolen voor productiegebruik.

Permissions

De beller moet inzender of een hogere rol hebben in de werkruimte.

Vereiste gedelegeerde bereiken

Workspace.ReadWrite.All

Beperkingen

Eén aanvraag mag niet meer dan 50 items bevatten.

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.

Identiteit Support
User Yes
serviceprincipal en beheerde identiteiten Yes

gebruikersinterface

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

URI-parameters

Name In Vereist Type Description
workspaceId
path True

string (uuid)

De werkruimte-ID.

Aanvraagbody

Name Vereist Type Description
items True

string[] (uuid)

De id's van aangevraagde items die moeten worden verplaatst.

targetFolderId

string (uuid)

De doelmap-id. Als deze niet is opgegeven, wordt de werkruimte gebruikt als de doelmap.

Antwoorden

Name Type Description
200 OK

MovedItems

De aanvraag is voltooid en alle items worden verplaatst.

Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

  • ItemNotFound : het aangevraagde item is niet gevonden.

  • FolderNotFound - Kan de aangevraagde map niet vinden.

  • CannotMoveChildOnly - Onderliggend item kan niet worden verplaatst zonder het bovenliggende item.

Als de aanvraag is mislukt, worden er geen items verplaatst.

Voorbeelden

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

Bulk move items into folder example

Voorbeeldaanvraag

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

Voorbeeldrespons

{
  "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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
BulkMoveItemsRequest

Aanvraag voor bulksgewijs verplaatsen van items.

ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.

ErrorResponse

Het foutbericht.

ErrorResponseDetails

De details van het foutbericht.

Item

Een itemobject.

ItemTag

Vertegenwoordigt een tag die is toegepast op een item.

ItemType

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

MovedItems

BulkMoveItemsRequest

Aanvraag voor bulksgewijs verplaatsen van items.

Name Type Description
items

string[] (uuid)

De id's van aangevraagde items die moeten worden verplaatst.

targetFolderId

string (uuid)

De doelmap-id. Als deze niet is opgegeven, wordt de werkruimte gebruikt als de doelmap.

ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.

Name Type Description
resourceId

string

De resource-id die betrokken is bij de fout.

resourceType

string

Het type resource dat betrokken is bij de fout.

ErrorResponse

Het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.

message

string

Een leesbare weergave van de fout.

moreDetails

ErrorResponseDetails[]

Lijst met aanvullende foutdetails.

relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.

requestId

string

Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

De details van het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.

message

string

Een leesbare weergave van de fout.

relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.

Item

Een itemobject.

Name Type Description
description

string

De beschrijving van het item.

displayName

string

De weergavenaam van het item.

folderId

string (uuid)

De map-id.

id

string (uuid)

De item-id.

tags

ItemTag[]

Lijst met toegepaste tags.

type

ItemType

Het itemtype.

workspaceId

string (uuid)

De werkruimte-ID.

ItemTag

Vertegenwoordigt een tag die is toegepast op een item.

Name Type Description
displayName

string

De naam van de tag.

id

string (uuid)

De tag-id.

ItemType

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde Description
Dashboard

PowerBI-dashboard.

Report

PowerBI-rapport.

SemanticModel

Semantisch Power BI-model.

PaginatedReport

Gepagineerd Power BI-rapport.

Datamart

PowerBI-datamart.

Lakehouse

Een lakehouse.

Eventhouse

Een eventhouse.

Environment

Een omgeving.

KQLDatabase

Een KQL-database.

KQLQueryset

Een KQL-queryset.

KQLDashboard

Een KQL-dashboard.

DataPipeline

Een gegevenspijplijn.

Notebook

Een notitieblok.

SparkJobDefinition

Een Spark-taakdefinitie.

MLExperiment

Een machine learning-experiment.

MLModel

Een machine learning-model.

Warehouse

Een magazijn.

Eventstream

Een eventstream.

SQLEndpoint

Een SQL-eindpunt.

MirroredWarehouse

Een gespiegeld magazijn.

MirroredDatabase

Een gespiegelde database.

Reflex

Een reflex.

GraphQLApi

Een API voor GraphQL-item.

MountedDataFactory

Een MountedDataFactory.

SQLDatabase

Een SQLDatabase.

CopyJob

Een kopieertaak.

VariableLibrary

Een VariableLibrary.

Dataflow

Een gegevensstroom.

ApacheAirflowJob

Een ApacheAirflowJob.

WarehouseSnapshot

Een momentopname van een magazijn.

DigitalTwinBuilder

Een DigitalTwinBuilder.

DigitalTwinBuilderFlow

Een Digital Twin Builder Flow.

MirroredAzureDatabricksCatalog

Een gespiegelde Azure Databricks-catalogus.

Map

Een kaart.

AnomalyDetector

Een Anomaly Detector.

UserDataFunction

Een gebruikersgegevensfunctie.

GraphModel

Een GraphModel.

GraphQuerySet

Een Graph QuerySet.

SnowflakeDatabase

Een Snowflake-database voor het opslaan van Iceberg-tabellen die zijn gemaakt op basis van het Snowflake-account.

OperationsAgent

Een OperationsAgent.

CosmosDBDatabase

Een Cosmos DB-database.

Ontology

Een Ontologie.

EventSchemaSet

Een EventSchemaSet.

MovedItems

Name Type Description
value

Item[]

Een lijst met items.