Κοινή χρήση μέσω


Items - Get Item

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

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

Δικαιώματα

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

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

Για τα API στοιχείων χρησιμοποιήστε αυτούς τους τύπους εμβέλειας:

  • Γενική εμβέλεια: Item.Read.All ή Item.ReadWrite.All
  • Συγκεκριμένη εμβέλεια: itemType. Read.All ή itemType. ReadWrite.All (για παράδειγμα: Notebook.ReadWrite.All)

Για περισσότερες πληροφορίες σχετικά με τις εμβέλειες, ανατρέξτε στο θέμα: εμβέλειες, άρθρο.

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

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

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

Διεπαφή

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

Παράμετροι URI

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

string

uuid

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

workspaceId
path True

string

uuid

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

Αποκρίσεις

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

Item

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

Other Status Codes

ErrorResponse

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

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

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

Get an item example

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

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715

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

{
  "displayName": "Item 1",
  "description": "Item 1 description",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Ορισμοί

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

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

ErrorResponse

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

ErrorResponseDetails

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

Item

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

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

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

id

string

uuid

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

type

ItemType

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

workspaceId

string

uuid

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

ItemType

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

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

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

DataPipeline

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

Datamart

Datamart του PowerBI.

Environment

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

Eventhouse

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

Eventstream

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

GraphQLApi

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

KQLDashboard

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

KQLDatabase

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

KQLQueryset

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

Lakehouse

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

MLExperiment

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

MLModel

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

MirroredDatabase

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

MirroredWarehouse

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

MountedDataFactory

A MountedDataFactory.

Notebook

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

PaginatedReport

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

Reflex

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

Report

Αναφορά PowerBI.

SQLDatabase

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

SQLEndpoint

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

SemanticModel

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

SparkJobDefinition

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

Warehouse

Μια αποθήκη.