Items - Bulk Move Items

Szolgáltatás:: Core

API-verzió:: v1

Több elem áthelyezése mappába. A gyermekelemek a szülőelemekkel együtt lesznek áthelyezve. A gyermekelemek nem helyezhetők át a szülőelemeik nélkül.

Megjegyzés:

Ez az API egy előzetes kiadás része, és csak kiértékelési és fejlesztési célokra érhető el. A visszajelzések alapján változhat, és éles használatra nem ajánlott.

Permissions

A hívónak közreműködői vagy magasabb szerepkörűnek kell lennie a munkaterületen.

Kötelező delegált hatókörök

Workspace.ReadWrite.All

Korlátozások

Egyetlen kérelem legfeljebb 50 elemet tartalmazhat.

Microsoft Entra támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft dentitásokat.

Személyazonosság	Support
User	Igen
szolgáltatás-princípium és felügyelt identitások	Igen

Interfész

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.

Kérelem törzse

Name	Kötelező	Típus	Description
items	True	string[] (uuid)	Az áthelyezni kívánt elemek azonosítói.
targetFolderId		string (uuid)	A célmappa azonosítója. Ha nincs megadva, a munkaterület lesz a célmappa.

Válaszok

Name Típus Description

200 OK

Name	Típus	Description
200 OK	MovedItems	A kérelem sikeresen befejeződött, és az összes elem át lesz helyezve.
429 Too Many Requests	ErrorResponse	Túllépte a szolgáltatási sebesség korlátját. A kiszolgáló egy `Retry-After` fejlécet ad vissza másodpercek alatt, amely jelzi, hogy az ügyfélnek mennyi ideig kell várnia a további kérések elküldése előtt. Fejlécek Retry-After: integer
Other Status Codes	ErrorResponse	Gyakori hibakódok: ItemNotFound – A kért elem nem található. FolderNotFound – Nem található a kért mappa. CannotMoveChildOnly – A gyermekelem nem helyezhető át a szülőelem nélkül. Ha a kérés nem sikerült, a rendszer nem helyez át elemeket.

MovedItems

A kérelem sikeresen befejeződött, és az összes elem át lesz helyezve.

429 Too Many Requests

ErrorResponse

Túllépte a szolgáltatási sebesség korlátját. A kiszolgáló egy Retry-After fejlécet ad vissza másodpercek alatt, amely jelzi, hogy az ügyfélnek mennyi ideig kell várnia a további kérések elküldése előtt.

Fejlécek

Retry-After: integer

Other Status Codes

ErrorResponse

Gyakori hibakódok:

ItemNotFound – A kért elem nem található.
FolderNotFound – Nem található a kért mappa.
CannotMoveChildOnly – A gyermekelem nem helyezhető át a szülőelem nélkül.

Ha a kérés nem sikerült, a rendszer nem helyez át elemeket.

Példák

Bulk move items into folder example

Bulk move items with the workspace as the destination example

Bulk move items into folder example

Mintakérelem

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

Mintaválasz

Állapotkó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

Mintakérelem

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

Mintaválasz

Állapotkó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"
    }
  ]
}

Definíciók

Name	Description
BulkMoveItemsRequest	Elemek tömeges áthelyezésére vonatkozó kérés.
EntireTenantPrincipal	Bérlői tagot jelöl
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
GroupDetails	Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus `Group`.
GroupPrincipal	Biztonsági csoportot jelöl.
GroupType	A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.
Item	Elemobjektum.
ItemTag	Egy elemre alkalmazott címkét jelöl.
ItemType	Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
MovedItems
PrincipalType	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.
SensitivityLabel	Egy elemre alkalmazott bizalmassági címkét jelöl.
ServicePrincipalDetails	A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipal`.
ServicePrincipalPrincipal	Egy Microsoft Entra szolgáltatásnevet jelöl.
ServicePrincipalProfileDetails	A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Szolgáltatásnév-profilt jelöl.
UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus `User`.
UserPrincipal	Egy Microsoft Entra felhasználónevet jelöl.

BulkMoveItemsRequest

Tárgy

Elemek tömeges áthelyezésére vonatkozó kérés.

Name	Típus	Description
items	string[] (uuid)	Az áthelyezni kívánt elemek azonosítói.
targetFolderId	string (uuid)	A célmappa azonosítója. Ha nincs megadva, a munkaterület lesz a célmappa.

EntireTenantPrincipal

Tárgy

Bérlői tagot jelöl

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
type	string: EntireTenant	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

ErrorRelatedResource

Tárgy

A hibával kapcsolatos erőforrás-részletek objektum.

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Tárgy

A hibaválasz.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
isRetriable	boolean	Ha igaz, a kérés újrapróbálkozott. Ha elérhető, a `Retry-After` válaszfejléc használatával állapítsa meg a késést.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string (uuid)	A hibához társított kérés azonosítója.

ErrorResponseDetails

Tárgy

A hibaválasz részletei.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

GroupDetails

Tárgy

Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus Group.

Name	Típus	Description
groupType	GroupType	A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.

GroupPrincipal

Tárgy

Biztonsági csoportot jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
groupDetails	GroupDetails	Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus `Group`.
id	string (uuid)	Az igazgató azonosítója.
type	string: Group	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

GroupType

Felsorolás

A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.

Érték	Description
Unknown	Az egyszerű csoport típusa ismeretlen.
SecurityGroup	Az egyszerű egy biztonsági csoport.
DistributionList	Az egyszerű egy terjesztési lista.

Item

Tárgy

Elemobjektum.

Name	Típus	Description
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Az elem alapértelmezett identitása.
description	string	Az elem leírása.
displayName	string	Az elem megjelenítendő neve.
folderId	string (uuid)	A mappa azonosítója.
id	string (uuid)	Az elem azonosítója.
sensitivityLabel	SensitivityLabel	Az elem bizalmassági címkéje.
tags	ItemTag[]	Az alkalmazott címkék listája.
type	ItemType	Az elem típusa.
workspaceId	string (uuid)	A munkaterület azonosítója.

ItemTag

Tárgy

Egy elemre alkalmazott címkét jelöl.

Name	Típus	Description
displayName	string	A címke neve.
id	string (uuid)	A címke azonosítója.

ItemType

Felsorolás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték	Description
Dashboard	PowerBI-irányítópult.
Report	PowerBI-jelentés.
SemanticModel	PowerBI szemantikai modell.
PaginatedReport	Többoldalas PowerBI-jelentés.
Datamart	PowerBI datamart.
Lakehouse	Egy tóház.
Eventhouse	Egy rendezvényház.
Environment	Egy környezet.
KQLDatabase	KQL-adatbázis.
KQLQueryset	KQL-lekérdezéskészlet.
KQLDashboard	KQL-irányítópult.
DataPipeline	Egy adatfolyam.
Notebook	Egy jegyzetfüzet.
SparkJobDefinition	Spark-feladat definíciója.
MLExperiment	Gépi tanulási kísérlet.
MLModel	Gépi tanulási modell.
Warehouse	Egy raktár.
Eventstream	Eseménystream.
SQLEndpoint	EGY SQL-végpont.
MirroredWarehouse	Egy tükrözött raktár.
MirroredDatabase	Tükrözött adatbázis.
Reflex	Egy reflex.
GraphQLApi	Api a GraphQL-elemhez.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Másolási feladat.
VariableLibrary	Egy VariableLibrary.
Dataflow	Adatfolyam.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Raktári pillanatkép.
DigitalTwinBuilder	Egy DigitalTwinBuilder.
DigitalTwinBuilderFlow	A Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	Tükrözött Azure Databricks-katalógus.
Map	Térkép.
AnomalyDetector	Anomáliadetektor.
UserDataFunction	Felhasználói adatfüggvény.
GraphModel	Egy GraphModel.
GraphQuerySet	Egy Graph Queryset.
SnowflakeDatabase	Snowflake-adatbázis a Snowflake-fiókból létrehozott Iceberg-táblák tárolására.
OperationsAgent	Egy OperationsAgent.
CosmosDBDatabase	Cosmos DB-adatbázis.
Ontology	Egy ontológia.
EventSchemaSet	An EventSchemaSet.
DataAgent	Egy DataAgent.
MirroredCatalog	Tükrözöttcatalog.
AppBackend	Egy AppBackend.
OrgApp	Szervezeti alkalmazás.
OrgAppAudience	Szervezeti alkalmazás célközönsége.
DataBuildToolJob	Egy DataBuildToolJob.
AzureDatabricksStorage	OneLake-alapú tárolóelem Azure Databricks.
Plan	Egy terv.

MovedItems

Tárgy

Name	Típus	Description
value	Item[]	Elemek listája.

PrincipalType

Felsorolás

A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

Érték	Description
User	A rendszernév egy Microsoft Entra felhasználónév.
ServicePrincipal	Az egyszerű szolgáltatásnév egy Microsoft Entra szolgáltatásnév.
Group	Az egyszerű egy biztonsági csoport.
ServicePrincipalProfile	Az egyszerű szolgáltatásnév egy szolgáltatásnév-profil.
EntireTenant	Az egyszerűség az összes bérlőfelhasználót jelöli.

SensitivityLabel

Tárgy

Egy elemre alkalmazott bizalmassági címkét jelöl.

Name	Típus	Description
id	string (uuid)	A bizalmassági címke azonosítója.

ServicePrincipalDetails

Tárgy

A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus ServicePrincipal.

Name	Típus	Description
aadAppId	string (uuid)	A szolgáltatásnév Microsoft Entra AppId.

ServicePrincipalPrincipal

Tárgy

Egy Microsoft Entra szolgáltatásnevet jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
servicePrincipalDetails	ServicePrincipalDetails	A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipal`.
type	string: ServicePrincipal	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

ServicePrincipalProfileDetails

Tárgy

A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus ServicePrincipalProfile.

Name	Típus	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	A szolgáltatásnév-profil szülőnevét.

ServicePrincipalProfilePrincipal

Tárgy

Szolgáltatásnév-profilt jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

UserDetails

Tárgy

A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus User.

Name	Típus	Description
userPrincipalName	string	A felhasználói főnév.

UserPrincipal

Tárgy

Egy Microsoft Entra felhasználónevet jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
type	string: User	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.
userDetails	UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus `User`.