Κοινοποίηση μέσω

Items - List Items

Υπηρεσία:
Core
Έκδοση API:
v1

Επιστρέφει μια λίστα στοιχείων από τον καθορισμένο χώρο εργασίας.
Αυτό το API υποστηρίζει σελιδοποίησης .

Δικαιώματα

Ο καλών πρέπει να έχει ρόλο θεατή.

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

Workspace.Read.All ή Workspace.ReadWrite.All

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

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

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

Διεπαφή

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items
Με προαιρετικές παραμέτρους: 
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items?type={type}&recursive={recursive}&rootFolderId={rootFolderId}&continuationToken={continuationToken}

Παράμετροι URI

Όνομα Μέσα Απαιτούμενο Δακτυλογραφώ Περιγραφή
workspaceId
 path True

string (uuid)

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

string

Ένα διακριτικό για την ανάκτηση της επόμενης σελίδας αποτελεσμάτων.
recursive
 query

boolean

Παραθέτει στοιχεία σε έναν φάκελο και τους ένθετες φακέλους του ή απλώς έναν φάκελο μόνο. True - Παρατίθενται όλα τα στοιχεία στον φάκελο και οι ένθετοί του φάκελοι, False - Παρατίθενται μόνο τα στοιχεία στον φάκελο. Η προεπιλεγμένη τιμή είναι true.
rootFolderId
 query

string (uuid)

Αυτή η παράμετρος επιτρέπει στους χρήστες να φιλτράρουν στοιχεία με βάση έναν συγκεκριμένο ριζικό φάκελο. Εάν δεν παρέχεται, ο χώρος εργασίας χρησιμοποιείται ως ριζικός φάκελος.
type
 query

string

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

Απαντήσεις

Όνομα Δακτυλογραφώ Περιγραφή
200 OK

Items

Η αίτηση ολοκληρώθηκε με επιτυχία.
Other Status Codes

ErrorResponse

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

  • InvalidItemType - Μη έγκυρος τύπος στοιχείου.

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

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

List all items in a specific folder example
List all items in workspace by type query parameter example
List all items in workspace example
List direct items in a specific folder example
List direct items in workspace example
List items in workspace with continuation example

List all items in a specific folder example

Αίτημα δείγματος

GET https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items?rootFolderId=bbbbbbbb-1111-2222-3333-cccccccccccc

Δείγμα απάντησης

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "displayName": "Lakehouse",
      "description": "A lakehouse used by the sales team.",
      "type": "Lakehouse",
      "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 Q1 of year 2024 sales data analysis through machine learning algorithms.",
      "type": "Notebook",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "cccccccc-8888-9999-0000-dddddddddddd"
    }
  ]
}

List all items in workspace by type query parameter example

Αίτημα δείγματος

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items?type=Lakehouse

Δείγμα απάντησης

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Lakehouse Name 1",
      "description": "A lakehouse used by the analytics team.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

List all items in workspace example

Αίτημα δείγματος

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items

Δείγμα απάντησης

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Lakehouse",
      "description": "A lakehouse used by the analytics team.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    {
      "id": "58fa1eac-9694-4a6b-ba25-3520288e8fea",
      "displayName": "Notebook",
      "description": "A notebook for refining medical data analysis through machine learning algorithms.",
      "type": "KustoDashboard",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

List direct items in a specific folder example

Αίτημα δείγματος

GET https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items?recursive=False&rootFolderId=bbbbbbbb-1111-2222-3333-cccccccccccc

Δείγμα απάντησης

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "id": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
      "displayName": "Notebook",
      "description": "A notebook for refining year 2024 sales data analysis through machine learning algorithms.",
      "type": "Notebook",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    }
  ]
}

List direct items in workspace example

Αίτημα δείγματος

GET https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items?recursive=False

Δείγμα απάντησης

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "displayName": "Lakehouse",
      "description": "A lakehouse shared by the all teams.",
      "type": "Lakehouse",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    }
  ]
}

List items in workspace with continuation example

Αίτημα δείγματος

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items

Δείγμα απάντησης

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Lakehouse",
      "description": "A lakehouse used by the analytics team.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    {
      "id": "58fa1eac-9694-4a6b-ba25-3520288e8fea",
      "displayName": "Notebook",
      "description": "A notebook for refining medical data analysis through machine learning algorithms.",
      "type": "KustoDashboard",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items?continuationToken=LDEsMTAwMDAwLDA%3D"
}

Ορισμοί

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

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

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

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

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

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

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

ErrorRelatedResource

Αντικείμενο

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

Όνομα Δακτυλογραφώ Περιγραφή
resourceId

string

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

string

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

ErrorResponse

Αντικείμενο

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

Όνομα Δακτυλογραφώ Περιγραφή
errorCode

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

Αντικείμενο

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

Όνομα Δακτυλογραφώ Περιγραφή
errorCode

string

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

string

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

ErrorRelatedResource

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

Item

Αντικείμενο

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

Όνομα Δακτυλογραφώ Περιγραφή
description

string

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

string

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

string (uuid)

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

string (uuid)

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

ItemTag[]

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

ItemType

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

string (uuid)

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

Items

Αντικείμενο
Όνομα Δακτυλογραφώ Περιγραφή
continuationToken

string

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

string

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

Item[]

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

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.