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 χαρακτήρες.
folderId		string (uuid)	Το αναγνωριστικό φακέλου. Εάν δεν καθορίζεται ή null, το στοιχείο δημιουργείται με τον χώρο εργασίας ως φάκελο.

Απαντήσεις

Όνομα	Δακτυλογραφώ	Περιγραφή
201 Created	Item	Δημιουργήθηκε με επιτυχία
202 Accepted		Αποδοχή αίτησης, παροχή στοιχείου σε εξέλιξη Κεφαλίδες Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος. ItemDisplayNameAlreadyInUse - Το εμφανιζόμενο όνομα στοιχείου χρησιμοποιείται ήδη. CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο. FolderNotFound - Δεν ήταν δυνατή η εύρεση του φακέλου που ζητήθηκε. WorkspaceItemsLimitExceeded - Έγινε υπέρβαση του ορίου στοιχείων χώρου εργασίας.

Όνομα

Δακτυλογραφώ

Περιγραφή

201 Created

Item

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

202 Accepted

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

Κεφαλίδες

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

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

InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος.
ItemDisplayNameAlreadyInUse - Το εμφανιζόμενο όνομα στοιχείου χρησιμοποιείται ήδη.
CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο.
FolderNotFound - Δεν ήταν δυνατή η εύρεση του φακέλου που ζητήθηκε.
WorkspaceItemsLimitExceeded - Έγινε υπέρβαση του ορίου στοιχείων χώρου εργασίας.

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

Create an item example

Create an item in folder example

Create an item example

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

HTTP

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

Create an item in folder example

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

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items

{
  "displayName": "Item 1",
  "type": "Lakehouse",
  "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
}

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

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

{
  "displayName": "Item 1",
  "description": "",
  "type": "Lakehouse",
  "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "id": "cccccccc-2222-3333-4444-dddddddddddd"
}

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

Location: https://api.fabric.microsoft.com/v1/operations/0000aaaa-11bb-cccc-dd22-eeeeee333333
x-ms-operation-id: 0000aaaa-11bb-cccc-dd22-eeeeee333333
Retry-After: 30

Ορισμοί

Όνομα	Περιγραφή
CreateItemRequest	Δημιουργία ωφέλιμου φορτίου αίτησης στοιχείου.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
Item	Ένα αντικείμενο στοιχείου.
ItemDefinition	Ένα αντικείμενο ορισμού στοιχείου.
ItemDefinitionPart	Ένα αντικείμενο τμήματος ορισμού στοιχείου.
ItemTag	Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.
ItemType	Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
PayloadType	Ο τύπος του ωφέλιμου φορτίου τμήματος ορισμού. Επιπλέον τύποι ωφέλιμου φορτίου μπορούν να προστεθούν με την πάροδο του χρόνου.

CreateItemRequest

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
creationPayload	object	Ένα σύνολο ιδιοτήτων που χρησιμοποιούνται για τη δημιουργία του στοιχείου. Η σελίδα δημιουργίας στοιχείου του σχετικού τύπου υποδεικνύει εάν υποστηρίζεται `creationPayload` και παραθέτει τις ιδιότητες του στοιχείου. Χρησιμοποιήστε `creationPayload` ή `definition`. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
definition	ItemDefinition	Ο ορισμός στοιχείου. Η σελίδα Δημιουργία στοιχείου του σχετικού τύπου υποδεικνύει εάν ο ορισμός υποστηρίζεται και περιγράφει λεπτομερώς τη δομή του. Χρησιμοποιήστε `definition` ή `creationPayload`. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
description	string	Η περιγραφή του στοιχείου. Το μέγιστο μήκος είναι 256 χαρακτήρες.
displayName	string	Το εμφανιζόμενο όνομα του στοιχείου. Το εμφανιζόμενο όνομα πρέπει να ακολουθεί τους κανόνες ονομασίας σύμφωνα με τον τύπο στοιχείου.
folderId	string (uuid)	Το αναγνωριστικό φακέλου. Εάν δεν καθορίζεται ή null, το στοιχείο δημιουργείται με τον χώρο εργασίας ως φάκελο.
type	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)	Το αναγνωριστικό χώρου εργασίας.

ItemDefinition

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
format	string	Η μορφή του ορισμού στοιχείου.
parts	ItemDefinitionPart[]	Μια λίστα τμημάτων ορισμού.

ItemDefinitionPart

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
path	string	Η διαδρομή του τμήματος στοιχείου.
payload	string	Το ωφέλιμο φορτίο του τμήματος στοιχείου.
payloadType	PayloadType	Ο τύπος ωφέλιμου φορτίου.

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.

PayloadType

Απαρίθμηση

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

Τιμή	Περιγραφή
InlineBase64	Ενσωματωμένη βάση 64.

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

Items - Create Item

Δικαιώματα

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

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

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

Διεπαφή

Παράμετροι URI

Σώμα αιτήματος

Απαντήσεις

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

Create an item example

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

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

Create an item in folder example

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

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

Ορισμοί

CreateItemRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

Item

ItemDefinition

ItemDefinitionPart

ItemTag

ItemType

PayloadType