Freigeben über

Items - Create Eventhouse

Dienst:
Eventhouse
API-Version:
v1

Erstellt ein Eventhouse im angegebenen Arbeitsbereich.
Diese API unterstützt LRO-.

Erlaubnisse

Der Aufrufer muss über eine Rolle des Mitwirkenden-Arbeitsbereichs verfügen.

Erforderliche delegierte Bereiche

Eventhouse.ReadWrite.All oder Item.ReadWrite.All

Begrenzungen

  • Um ein Eventhouse zu erstellen, muss der Arbeitsbereich auf einer unterstützten Fabric Kapazität vorhanden sein. Weitere Informationen finden Sie unter: Microsoft Fabric Lizenztypen.

Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft identities.

Identität Unterstützen
Benutzer Ja
Service Principal und Verwaltete Identitäten Ja

Schnittstelle

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.

Anforderungstext

Name Erforderlich Typ Beschreibung
displayName True

string

Der Anzeigename des Eventhouses. Der Name des Ereignishauses kann alphanumerische Zeichen, Unterstriche, Punkte und Bindestriche enthalten. Sonderzeichen werden nicht unterstützt.
creationPayload

EventhouseCreationPayload

Die Eventhouse-Erstellungsnutzlast. Verwenden Sie definition oder creationPayload. Sie können beide nicht gleichzeitig verwenden.
definition

EventhouseDefinition

Die öffentliche Definition des Eventhouses. Verwenden Sie definition oder creationPayload. Sie können beide nicht gleichzeitig verwenden.
description

string

Die Eventhouse-Beschreibung. Die maximale Länge beträgt 256 Zeichen.
folderId

string (uuid)

Die Ordner-ID. Wenn sie nicht angegeben oder null ist, wird das Eventhouse mit dem Arbeitsbereich als Ordner erstellt.
sensitivityLabelSettings

SensitivityLabelSettings

Die Vertraulichkeitsbezeichnungseinstellungen für das Eventhouse.

Antworten

Name Typ Beschreibung
201 Created

Eventhouse

Erfolgreich erstellt
202 Accepted

Akzeptierte Anforderung, Ereignishausbereitstellung in Bearbeitung

Header

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

Der Dienstratengrenzwert wurde überschritten. Der Server gibt einen Retry-After Header zurück, der in Sekunden angibt, wie lange der Client warten muss, bevor zusätzliche Anforderungen gesendet werden.

Header

Retry-After: integer
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • InvalidItemType – Elementtyp ist ungültig.

  • ItemDisplayNameAlreadyInUse - Der Anzeigename des Elements wird bereits verwendet.

  • CorruptedPayload – Die bereitgestellte Nutzlast ist beschädigt.

  • WorkspaceItemsLimitExceededed – Grenzwert für Arbeitsbereichselemente wurde überschritten.

Beispiele

Create an eventhouse example
create an eventhouse with creationPayload example
Create an eventhouse with definition example

Create an eventhouse example

Beispielanforderung

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

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

Beispiel für eine Antwort

Statuscode:
201 
{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
Statuscode:
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

Beispielanforderung

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
  }
}

Beispiel für eine Antwort

Statuscode:
201 
{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
Statuscode:
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

Beispielanforderung

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"
      }
    ]
  }
}

Beispiel für eine Antwort

Statuscode:
201 
{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
Statuscode:
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

Definitionen

Name Beschreibung
CreateEventhouseRequest

Erstellen Sie eventhouse-Anforderung.
EntireTenantPrincipal

Stellt einen Mandantenprinzipal dar.
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
Eventhouse

Ein Eventhouse-Objekt.
EventhouseCreationPayload

Eventhouse-Elementnutzlast
EventhouseDefinition

Eventhouse Public Definition-Objekt. Weitere Informationen zur Struktur der Eventhouse-Definition finden Sie in diesem Artikel .
EventhouseDefinitionPart

Eventhouse-Definitionsteilobjekt.
EventhouseProperties

Die Eventhouse-Eigenschaften.
GroupDetails

Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp Groupist.
GroupPrincipal

Steht für eine Sicherheitsgruppe.
GroupType

Der Typ der Gruppe. Weitere Gruppentypen können im Laufe der Zeit hinzugefügt werden.
ItemTag

Stellt ein Tag dar, das auf ein Element angewendet wird.
ItemType

Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.
PayloadType

Der Typ der Definitionsteilnutzlast. Zusätzliche Nutzlasttypen können im Laufe der Zeit hinzugefügt werden.
PrincipalType

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.
SensitivityLabel

Stellt eine Vertraulichkeitsbezeichnung dar, die auf ein Element angewendet wird.
SensitivityLabelApplyStrategy

Die Strategie für die Anwendung der Vertraulichkeitsbezeichnung. Der Standardwert ist ApplyOrFail. Zusätzliche Typen können im Laufe der Zeit hinzugefügt werden.
SensitivityLabelSettings

Die Einstellungen für Vertraulichkeitsbezeichnungen.
ServicePrincipalDetails

Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp ServicePrincipalist.
ServicePrincipalPrincipal

Stellt einen Microsoft Entra Dienstprinzipal dar.
ServicePrincipalProfileDetails

Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp ServicePrincipalProfileist.
ServicePrincipalProfilePrincipal

Stellt ein Dienstprinzipalprofil dar.
UserDetails

Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp Userist.
UserPrincipal

Stellt einen Microsoft Entra Benutzerprinzipal dar.

CreateEventhouseRequest

Objekt

Erstellen Sie eventhouse-Anforderung.

Name Typ Beschreibung
creationPayload

EventhouseCreationPayload

Die Eventhouse-Erstellungsnutzlast. Verwenden Sie definition oder creationPayload. Sie können beide nicht gleichzeitig verwenden.
definition

EventhouseDefinition

Die öffentliche Definition des Eventhouses. Verwenden Sie definition oder creationPayload. Sie können beide nicht gleichzeitig verwenden.
description

string

Die Eventhouse-Beschreibung. Die maximale Länge beträgt 256 Zeichen.
displayName

string

Der Anzeigename des Eventhouses. Der Name des Ereignishauses kann alphanumerische Zeichen, Unterstriche, Punkte und Bindestriche enthalten. Sonderzeichen werden nicht unterstützt.
folderId

string (uuid)

Die Ordner-ID. Wenn sie nicht angegeben oder null ist, wird das Eventhouse mit dem Arbeitsbereich als Ordner erstellt.
sensitivityLabelSettings

SensitivityLabelSettings

Die Vertraulichkeitsbezeichnungseinstellungen für das Eventhouse.

EntireTenantPrincipal

Objekt

Stellt einen Mandantenprinzipal dar.

Name Typ Beschreibung
displayName

string

Der Anzeigename des Prinzipals.
id

string (uuid)

Die ID des Prinzipals.
type string:

EntireTenant

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType

string

Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string (uuid)

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

Eventhouse

Objekt

Ein Eventhouse-Objekt.

Name Typ Beschreibung
defaultIdentity Principal:

Die Standardidentität des Elements.
description

string

Die Elementbeschreibung.
displayName

string

Der Anzeigename des Elements.
folderId

string (uuid)

Die Ordner-ID.
id

string (uuid)

Die Element-ID.
properties

EventhouseProperties

Die Eventhouse-Eigenschaften.
sensitivityLabel

SensitivityLabel

Die Vertraulichkeitsbezeichnung des Elements.
tags

ItemTag[]

Liste der angewendeten Tags.
type

ItemType

Der Elementtyp.
workspaceId

string (uuid)

Die Arbeitsbereichs-ID.

EventhouseCreationPayload

Objekt

Eventhouse-Elementnutzlast

Name Typ Standardwert Beschreibung
minimumConsumptionUnits

number (double)

0

Verwenden Sie den minimalen Verbrauch für hochgradig zeitempfindliche Systeme, um den Dienst immer auf einer ausgewählten Mindeststufe verfügbar zu halten. Sie zahlen für den Mindestverbrauch oder den tatsächlichen Verbrauch, wenn der Mindestwert übersteigend ist. Unterstützte Werte sind [0, 2,25, 4,25, 8,5, 13, 18, 26, 34, 50] oder eine beliebige Zahl zwischen 51 und 322. Weitere Informationen finden Sie unter Mindestverbrauch.

EventhouseDefinition

Objekt

Eventhouse Public Definition-Objekt. Weitere Informationen zur Struktur der Eventhouse-Definition finden Sie in diesem Artikel .

Name Typ Beschreibung
format

string

Das Format der Elementdefinition.
parts

EventhouseDefinitionPart[]

Eine Liste der Definitionsteile.

EventhouseDefinitionPart

Objekt

Eventhouse-Definitionsteilobjekt.

Name Typ Beschreibung
path

string

Der Eventhouse-Teilpfad.
payload

string

Die Eventhouse-Teilnutzlast.
payloadType

PayloadType

Der Nutzlasttyp.

EventhouseProperties

Objekt

Die Eventhouse-Eigenschaften.

Name Typ Standardwert Beschreibung
databasesItemIds

string[] (uuid)

Liste aller untergeordneten KQL-Datenbank
ingestionServiceUri

string

Dienst-URI für Aufnahme.
minimumConsumptionUnits

number (double)

0

Verwenden Sie den minimalen Verbrauch für hochgradig zeitempfindliche Systeme, um den Dienst immer auf einer ausgewählten Mindeststufe verfügbar zu halten. Sie zahlen für den Mindestverbrauch oder den tatsächlichen Verbrauch, wenn der Mindestwert übersteigend ist. Unterstützte Werte sind [0, 2,25, 4,25, 8,5, 13, 18, 26, 34, 50] oder eine beliebige Zahl zwischen 51 und 322. Weitere Informationen finden Sie unter Mindestverbrauch.
queryServiceUri

string

Abfragedienst-URI.

GroupDetails

Objekt

Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp Groupist.

Name Typ Beschreibung
groupType

GroupType

Der Typ der Gruppe. Weitere Gruppentypen können im Laufe der Zeit hinzugefügt werden.

GroupPrincipal

Objekt

Steht für eine Sicherheitsgruppe.

Name Typ Beschreibung
displayName

string

Der Anzeigename des Prinzipals.
groupDetails

GroupDetails

Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp Groupist.
id

string (uuid)

Die ID des Prinzipals.
type string:

Group

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.

GroupType

Enumeration

Der Typ der Gruppe. Weitere Gruppentypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
Unknown

Der Prinzipalgruppentyp ist unbekannt.
SecurityGroup

Prinzipal ist eine Sicherheitsgruppe.
DistributionList

Prinzipal ist eine Verteilerliste.

ItemTag

Objekt

Stellt ein Tag dar, das auf ein Element angewendet wird.

Name Typ Beschreibung
displayName

string

Der Name des Tags.
id

string (uuid)

Die Tag-ID.

ItemType

Enumeration

Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
Dashboard

PowerBI-Dashboard.
Report

PowerBI-Bericht.
SemanticModel

PowerBI-Semantikmodell.
PaginatedReport

PowerBI-Paginated-Bericht.
Datamart

PowerBI datamart.
Lakehouse

Ein Seehaus.
Eventhouse

Ein Eventhouse.
Environment

Eine Umgebung.
KQLDatabase

Eine KQL-Datenbank.
KQLQueryset

Ein KQL-Abfrageset.
KQLDashboard

Ein KQL-Dashboard.
DataPipeline

Eine Datenpipeline.
Notebook

Ein Notizbuch.
SparkJobDefinition

Eine Sparkauftragsdefinition.
MLExperiment

Ein Machine Learning-Experiment.
MLModel

Ein Machine Learning-Modell.
Warehouse

Ein Lagerhaus.
Eventstream

Ein Ereignisstream.
SQLEndpoint

Ein SQL-Endpunkt.
MirroredWarehouse

Ein gespiegeltes Lager.
MirroredDatabase

Eine gespiegelte Datenbank.
Reflex

Ein Reflex.
GraphQLApi

Eine API für GraphQL-Element.
MountedDataFactory

Eine MountedDataFactory.
SQLDatabase

Eine SQLDatabase.
CopyJob

Ein Kopierauftrag.
VariableLibrary

Eine VariableLibrary.
Dataflow

Ein Datenfluss.
ApacheAirflowJob

Ein ApacheAirflowJob.
WarehouseSnapshot

Eine Warehouse-Momentaufnahme.
DigitalTwinBuilder

Ein DigitalTwinBuilder.
DigitalTwinBuilderFlow

Ein Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog

Ein gespiegelter Azure Databricks-Katalog.
Map

Eine Karte.
AnomalyDetector

Anomaliedetektor.
UserDataFunction

Eine Benutzerdatenfunktion.
GraphModel

Ein GraphModel.
GraphQuerySet

Ein Graph QuerySet.
SnowflakeDatabase

Eine Snowflake-Datenbank zum Speichern von Iceberg-Tabellen, die aus dem Snowflake-Konto erstellt wurden.
OperationsAgent

Ein OperationsAgent.
CosmosDBDatabase

Eine Cosmos DB-Datenbank.
Ontology

Eine Ontologie.
EventSchemaSet

Ein EventSchemaSet.
DataAgent

Ein DataAgent.

PayloadType

Enumeration

Der Typ der Definitionsteilnutzlast. Zusätzliche Nutzlasttypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
InlineBase64

Inlinebasis 64.

PrincipalType

Enumeration

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.

Wert Beschreibung
User

Prinzipal ist ein Microsoft Entra Benutzerprinzipal.
ServicePrincipal

Prinzipal ist ein Microsoft Entra Dienstprinzipal.
Group

Prinzipal ist eine Sicherheitsgruppe.
ServicePrincipalProfile

Prinzipal ist ein Dienstprinzipalprofil.
EntireTenant

Prinzipal stellt alle Mandantenbenutzer dar.

SensitivityLabel

Objekt

Stellt eine Vertraulichkeitsbezeichnung dar, die auf ein Element angewendet wird.

Name Typ Beschreibung
id

string (uuid)

Die Vertraulichkeitsbezeichnungs-ID.

SensitivityLabelApplyStrategy

Enumeration

Die Strategie für die Anwendung der Vertraulichkeitsbezeichnung. Der Standardwert ist ApplyOrFail. Zusätzliche Typen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
ApplyOrFail

Wenden Sie die Vertraulichkeitsbezeichnung an, oder schlagen Sie den Vorgang fehl, wenn er nicht angewendet werden kann.
Ignore

Ignorieren Sie die Vertraulichkeitsbezeichnung, wenn sie nicht angewendet werden kann, und fahren Sie mit dem Vorgang fort, ohne die Bezeichnung anzuwenden.

SensitivityLabelSettings

Objekt

Die Einstellungen für Vertraulichkeitsbezeichnungen.

Name Typ Beschreibung
labelId

string (uuid)

Die Vertraulichkeitsbezeichnungs-ID.
sensitivityLabelApplyStrategy

SensitivityLabelApplyStrategy

Die Strategie für die Anwendung der Vertraulichkeitsbezeichnung.

ServicePrincipalDetails

Objekt

Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp ServicePrincipalist.

Name Typ Beschreibung
aadAppId

string (uuid)

Die Microsoft Entra AppId des Dienstprinzipals.

ServicePrincipalPrincipal

Objekt

Stellt einen Microsoft Entra Dienstprinzipal dar.

Name Typ Beschreibung
displayName

string

Der Anzeigename des Prinzipals.
id

string (uuid)

Die ID des Prinzipals.
servicePrincipalDetails

ServicePrincipalDetails

Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp ServicePrincipalist.
type string:

ServicePrincipal

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.

ServicePrincipalProfileDetails

Objekt

Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp ServicePrincipalProfileist.

Name Typ Beschreibung
parentPrincipal Principal:

Der übergeordnete Prinzipal des Dienstprinzipals.

ServicePrincipalProfilePrincipal

Objekt

Stellt ein Dienstprinzipalprofil dar.

Name Typ Beschreibung
displayName

string

Der Anzeigename des Prinzipals.
id

string (uuid)

Die ID des Prinzipals.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp ServicePrincipalProfileist.
type string:

ServicePrincipalProfile

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.

UserDetails

Objekt

Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp Userist.

Name Typ Beschreibung
userPrincipalName

string

Der Benutzerprinzipalname.

UserPrincipal

Objekt

Stellt einen Microsoft Entra Benutzerprinzipal dar.

Name Typ Beschreibung
displayName

string

Der Anzeigename des Prinzipals.
id

string (uuid)

Die ID des Prinzipals.
type string:

User

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.
userDetails

UserDetails

Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp Userist.