Udostępnij przez

Items - Move Item

Usługa:
Core
Wersja API:
v1

Przenieś określony element do folderu w tym samym obszarze roboczym. Elementy podrzędne są przenoszone z elementem nadrzędnym. Nie można przenieść elementu podrzędnego bez jego elementu nadrzędnego.

Uwaga / Notatka

Ten interfejs API jest częścią wersji zapoznawczej i jest dostarczany tylko do celów ewaluacyjnych i programistycznych. Może ona ulec zmianie na podstawie opinii i nie jest zalecana do użytku produkcyjnego.

Permissions

Obiekt wywołujący musi mieć rolę współautora lub wyższą w obszarze roboczym.

Wymagane zakresy delegowane

Przestrzeń robocza.OdczytZapis.Wszystko

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Tożsamość Support
User Tak
Główne usługi i Tożsamości zarządzane Tak

Interfejs

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

Parametry URI

Nazwa W Wymagane Typ Opis
itemId
 path True

string (uuid)

Identyfikator elementu.
workspaceId
 path True

string (uuid)

Identyfikator przestrzeni roboczej.

Ciało żądania

Nazwa Typ Opis
targetFolderId

string (uuid)

Identyfikator folderu docelowego. Jeśli nie zostanie podany, obszar roboczy będzie używany jako folder docelowy.

Odpowiedzi

Nazwa Typ Opis
200 OK

MovedItems

Żądanie zostało ukończone pomyślnie.
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • ItemNotFound — żądany element nie został znaleziony.

  • FolderNotFound — nie można odnaleźć żądanego folderu.

  • CannotMoveChildOnly — element podrzędny nie może zostać przeniesiony bez elementu nadrzędnego.

Przykłady

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

Move an item into folder example

Przykładowa prośba

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

Przykładowa odpowiedź

Kod statusu:
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

Przykładowa prośba

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

{}

Przykładowa odpowiedź

Kod statusu:
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"
    }
  ]
}

Definicje

Nazwa Opis
ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.
Item

Obiekt elementu.
ItemTag

Reprezentuje tag zastosowany w elemencie.
ItemType

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.
MovedItems
MoveItemRequest

Żądanie przeniesienia elementu.

ErrorRelatedResource

Sprzeciwiać się

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Sprzeciwiać się

Odpowiedź na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Sprzeciwiać się

Szczegóły odpowiedzi na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

Item

Sprzeciwiać się

Obiekt elementu.

Nazwa Typ Opis
description

string

Opis elementu.
displayName

string

Nazwa wyświetlana elementu.
folderId

string (uuid)

Identyfikator folderu.
id

string (uuid)

Identyfikator elementu.
tags

ItemTag[]

Lista zastosowanych tagów.
type

ItemType

Typ elementu.
workspaceId

string (uuid)

Identyfikator przestrzeni roboczej.

ItemTag

Sprzeciwiać się

Reprezentuje tag zastosowany w elemencie.

Nazwa Typ Opis
displayName

string

Nazwa znacznika.
id

string (uuid)

Identyfikator tagu.

ItemType

Wyliczenie

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.

Wartość Opis
Dashboard

Pulpit nawigacyjny usługi Power BI.
Report

Raport usługi Power BI.
SemanticModel

Model semantyczny usługi PowerBI.
PaginatedReport

Raport podzielony na strony usługi PowerBI.
Datamart

Datamart usługi Power BI.
Lakehouse

Jezioro.
Eventhouse

Magazyn zdarzeń.
Environment

Środowisko.
KQLDatabase

Baza danych KQL.
KQLQueryset

Zestaw zapytań KQL.
KQLDashboard

Pulpit nawigacyjny KQL.
DataPipeline

Potok danych.
Notebook

Notes.
SparkJobDefinition

Definicja zadania platformy Spark.
MLExperiment

Eksperyment uczenia maszynowego.
MLModel

Model uczenia maszynowego.
Warehouse

Magazyn.
Eventstream

Strumień zdarzeń.
SQLEndpoint

Punkt końcowy SQL.
MirroredWarehouse

Dublowany magazyn.
MirroredDatabase

Dublowana baza danych.
Reflex

Refleks.
GraphQLApi

Interfejs API dla elementu GraphQL.
MountedDataFactory

A MountedDataFactory.
SQLDatabase

Baza danych SQLDatabase.
CopyJob

Zadanie kopiowania.
VariableLibrary

ZmiennaLibrary.
Dataflow

Przepływ danych.
ApacheAirflowJob

Zadanie ApacheAirflowJob.
WarehouseSnapshot

Migawka magazynu.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Przepływ usługi Digital Twin Builder.
MirroredAzureDatabricksCatalog

Dublowany wykaz usługi Azure Databricks.
Map

Mapa.
AnomalyDetector

Wykrywacz anomalii.
UserDataFunction

Funkcja danych użytkownika.
GraphModel

Model programu Graph.
GraphQuerySet

Zestaw zapytań programu Graph.
SnowflakeDatabase

Baza danych Snowflake do przechowywania tabel góry lodowej utworzonych na podstawie konta Snowflake.
OperationsAgent

A OperationsAgent.
CosmosDBDatabase

Baza danych usługi Cosmos DB.
Ontology

Ontologia.
EventSchemaSet

An EventSchemaSet.

MovedItems

Sprzeciwiać się
Nazwa Typ Opis
value

Item[]

Lista elementów.

MoveItemRequest

Sprzeciwiać się

Żądanie przeniesienia elementu.

Nazwa Typ Opis
targetFolderId

string (uuid)

Identyfikator folderu docelowego. Jeśli nie zostanie podany, obszar roboczy będzie używany jako folder docelowy.