Delen via

Items - Create Eventhouse

  • Referentie
Service:
Eventhouse
API-versie:
v1

Hiermee maakt u een eventhouse in de opgegeven werkruimte.
Deze API ondersteunt langlopende bewerkingen (LRO).

Machtigingen

De aanroeper moet inzender hebben of een hogere werkruimterol.

Vereiste gedelegeerde bereiken

Eventhouse.ReadWrite.All of Item.ReadWrite.All

Beperkingen

  • Als u een eventhouse wilt maken, moet de werkruimte zich in een ondersteunde Infrastructuurcapaciteit bevinden. Zie voor meer informatie: Microsoft Fabric-licentietypen.

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit Steunen
Gebruiker Ja
service-principal en beheerde identiteiten Ja

Interface

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

URI-parameters

Name In Vereist Type Description
workspaceId
 path True

string

uuid

De werkruimte-id.

Aanvraagbody

Name Vereist Type Description
displayName True

string

De weergavenaam van het eventhouse. De naam van het gebeurtenishuis kan alfanumerieke tekens, onderstrepingstekens, punten en afbreekstreepjes bevatten. Speciale tekens worden niet ondersteund.
creationPayload

EventhouseCreationPayload

De nettolading voor het maken van een eventhouse. Gebruik definition of creationPayload. U kunt beide niet tegelijk gebruiken.
definition

EventhouseDefinition

De openbare definitie van eventhouse. Gebruik definition of creationPayload. U kunt beide niet tegelijk gebruiken.
description

string

De beschrijving van het eventhouse. De maximale lengte is 256 tekens.

Antwoorden

Name Type Description
201 Created

Eventhouse

Gemaakt
202 Accepted

Geaccepteerde aanvraag, inrichting van eventhouse wordt uitgevoerd

Kopteksten

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

ErrorResponse

Veelvoorkomende foutcodes:

  • InvalidItemType - Itemtype is ongeldig

  • ItemDisplayNameAlreadyInUse - Weergavenaam van item wordt al gebruikt.

  • CorruptedPayload: de opgegeven nettolading is beschadigd.

Voorbeelden

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

Create an eventhouse example

Voorbeeldaanvraag

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

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
CreateEventhouseRequest

Gebeurtenishouse-aanvraag maken.
ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.
ErrorResponse

Het foutbericht.
ErrorResponseDetails

De details van het foutbericht.
Eventhouse

Een eventhouse-object.
EventhouseCreationPayload

Nettolading eventhouse-item
EventhouseDefinition

Eventhouse-object voor openbare definitie.
EventhouseDefinitionPart

Eventhouse-definitieonderdeelobject.
EventhouseProperties

De eigenschappen van het eventhouse.
ItemType

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
PayloadType

Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.

CreateEventhouseRequest

Object

Gebeurtenishouse-aanvraag maken.

Name Type Description
creationPayload

EventhouseCreationPayload

De nettolading voor het maken van een eventhouse. Gebruik definition of creationPayload. U kunt beide niet tegelijk gebruiken.
definition

EventhouseDefinition

De openbare definitie van eventhouse. Gebruik definition of creationPayload. U kunt beide niet tegelijk gebruiken.
description

string

De beschrijving van het eventhouse. De maximale lengte is 256 tekens.
displayName

string

De weergavenaam van het eventhouse. De naam van het gebeurtenishuis kan alfanumerieke tekens, onderstrepingstekens, punten en afbreekstreepjes bevatten. Speciale tekens worden niet ondersteund.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name Type Description
resourceId

string

De resource-id die betrokken is bij de fout.
resourceType

string

Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
moreDetails

ErrorResponseDetails[]

Lijst met aanvullende foutdetails.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.
requestId

string

Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.

Eventhouse

Object

Een eventhouse-object.

Name Type Description
description

string

De beschrijving van het item.
displayName

string

De weergavenaam van het item.
id

string

uuid

De item-id.
properties

EventhouseProperties

De eigenschappen van het eventhouse.
type

ItemType

Het itemtype.
workspaceId

string

uuid

De werkruimte-id.

EventhouseCreationPayload

Object

Nettolading eventhouse-item

Name Type Default value Description
minimumConsumptionUnits

number

double 		0

Wanneer dit is geactiveerd, is het eventhouse altijd beschikbaar op het geselecteerde minimumniveau en betaalt u ten minste de minimale rekenkracht die is geselecteerd. Ondersteunde waarden zijn [0, 2.25, 4.25, 8.5, 13, 18, 26, 34, 50] of een getal tussen 51 en 322. Zie minimumverbruik voor meer informatie

EventhouseDefinition

Object

Eventhouse-object voor openbare definitie.

Name Type Description
format

string

De indeling van de itemdefinitie.
parts

EventhouseDefinitionPart[]

Een lijst met definitieonderdelen.

EventhouseDefinitionPart

Object

Eventhouse-definitieonderdeelobject.

Name Type Description
path

string

Het pad naar het eventhouse-onderdeel.
payload

string

De nettolading van het eventhouse-onderdeel.
payloadType

PayloadType

Het nettoladingstype.

EventhouseProperties

Object

De eigenschappen van het eventhouse.

Name Type Description
databasesItemIds

string[]

uuid

Lijst met alle KQL-database-onderliggende items
ingestionServiceUri

string

URI van opnameservice.
queryServiceUri

string

Queryservice-URI.

ItemType

Inventarisatie

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde Description
Dashboard

PowerBI-dashboard.
DataPipeline

Een gegevenspijplijn.
Datamart

PowerBI-datamart.
Environment

Een omgeving.
Eventhouse

Een eventhouse.
Eventstream

Een eventstream.
GraphQLApi

Een API voor GraphQL-item.
KQLDashboard

Een KQL-dashboard.
KQLDatabase

Een KQL-database.
KQLQueryset

Een KQL-queryset.
Lakehouse

Een lakehouse.
MLExperiment

Een machine learning-experiment.
MLModel

Een machine learning-model.
MirroredDatabase

Een gespiegelde database.
MirroredWarehouse

Een gespiegeld magazijn.
MountedDataFactory

Een MountedDataFactory.
Notebook

Een notitieblok.
PaginatedReport

Gepagineerd Power BI-rapport.
Reflex

Een reflex.
Report

PowerBI-rapport.
SQLDatabase

Een SQLDatabase.
SQLEndpoint

Een SQL-eindpunt.
SemanticModel

Semantisch Power BI-model.
SparkJobDefinition

Een Spark-taakdefinitie.
Warehouse

Een magazijn.

PayloadType

Inventarisatie

Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.

Waarde Description
InlineBase64

Inline base 64.