Items - Get Item

Υπηρεσία:: Admin

Έκδοση API:: v1

Επιστρέφει το καθορισμένο Fabric ή στοιχείο PowerBI.

Note

Αυτό το API αποτελεί μέρος μιας έκδοσης προεπισκόπησης και παρέχεται μόνο για σκοπούς αξιολόγησης και ανάπτυξης. Μπορεί να αλλάξει με βάση τα σχόλια και δεν συνιστάται για χρήση στην παραγωγή.

Permissions

Ο καλών πρέπει να είναι διαχειριστής Fabric ή να εκτελεί έλεγχο ταυτότητας χρησιμοποιώντας μια κύρια υπηρεσία.

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

Tenant.Read.All ή Tenant.ReadWrite.All

Limitations

Το πολύ 200 αιτήσεις ανά ώρα.

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

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

Identity	Support
User	Yes
Υπηρεσίας και διαχειριζόμενες ταυτότητες	Yes

Interface

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

Με προαιρετικές παραμέτρους:

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

Παράμετροι URI

Ονομασία	Σε	Απαιτείται	Τύπος	Περιγραφή
itemId	path	True	string (uuid)	Το αναγνωριστικό στοιχείου
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.
type	query		string	Ο τύπος του στοιχείου. Κατά την υποβολή ερωτημάτων για τους ακόλουθους τύπους, αυτή η παράμετρος απαιτείται: Report Dashboard SemanticModel App Dataflow

Ονομασία

Σε

Απαιτείται

Τύπος

Περιγραφή

itemId

path

True

string (uuid)

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

workspaceId

path

True

string (uuid)

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

type

query

string

Ο τύπος του στοιχείου. Κατά την υποβολή ερωτημάτων για τους ακόλουθους τύπους, αυτή η παράμετρος απαιτείται:

Report
Dashboard
SemanticModel
App
Dataflow

Αποκρίσεις

Ονομασία Τύπος Περιγραφή

200 OK

Ονομασία	Τύπος	Περιγραφή
200 OK	Item	OK
429 Too Many Requests	ErrorResponse	Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια `Retry-After` κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων. Κεφαλίδες Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: ItemNotFound - Το αναγνωριστικό στοιχείου δεν υπάρχει. InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος.

Item

429 Too Many Requests

ErrorResponse

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

Κεφαλίδες

Retry-After: integer

Other Status Codes

ErrorResponse

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

ItemNotFound - Το αναγνωριστικό στοιχείου δεν υπάρχει.
InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος.

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

Get item details by ID and type example

Get item details by ID example

Get item details by ID and type example

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

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces/7f4496db-9929-47bd-89c0-d7eb2f517a98/items/f089354e-8366-4e18-aea3-4cb4a3a50b48?type=Report

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

Κωδικός κατάστασης:: 200

{
  "id": "17d8929d-ab32-46d1-858b-fdea74e93bf2",
  "type": "Report",
  "name": "Test",
  "description": "Test Jacob's Report,",
  "state": "Active",
  "lastUpdatedDate": "2022-04-29T17:47:29.98673",
  "workspaceId": "7f4496db-9929-47bd-89c0-d7eb2f517a98",
  "capacityId": "D5E336D6-D919-4ECC-B424-1F771A506851",
  "creatorPrincipal": {
    "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
    "displayName": "Jacob Hancock",
    "type": "User",
    "userDetails": {
      "userPrincipalName": "Jacob@example.com"
    }
  },
  "defaultIdentity": {
    "id": "ff3c8689-591c-4298-a228-4ffcc77cb661",
    "displayName": "Caleb Foster",
    "type": "User",
    "userDetails": {
      "userPrincipalName": "caleb@example.com"
    }
  }
}

Get item details by ID example

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

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces/7f4496db-9929-47bd-89c0-d7eb2f517a98/items/f089354e-8366-4e18-aea3-4cb4a3a50b48

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

Κωδικός κατάστασης:: 200

{
  "id": "17d8929d-ab32-46d1-858b-fdea74e93bf2",
  "type": "Kusto",
  "name": "Test",
  "description": "Test Jacob's notebook.",
  "state": "Active",
  "lastUpdatedDate": "2022-04-29T17:47:29.98673",
  "workspaceId": "7f4496db-9929-47bd-89c0-d7eb2f517a98",
  "capacityId": "D5E336D6-D919-4ECC-B424-1F771A506851",
  "creatorPrincipal": {
    "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
    "displayName": "Jacob Hancock",
    "type": "User",
    "userDetails": {
      "userPrincipalName": "Jacob@example.com"
    }
  }
}

Ορισμοί

Ονομασία	Περιγραφή
EntireTenantPrincipal	Αντιπροσωπεύει μια αρχή μισθωτή
ErrorParameter	Μια δομημένη παράμετρος που παρέχει πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με ένα σφάλμα.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
GroupDetails	Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι `Group`.
GroupPrincipal	Αντιπροσωπεύει μια ομάδα ασφαλείας.
GroupType	Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.
Item	Λεπτομέρειες στοιχείου.
ItemState	Η κατάσταση του στοιχείου. Ενδέχεται να προστεθούν πρόσθετες καταστάσεις στοιχείων με την πάροδο του χρόνου.
ItemTag	Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.
ItemType	Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
PrincipalType	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.
ServicePrincipalDetails	Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipal`.
ServicePrincipalPrincipal	Αντιπροσωπεύει μια Microsoft Entra κύρια υπηρεσία.
ServicePrincipalProfileDetails	Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Αντιπροσωπεύει ένα προφίλ κύριας υπηρεσίας.
UserDetails	Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι `User`.
UserPrincipal	Αντιπροσωπεύει μια Microsoft Entra κύρια χρήστη.

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

Αντικείμενο

Λεπτομέρειες στοιχείου.

Ονομασία	Τύπος	Περιγραφή
capacityId	string (uuid)	Το αναγνωριστικό εκχωρημένων πόρων του χώρου εργασίας.
creatorPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Ο κάτοχος του στοιχείου.
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Η προεπιλεγμένη ταυτότητα του στοιχείου.
description	string	Λεπτομέρειες στοιχείου, συμπεριλαμβανομένου του τύπου στοιχείου και της χρήσης του στοιχείου.
folderId	string (uuid)	Το αναγνωριστικό φακέλου του στοιχείου.
id	string (uuid)	Το αναγνωριστικό στοιχείου.
lastUpdatedDate	string (date-time)	Η ημερομηνία και ώρα τελευταίας ενημέρωσης.
name	string	Το όνομα του στοιχείου.
state	ItemState	Η κατάσταση του στοιχείου.
tags	ItemTag[]	Λίστα εφαρμοσμένων ετικετών.
type	ItemType	Ο τύπος στοιχείου. Περιλαμβάνει τιμές όπως Synapse, Notebook, Kqldatabase και SynapseWorkbook.
workspaceId	string (uuid)	Το αναγνωριστικό χώρου εργασίας του στοιχείου.

ItemState

Απαρίθμηση

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

Τιμή	Περιγραφή
Active	Ένα ενεργό στοιχείο.

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	Ένα Κατοπτρικό Αρχείο.
PolicySet	Ένα σύνολο πολιτικών.
AppBackend	Ένα AppBackend.
OrgApp	Μια εφαρμογή οργανισμού.
OrgAppAudience	Ένα κοινό εφαρμογής οργανισμού.
DataBuildToolJob	Ένα DataBuildToolJob.
AzureDatabricksStorage	Ένα στοιχείο αποθήκευσης που υποστηρίζεται από το OneLake για Azure Databricks.
Plan	Ένα σχέδιο.
Monitoring	Ένα στοιχείο παρακολούθησης.
DeploymentPlan	Ένα σχέδιο ανάπτυξης.

PrincipalType

Απαρίθμηση

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

Τιμή	Περιγραφή
User	Το Principal είναι μια κύρια Microsoft Entra χρήστη.
ServicePrincipal	Το Principal είναι μια Microsoft Entra κύρια υπηρεσία.
Group	Το Principal είναι μια ομάδα ασφαλείας.
ServicePrincipalProfile	Το Principal είναι ένα προφίλ κύριας υπηρεσίας.
EntireTenant	Το Principal αντιπροσωπεύει όλους τους χρήστες μισθωτή.

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: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Η γονική οντότητα του προφίλ κύριας υπηρεσίας.

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`.