Items - Create Eventhouse

Αναφορά

Υπηρεσία:: Eventhouse

Έκδοση API:: v1

Δημιουργεί μια ομάδα συμβάντων στον καθορισμένο χώρο εργασίας.
Αυτό το API υποστηρίζει λειτουργίες μεγάλης διάρκειας (LRO).

Δικαιώματα

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

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

Eventhouse.ReadWrite.All ή Item.ReadWrite.All

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

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

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

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

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

Διεπαφή

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

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
workspaceId	path	True	string uuid	Το αναγνωριστικό χώρου εργασίας.

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

Όνομα	Απαιτείται	Τύπος	Περιγραφή
displayName	True	string	Το εμφανιζόμενο όνομα της υπηρεσίας συμβάντων. Το όνομα της υπηρεσίας συμβάντων μπορεί να περιέχει αλφαριθμητικούς χαρακτήρες, χαρακτήρες υπογράμμισης, τελείες και ενωτικά. Δεν υποστηρίζονται ειδικοί χαρακτήρες.
creationPayload		EventhouseCreationPayload	Το ωφέλιμο φορτίο δημιουργίας της eventhouse. Χρησιμοποιήστε `definition` ή `creationPayload`. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
definition		EventhouseDefinition	Ο δημόσιος ορισμός της υπηρεσίας εκδηλώσεων. Χρησιμοποιήστε `definition` ή `creationPayload`. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
description		string	Η περιγραφή της υπηρεσίας συμβάντων. Το μέγιστο μήκος είναι 256 χαρακτήρες.

Αποκρίσεις

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

Όνομα

Τύπος

Περιγραφή

201 Created

Eventhouse

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

202 Accepted

Αίτηση αποδοχής, προμήθεια της υπηρεσίας συμβάντων σε εξέλιξη

Κεφαλίδες

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

Other Status Codes

ErrorResponse

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

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

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

Create an eventhouse example

create an eventhouse with creationPayload example

Create an eventhouse with definition example

Create an eventhouse example

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

HTTP

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

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description."
}

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

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

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}

Κωδικός κατάστασης:: 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 eventhouse with creationPayload example

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

HTTP

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

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "creationPayload": {
    "minimumConsumptionUnits": 2.25
  }
}

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

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

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}

Κωδικός κατάστασης:: 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 eventhouse with definition example

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

HTTP

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

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "definition": {
    "parts": [
      {
        "path": "EventhouseProperties.json",
        "payload": "e30=",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

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

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

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}

Κωδικός κατάστασης:: 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

Ορισμοί

Όνομα	Περιγραφή
CreateEventhouseRequest	Δημιουργία αίτησης υπηρεσίας συμβάντων.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
Eventhouse	Ένα αντικείμενο της υπηρεσίας συμβάντων.
EventhouseCreationPayload	Ωφέλιμο φορτίο στοιχείου eventhouse
EventhouseDefinition	Αντικείμενο δημόσιου ορισμού eventhouse.
EventhouseDefinitionPart	Αντικείμενο τμήματος ορισμού υπηρεσίας συμβάντων.
EventhouseProperties	Οι ιδιότητες της υπηρεσίας συμβάντων.
ItemType	Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
PayloadType	Ο τύπος του ωφέλιμου φορτίου τμήματος ορισμού. Επιπλέον τύποι ωφέλιμου φορτίου μπορούν να προστεθούν με την πάροδο του χρόνου.

CreateEventhouseRequest

Object

Δημιουργία αίτησης υπηρεσίας συμβάντων.

Όνομα	Τύπος	Περιγραφή
creationPayload	EventhouseCreationPayload	Το ωφέλιμο φορτίο δημιουργίας της eventhouse. Χρησιμοποιήστε `definition` ή `creationPayload`. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
definition	EventhouseDefinition	Ο δημόσιος ορισμός της υπηρεσίας εκδηλώσεων. Χρησιμοποιήστε `definition` ή `creationPayload`. Δεν μπορείτε να χρησιμοποιήσετε και τα δύο ταυτόχρονα.
description	string	Η περιγραφή της υπηρεσίας συμβάντων. Το μέγιστο μήκος είναι 256 χαρακτήρες.
displayName	string	Το εμφανιζόμενο όνομα της υπηρεσίας συμβάντων. Το όνομα της υπηρεσίας συμβάντων μπορεί να περιέχει αλφαριθμητικούς χαρακτήρες, χαρακτήρες υπογράμμισης, τελείες και ενωτικά. Δεν υποστηρίζονται ειδικοί χαρακτήρες.

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	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

Eventhouse

Object

Ένα αντικείμενο της υπηρεσίας συμβάντων.

Όνομα	Τύπος	Περιγραφή
description	string	Η περιγραφή του στοιχείου.
displayName	string	Το εμφανιζόμενο όνομα του στοιχείου.
id	string uuid	Το αναγνωριστικό στοιχείου.
properties	EventhouseProperties	Οι ιδιότητες της υπηρεσίας συμβάντων.
type	ItemType	Ο τύπος στοιχείου.
workspaceId	string uuid	Το αναγνωριστικό χώρου εργασίας.

EventhouseCreationPayload

Object

Ωφέλιμο φορτίο στοιχείου eventhouse

Όνομα	Τύπος	Default value	Περιγραφή
minimumConsumptionUnits	number double	0	Όταν ενεργοποιηθεί, η eventhouse είναι πάντα διαθέσιμη στο επιλεγμένο ελάχιστο επίπεδο και πληρώνετε τουλάχιστον την ελάχιστη επιλεγμένη υπολογιστική λειτουργία. Οι υποστηριζόμενες τιμές περιλαμβάνουν τα στοιχεία [0, 2.25, 4.25, 8.5, 13, 18, 26, 34, 50] ή οποιονδήποτε αριθμό μεταξύ 51 και 322. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα ελάχιστη κατανάλωση

EventhouseDefinition

Object

Αντικείμενο δημόσιου ορισμού eventhouse.

Όνομα	Τύπος	Περιγραφή
format	string	Η μορφή του ορισμού στοιχείου.
parts	EventhouseDefinitionPart[]	Μια λίστα τμημάτων ορισμού.

EventhouseDefinitionPart

Object

Αντικείμενο τμήματος ορισμού υπηρεσίας συμβάντων.

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

EventhouseProperties

Object

Οι ιδιότητες της υπηρεσίας συμβάντων.

Όνομα	Τύπος	Περιγραφή
databasesItemIds	string[] uuid	Λίστα όλων των θυγατρικών στοιχείων βάσης δεδομένων KQL
ingestionServiceUri	string	URI υπηρεσίας πρόσληψης.
queryServiceUri	string	URI υπηρεσίας ερωτημάτων.

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.

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

Items - Create Eventhouse

Δικαιώματα

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

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

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

Διεπαφή

Παράμετροι URI

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

Αποκρίσεις

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

Create an eventhouse example

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

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

create an eventhouse with creationPayload example

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

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

Create an eventhouse with definition example

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

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

Ορισμοί

CreateEventhouseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

Eventhouse

EventhouseCreationPayload

EventhouseDefinition

EventhouseDefinitionPart

EventhouseProperties

ItemType

PayloadType

Πρόσθετοι πόροι