Items - Bulk Move Items

Μετακινεί πολλά στοιχεία σε έναν φάκελο. Τα θυγατρικά στοιχεία μετακινούνται με τα γονικά τους στοιχεία. Δεν μπορείτε να μετακινήσετε ένα θυγατρικό στοιχείο χωρίς το γονικό του στοιχείο.

Permissions

Ο καλών πρέπει να έχει συνεισφέροντα ή υψηλότερο ρόλο στον χώρο εργασίας.

Απαιτούμενες εμβέλειες με ανάθεση

Workspace.ReadWrite.All

Περιορισμοί

Μια μεμονωμένη αίτηση δεν μπορεί να περιέχει περισσότερα από 50 στοιχεία.

υποστηριζόμενες ταυτότητες Microsoft Entra

Αυτό το API υποστηρίζει το Microsoft identities που παρατίθεται σε αυτή την ενότητα.

Ταυτότητα Υποστήριξη
Χρήστης Ναι
Υπηρεσίας και διαχειριζόμενες ταυτότητες Ναι

Διεπαφή

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

Παράμετροι URI

Όνομα Σε Απαιτείται Τύπος Περιγραφή
workspaceId
path True

string (uuid)

Το αναγνωριστικό χώρου εργασίας.

Κυρίως τμήμα αίτησης

Όνομα Απαιτείται Τύπος Περιγραφή
items True

string[] (uuid)

Τα αναγνωριστικά των στοιχείων που ζητήθηκαν για μετακίνηση.

targetFolderId

string (uuid)

Το αναγνωριστικό φακέλου προορισμού. Εάν δεν παρέχεται, ο χώρος εργασίας χρησιμοποιείται ως φάκελος προορισμού.

Αποκρίσεις

Όνομα Τύπος Περιγραφή
200 OK

MovedItems

Η αίτηση ολοκληρώθηκε με επιτυχία και όλα τα στοιχεία μετακινήθηκαν.

429 Too Many Requests

ErrorResponse

Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια Retry-After κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων.

Κεφαλίδες

Retry-After: integer

Other Status Codes

ErrorResponse

Συνήθεις κωδικοί σφαλμάτων:

  • ItemNotFound - Το στοιχείο που ζητήθηκε δεν βρέθηκε.

  • FolderNotFound - Δεν ήταν δυνατή η εύρεση του φακέλου που ζητήθηκε.

  • CannotMoveChildOnly - Το θυγατρικό στοιχείο δεν μπορεί να μετακινηθεί χωρίς το γονικό του στοιχείο.

Εάν η αίτηση αποτύχει, δεν μετακινούνται στοιχεία.

Παραδείγματα

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

Bulk move items into folder example

Δείγμα αίτησης

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

Δείγμα απόκρισης

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

Δείγμα αίτησης

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

Δείγμα απόκρισης

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

Ορισμοί

Όνομα Περιγραφή
BulkMoveItemsRequest

Αίτηση μαζικής μετακίνησης στοιχείων.

EntireTenantPrincipal

Αντιπροσωπεύει μια αρχή μισθωτή

ErrorParameter

Μια δομημένη παράμετρος που παρέχει πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με ένα σφάλμα.

ErrorRelatedResource

Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.

ErrorResponse

Η απόκριση σφάλματος.

ErrorResponseDetails

Οι λεπτομέρειες της απόκρισης σφάλματος.

GroupDetails

Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι Group.

GroupPrincipal

Αντιπροσωπεύει μια ομάδα ασφαλείας.

GroupType

Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.

Item

Ένα αντικείμενο στοιχείου.

ItemTag

Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.

ItemType

Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.

MovedItems
PrincipalType

Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

SensitivityLabel

Αντιπροσωπεύει μια ετικέτα ευαισθησίας που έχει εφαρμοστεί σε ένα στοιχείο.

ServicePrincipalDetails

Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipal.

ServicePrincipalPrincipal

Αντιπροσωπεύει μια Microsoft Entra κύρια υπηρεσία.

ServicePrincipalProfileDetails

Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipalProfile.

ServicePrincipalProfilePrincipal

Αντιπροσωπεύει ένα προφίλ κύριας υπηρεσίας.

UserDetails

Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι User.

UserPrincipal

Αντιπροσωπεύει μια Microsoft Entra κύρια χρήστη.

BulkMoveItemsRequest

Αίτηση μαζικής μετακίνησης στοιχείων.

Όνομα Τύπος Περιγραφή
items

string[] (uuid)

Τα αναγνωριστικά των στοιχείων που ζητήθηκαν για μετακίνηση.

targetFolderId

string (uuid)

Το αναγνωριστικό φακέλου προορισμού. Εάν δεν παρέχεται, ο χώρος εργασίας χρησιμοποιείται ως φάκελος προορισμού.

EntireTenantPrincipal

Αντιπροσωπεύει μια αρχή μισθωτή

Όνομα Τύπος Περιγραφή
displayName

string

Το εμφανιζόμενο όνομα της κύριας.

id

string (uuid)

Το αναγνωριστικό του διευθυντή.

type string:

EntireTenant

Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

ErrorParameter

Μια δομημένη παράμετρος που παρέχει πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με ένα σφάλμα.

Όνομα Τύπος Περιγραφή
message

string

Μια αναγνώσιμη από τον άνθρωπο περιγραφή της έννοιας της παραμέτρου.

name

string

Το αναγνωριστικό παραμέτρου.

value

string

Η τιμή της παραμέτρου.

ErrorRelatedResource

Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.

Όνομα Τύπος Περιγραφή
resourceId

string

Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.

resourceType

string

Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Η απόκριση σφάλματος.

Όνομα Τύπος Περιγραφή
errorCode

string

Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.

isRetriable

boolean

Όταν είναι true, η αίτηση μπορεί να επαναληφθεί. Χρησιμοποιήστε την Retry-After κεφαλίδα απόκρισης για να προσδιορίσετε την καθυστέρηση, εάν υπάρχει.

message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.

moreDetails

ErrorResponseDetails[]

Λίστα πρόσθετων λεπτομερειών σφάλματος.

parameters

ErrorParameter[]

Δομημένες παράμετροι που παρέχουν πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με το σφάλμα.

relatedResource

ErrorRelatedResource

Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

requestId

string (uuid)

Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Οι λεπτομέρειες της απόκρισης σφάλματος.

Όνομα Τύπος Περιγραφή
errorCode

string

Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.

message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.

parameters

ErrorParameter[]

Δομημένες παράμετροι που παρέχουν πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με το σφάλμα.

relatedResource

ErrorRelatedResource

Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

GroupDetails

Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι Group.

Όνομα Τύπος Περιγραφή
groupType

GroupType

Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.

GroupPrincipal

Αντιπροσωπεύει μια ομάδα ασφαλείας.

Όνομα Τύπος Περιγραφή
displayName

string

Το εμφανιζόμενο όνομα της κύριας.

groupDetails

GroupDetails

Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι Group.

id

string (uuid)

Το αναγνωριστικό του διευθυντή.

type string:

Group

Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

GroupType

Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή Περιγραφή
Unknown

Ο κύριος τύπος ομάδας είναι άγνωστος.

SecurityGroup

Το Principal είναι μια ομάδα ασφαλείας.

DistributionList

Το Principal είναι μια λίστα διανομής.

Item

Ένα αντικείμενο στοιχείου.

Όνομα Τύπος Περιγραφή
defaultIdentity Principal:

Η προεπιλεγμένη ταυτότητα του στοιχείου.

description

string

Η περιγραφή του στοιχείου.

displayName

string

Το εμφανιζόμενο όνομα του στοιχείου.

folderId

string (uuid)

Το αναγνωριστικό φακέλου.

id

string (uuid)

Το αναγνωριστικό στοιχείου.

logicalId

string (uuid)

Το λογικό αναγνωριστικό του στοιχείου. Οι αντίστοιχες παρουσίες στοιχείων μοιράζονται το ίδιο λογικό αναγνωριστικό. Η τιμή είναι null όταν δεν έχει αντιστοιχιστεί λογικό αναγνωριστικό.

sensitivityLabel

SensitivityLabel

Η ετικέτα ευαισθησίας στοιχείου.

tags

ItemTag[]

Λίστα εφαρμοσμένων ετικετών.

type

ItemType

Ο τύπος στοιχείου.

workspaceId

string (uuid)

Το αναγνωριστικό χώρου εργασίας.

ItemTag

Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.

Όνομα Τύπος Περιγραφή
displayName

string

Το όνομα της ετικέτας.

id

string (uuid)

Το αναγνωριστικό ετικέτας.

ItemType

Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή Περιγραφή
Dashboard

Πίνακας εργαλείων του PowerBI.

Report

Αναφορά PowerBI.

SemanticModel

Σημασιολογικό μοντέλο PowerBI.

PaginatedReport

Σελιδοποιημένη αναφορά PowerBI.

Datamart

Datamart του PowerBI.

Lakehouse

Ένα λιμνοθάσπιτο.

Eventhouse

Μια εκδήλωση.

Environment

Ένα περιβάλλον.

KQLDatabase

Μια βάση δεδομένων KQL.

KQLQueryset

Ένα σύνολο ερωτημάτων KQL.

KQLDashboard

Ένας πίνακας εργαλείων KQL.

DataPipeline

Μια διοχέτευση δεδομένων.

Notebook

Ένα σημειωματάριο.

SparkJobDefinition

Ένας ορισμός εργασίας σπινθήρα.

MLExperiment

Ένα πείραμα εκμάθησης μηχανής.

MLModel

Ένα μοντέλο εκμάθησης μηχανής.

Warehouse

Μια αποθήκη.

Eventstream

Μια ροή συμβάντος.

SQLEndpoint

Ένα τελικό σημείο SQL.

MirroredWarehouse

Μια αποθήκη με κατοπτρικό καθρέφτη.

MirroredDatabase

Μια βάση δεδομένων κατοπτρισμού.

Reflex

Αντανακλαστικά.

GraphQLApi

Ένα API για το στοιχείο GraphQL.

MountedDataFactory

A MountedDataFactory.

SQLDatabase

Μια βάση δεδομένων SQL.

CopyJob

Μια εργασία αντιγραφής.

VariableLibrary

Μια μεταβλητήLibrary.

Dataflow

Μια ροή δεδομένων.

ApacheAirflowJob

Ένα ApacheAirflowJob.

WarehouseSnapshot

Ένα στιγμιότυπο αποθήκης.

DigitalTwinBuilder

Μια DigitalTwinBuilder.

DigitalTwinBuilderFlow

Μια ψηφιακή ροή Twin Builder.

MirroredAzureDatabricksCatalog

Ένας κατοπτρικός κατάλογος azure databricks.

Map

Ένας χάρτης.

AnomalyDetector

Ένας εντοπισμός ανωμαλιών.

UserDataFunction

Μια συνάρτηση δεδομένων χρήστη.

GraphModel

Ένα GraphModel.

GraphQuerySet

Ένα σύνολο ερωτημάτων Graph.

SnowflakeDatabase

Μια βάση δεδομένων Snowflake για την αποθήκευση πινάκων Iceberg που δημιουργήθηκαν από τον λογαριασμό Snowflake.

OperationsAgent

A OperationsAgent.

CosmosDBDatabase

Μια βάση δεδομένων Cosmos DB.

Ontology

Μια ογκολογία.

EventSchemaSet

Ένα EventSchemaSet.

DataAgent

Ένας DataAgent.

MirroredCatalog

Ένα Κατοπτρικό Αρχείο.

AppBackend

Ένα AppBackend.

OrgApp

Μια εφαρμογή οργανισμού.

OrgAppAudience

Ένα κοινό εφαρμογής οργανισμού.

DataBuildToolJob

Ένα DataBuildToolJob.

AzureDatabricksStorage

Ένα στοιχείο αποθήκευσης που υποστηρίζεται από το OneLake για Azure Databricks.

Plan

Ένα σχέδιο.

MovedItems

Όνομα Τύπος Περιγραφή
value

Item[]

Μια λίστα στοιχείων.

PrincipalType

Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

Τιμή Περιγραφή
User

Το Principal είναι μια κύρια Microsoft Entra χρήστη.

ServicePrincipal

Το Principal είναι μια Microsoft Entra κύρια υπηρεσία.

Group

Το Principal είναι μια ομάδα ασφαλείας.

ServicePrincipalProfile

Το Principal είναι ένα προφίλ κύριας υπηρεσίας.

EntireTenant

Το Principal αντιπροσωπεύει όλους τους χρήστες μισθωτή.

SensitivityLabel

Αντιπροσωπεύει μια ετικέτα ευαισθησίας που έχει εφαρμοστεί σε ένα στοιχείο.

Όνομα Τύπος Περιγραφή
id

string (uuid)

Το αναγνωριστικό ετικέτας ευαισθησίας.

ServicePrincipalDetails

Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipal.

Όνομα Τύπος Περιγραφή
aadAppId

string (uuid)

Το Microsoft Entra AppId της κύριας υπηρεσίας.

ServicePrincipalPrincipal

Αντιπροσωπεύει μια Microsoft Entra κύρια υπηρεσία.

Όνομα Τύπος Περιγραφή
displayName

string

Το εμφανιζόμενο όνομα της κύριας.

id

string (uuid)

Το αναγνωριστικό του διευθυντή.

servicePrincipalDetails

ServicePrincipalDetails

Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipal.

type string:

ServicePrincipal

Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

ServicePrincipalProfileDetails

Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipalProfile.

Όνομα Τύπος Περιγραφή
parentPrincipal Principal:

Η γονική οντότητα του προφίλ κύριας υπηρεσίας.

ServicePrincipalProfilePrincipal

Αντιπροσωπεύει ένα προφίλ κύριας υπηρεσίας.

Όνομα Τύπος Περιγραφή
displayName

string

Το εμφανιζόμενο όνομα της κύριας.

id

string (uuid)

Το αναγνωριστικό του διευθυντή.

servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipalProfile.

type string:

ServicePrincipalProfile

Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

UserDetails

Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι User.

Όνομα Τύπος Περιγραφή
userPrincipalName

string

Το κύριο όνομα χρήστη.

UserPrincipal

Αντιπροσωπεύει μια Microsoft Entra κύρια χρήστη.

Όνομα Τύπος Περιγραφή
displayName

string

Το εμφανιζόμενο όνομα της κύριας.

id

string (uuid)

Το αναγνωριστικό του διευθυντή.

type string:

User

Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

userDetails

UserDetails

Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι User.