Sdílet prostřednictvím

Items - Move Item

Služba:
Core
Verze rozhraní API:
v1

Přesuňte zadanou položku do složky ve stejném pracovním prostoru. Podřízené položky se přesunou s nadřazenou položkou. Podřízenou položku nelze přesunout bez nadřazené položky.

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

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/{itemId}/move

Parametry identifikátoru URI

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

string (uuid)

ID položky.
workspaceId
 path True

string (uuid)

Identifikátor pracovního prostoru.

Text požadavku

Name Typ Description
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.
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.

Příklady

Move an item into folder example
Move an item with the workspace as the destination example

Move an item into folder example

Ukázkový požadavek

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items/cccccccc-2222-3333-4444-dddddddddddd/move

{
  "targetFolderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
}

Ukázková odpověď

Stavový kód:
200 
{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "type": "Lakehouse",
      "displayName": "MyLakehouse",
      "description": "A lakehouse used by the sales team.",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    },
    {
      "id": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
      "type": "SQLEndpoint",
      "displayName": "MyLakehouse",
      "description": null,
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    }
  ]
}

Move an item 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/cccccccc-2222-3333-4444-dddddddddddd/move

{}

Ukázková odpověď

Stavový kód:
200 
{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "type": "Lakehouse",
      "displayName": "MyLakehouse",
      "description": "A lakehouse used by the sales team.",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    },
    {
      "id": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
      "type": "SQLEndpoint",
      "displayName": "MyLakehouse",
      "description": null,
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    }
  ]
}

Definice

Name Description
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
MoveItemRequest

Přesunout žádost o položku

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

MoveItemRequest

Objekt

Přesunout žádost o položku

Name Typ Description
targetFolderId

string (uuid)

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