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

Items - Create Item

  • Αναφορά
Υπηρεσία:
Core
Έκδοση API:
v1

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

Αυτό το API υποστηρίζει λειτουργίες μεγάλης διάρκειας (LRO).

Δικαιώματα

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

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

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

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

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

Περιορισμούς

  • Για να δημιουργήσετε ένα στοιχείο που δεν είναι PowerBI Fabric, ο χώρος εργασίας πρέπει να βρίσκεται σε υποστηριζόμενους εκχωρημένους πόρους Fabric. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα τύποι αδειών χρήσης Microsoft Fabric.
  • Για να δημιουργήσει ένα στοιχείο PowerBI, ο χρήστης πρέπει να έχει την κατάλληλη άδεια χρήσης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα τύποι αδειών χρήσης Microsoft Fabric.
  • Κατά τη δημιουργία ενός στοιχείου, χρησιμοποιήστε είτε creationPayload, είτε definition, αλλά μην χρησιμοποιείτε και τα δύο ταυτόχρονα.

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

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

Ταυτότητα Υποστηρίζω
Χρήστης Ναι
Υπηρεσίας και διαχειριζόμενες ταυτότητες Όταν υποστηρίζεται ο τύπος στοιχείου στην κλήση. Ελέγξτε το αντίστοιχο API για τον τύπο στοιχείου που καλείτε, για να δείτε εάν η κλήση σας υποστηρίζεται. Για παράδειγμα, υποστηρίζονται σημασιολογικά μοντέλα.

Διεπαφή

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

Παράμετροι URI

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

string

uuid

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

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

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

string

Το εμφανιζόμενο όνομα του στοιχείου. Το εμφανιζόμενο όνομα πρέπει να ακολουθεί τους κανόνες ονομασίας σύμφωνα με τον τύπο στοιχείου.
type True

ItemType

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

object

Ένα σύνολο ιδιοτήτων που χρησιμοποιούνται για τη δημιουργία του στοιχείου. Η σελίδα δημιουργίας στοιχείου του σχετικού τύπου υποδεικνύει εάν υποστηρίζεται creationPayload και παραθέτει τις ιδιότητες του στοιχείου. Χρησιμοποιήστε creationPayload ή definition. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
definition

ItemDefinition

Ο ορισμός στοιχείου. Η σελίδα Δημιουργία στοιχείου του σχετικού τύπου υποδεικνύει εάν ο ορισμός υποστηρίζεται και περιγράφει λεπτομερώς τη δομή του. Χρησιμοποιήστε definition ή creationPayload. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
description

string

Η περιγραφή του στοιχείου. Το μέγιστο μήκος είναι 256 χαρακτήρες.

Αποκρίσεις

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

Item

Δημιουργήθηκε με επιτυχία
202 Accepted

Αποδοχή αίτησης, παροχή στοιχείου σε εξέλιξη

Κεφαλίδες

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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

  • InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος.

  • ItemDisplayNameAlreadyInUse - Το εμφανιζόμενο όνομα στοιχείου χρησιμοποιείται ήδη.

  • CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο

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

Create an item example

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

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

{
  "displayName": "Item 1",
  "type": "Lakehouse"
}

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

Κωδικός κατάστασης:
201 
{
  "displayName": "Item 1",
  "description": "",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Κωδικός κατάστασης:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Ορισμοί

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

Δημιουργία ωφέλιμου φορτίου αίτησης στοιχείου.
ErrorRelatedResource

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

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

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

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

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

Ένα αντικείμενο τμήματος ορισμού στοιχείου.
ItemType

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

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

CreateItemRequest

Object

Δημιουργία ωφέλιμου φορτίου αίτησης στοιχείου.

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

object

Ένα σύνολο ιδιοτήτων που χρησιμοποιούνται για τη δημιουργία του στοιχείου. Η σελίδα δημιουργίας στοιχείου του σχετικού τύπου υποδεικνύει εάν υποστηρίζεται creationPayload και παραθέτει τις ιδιότητες του στοιχείου. Χρησιμοποιήστε creationPayload ή definition. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
definition

ItemDefinition

Ο ορισμός στοιχείου. Η σελίδα Δημιουργία στοιχείου του σχετικού τύπου υποδεικνύει εάν ο ορισμός υποστηρίζεται και περιγράφει λεπτομερώς τη δομή του. Χρησιμοποιήστε definition ή creationPayload. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
description

string

Η περιγραφή του στοιχείου. Το μέγιστο μήκος είναι 256 χαρακτήρες.
displayName

string

Το εμφανιζόμενο όνομα του στοιχείου. Το εμφανιζόμενο όνομα πρέπει να ακολουθεί τους κανόνες ονομασίας σύμφωνα με τον τύπο στοιχείου.
type

ItemType

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

ErrorRelatedResource

Object

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

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

string

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

string

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

ErrorResponse

Object

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

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

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

Object

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

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

string

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

string

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

ErrorRelatedResource

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

Item

Object

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

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

string

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

string

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

string

uuid

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

ItemType

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

string

uuid

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

ItemDefinition

Object

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

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

string

Η μορφή του ορισμού στοιχείου.
parts

ItemDefinitionPart[]

Μια λίστα τμημάτων ορισμού.

ItemDefinitionPart

Object

Ένα αντικείμενο τμήματος ορισμού στοιχείου.

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

string

Η διαδρομή του τμήματος στοιχείου.
payload

string

Το ωφέλιμο φορτίο του τμήματος στοιχείου.
payloadType

PayloadType

Ο τύπος ωφέλιμου φορτίου.

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

Μια αποθήκη.

PayloadType

Απαρίθμηση

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

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

Ενσωματωμένη βάση 64.