Items - Create Eventhouse

Referencia

Szolgáltatás:: Eventhouse

API-verzió:: v1

Létrehoz egy eseményházat a megadott munkaterületen.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

Engedélyek

A hívónak közreműködői vagy magasabb munkaterületi szerepkört kell tartalmaznia.

Kötelező delegált hatókörök

Eventhouse.ReadWrite.All vagy Item.ReadWrite.All

Korlátozások

Eseményház létrehozásához a munkaterületnek támogatott hálókapacitáson kell lennie. További információ: Microsoft Fabric-licenctípusok.

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság	Támogat
Felhasználó	Igen
szolgáltatásnév és felügyelt identitások	Igen

Interfész

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.

Kérelem törzse

Name	Kötelező	Típus	Description
displayName	True	string	Az eseményház megjelenítendő neve. Az eseményház neve tartalmazhat alfanumerikus karaktereket, aláhúzásjeleket, pontokat és kötőjeleket. A speciális karakterek nem támogatottak.
creationPayload		EventhouseCreationPayload	Az eventhouse létrehozása hasznos adat. `definition` vagy `creationPayload`használata. Egyszerre nem használhatja mindkettőt.
definition		EventhouseDefinition	Az eventhouse nyilvános definíciója. `definition` vagy `creationPayload`használata. Egyszerre nem használhatja mindkettőt.
description		string	Az eseményház leírása. A maximális hossz 256 karakter.

Válaszok

Name	Típus	Description
201 Created	Eventhouse	Sikeresen létrehozva
202 Accepted		A kérelem elfogadva, az eventhouse kiépítése folyamatban van Fejlécek Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Gyakori hibakódok: InvalidItemType – Az elem típusa érvénytelen ItemDisplayNameAlreadyInUse – Az elem megjelenítendő neve már használatban van. CorruptedPayload – A megadott hasznos adatok sérültek. WorkspaceItemsLimitExceeded – A munkaterület elemkorlátja túllépve.

Name

Típus

Description

201 Created

Eventhouse

Sikeresen létrehozva

202 Accepted

A kérelem elfogadva, az eventhouse kiépítése folyamatban van

Fejlécek

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

Other Status Codes

ErrorResponse

Gyakori hibakódok:

InvalidItemType – Az elem típusa érvénytelen
ItemDisplayNameAlreadyInUse – Az elem megjelenítendő neve már használatban van.
CorruptedPayload – A megadott hasznos adatok sérültek.
WorkspaceItemsLimitExceeded – A munkaterület elemkorlátja túllépve.

Példák

Create an eventhouse example

create an eventhouse with creationPayload example

Create an eventhouse with definition example

Create an eventhouse example

Mintakérelem

HTTP

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

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

Mintaválasz

Állapotkód:: 201

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

Állapotkód:: 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

Mintakérelem

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

Mintaválasz

Állapotkód:: 201

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

Állapotkód:: 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

Mintakérelem

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

Mintaválasz

Állapotkód:: 201

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

Állapotkód:: 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

Definíciók

Name	Description
CreateEventhouseRequest	Eseményház-kérés létrehozása.
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
Eventhouse	Eseményház objektum.
EventhouseCreationPayload	Eventhouse-elem hasznos adatai
EventhouseDefinition	Eventhouse nyilvános definíciós objektum.
EventhouseDefinitionPart	Eventhouse definíciós részobjektum.
EventhouseProperties	Az eseményház tulajdonságai.
ItemTag	Egy elemre alkalmazott címkét jelöl.
ItemType	Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
PayloadType	A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.

CreateEventhouseRequest

Objektum

Eseményház-kérés létrehozása.

Name	Típus	Description
creationPayload	EventhouseCreationPayload	Az eventhouse létrehozása hasznos adat. `definition` vagy `creationPayload`használata. Egyszerre nem használhatja mindkettőt.
definition	EventhouseDefinition	Az eventhouse nyilvános definíciója. `definition` vagy `creationPayload`használata. Egyszerre nem használhatja mindkettőt.
description	string	Az eseményház leírása. A maximális hossz 256 karakter.
displayName	string	Az eseményház megjelenítendő neve. Az eseményház neve tartalmazhat alfanumerikus karaktereket, aláhúzásjeleket, pontokat és kötőjeleket. A speciális karakterek nem támogatottak.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string	A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

Eventhouse

Objektum

Eseményház objektum.

Name	Típus	Description
description	string	Az elem leírása.
displayName	string	Az elem megjelenítendő neve.
folderId	string (uuid)	A mappa azonosítója.
id	string (uuid)	Az elem azonosítója.
properties	EventhouseProperties	Az eseményház tulajdonságai.
tags	ItemTag[]	Az alkalmazott címkék listája.
type	ItemType	Az elem típusa.
workspaceId	string (uuid)	A munkaterület azonosítója.

EventhouseCreationPayload

Objektum

Eventhouse-elem hasznos adatai

Name	Típus	Alapértelmezett érték	Description
minimumConsumptionUnits	number (double)	0	Használja a minimális fogyasztást a rendkívül időérzékeny rendszerekhez, hogy a szolgáltatás mindig elérhető legyen egy kiválasztott minimális szinten. A minimális vagy a tényleges fogyasztásért fizet, ha meghaladja a minimumot. A támogatott értékek a következők: [0, 2,25, 4,25, 8,5, 13, 18, 26, 34, 50] vagy bármilyen szám 51 és 322 között. További információ: minimális fogyasztás.

EventhouseDefinition

Objektum

Eventhouse nyilvános definíciós objektum.

Name	Típus	Description
format	string	Az elemdefiníció formátuma.
parts	EventhouseDefinitionPart[]	Definíciórészek listája.

EventhouseDefinitionPart

Objektum

Eventhouse definíciós részobjektum.

Name	Típus	Description
path	string	Az eseményház részútvonala.
payload	string	Az eventhouse rész hasznos adatai.
payloadType	PayloadType	A hasznos adat típusa.

EventhouseProperties

Objektum

Az eseményház tulajdonságai.

Name	Típus	Alapértelmezett érték	Description
databasesItemIds	string[] (uuid)		A KQL-adatbázis összes gyermekének listája
ingestionServiceUri	string		Betöltési szolgáltatás URI-ja.
minimumConsumptionUnits	number (double)	0	Használja a minimális fogyasztást a rendkívül időérzékeny rendszerekhez, hogy a szolgáltatás mindig elérhető legyen egy kiválasztott minimális szinten. A minimális vagy a tényleges fogyasztásért fizet, ha meghaladja a minimumot. A támogatott értékek a következők: [0, 2,25, 4,25, 8,5, 13, 18, 26, 34, 50] vagy bármilyen szám 51 és 322 között. További információ: minimális fogyasztás.
queryServiceUri	string		Lekérdezési szolgáltatás URI-ja.

ItemTag

Objektum

Egy elemre alkalmazott címkét jelöl.

Name	Típus	Description
displayName	string	A címke neve.
id	string (uuid)	A címke azonosítója.

ItemType

Enumerálás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték	Description
CopyJob	Másolási feladat.
Dashboard	PowerBI-irányítópult.
DataPipeline	Egy adatfolyam.
Datamart	PowerBI datamart.
Environment	Egy környezet.
Eventhouse	Egy rendezvényház.
Eventstream	Eseménystream.
GraphQLApi	Api a GraphQL-elemhez.
KQLDashboard	KQL-irányítópult.
KQLDatabase	KQL-adatbázis.
KQLQueryset	KQL-lekérdezéskészlet.
Lakehouse	Egy tóház.
MLExperiment	Gépi tanulási kísérlet.
MLModel	Gépi tanulási modell.
MirroredDatabase	Tükrözött adatbázis.
MirroredWarehouse	Egy tükrözött raktár.
MountedDataFactory	A MountedDataFactory.
Notebook	Egy jegyzetfüzet.
PaginatedReport	Többoldalas PowerBI-jelentés.
Reflex	Egy reflex.
Report	PowerBI-jelentés.
SQLDatabase	A SQLDatabase.
SQLEndpoint	EGY SQL-végpont.
SemanticModel	PowerBI szemantikai modell.
SparkJobDefinition	Spark-feladat definíciója.
VariableLibrary	Egy VariableLibrary.
Warehouse	Egy raktár.

PayloadType

Enumerálás

A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.

Érték	Description
InlineBase64	Beágyazott 64-es alap.

Megosztás a következőn keresztül:

Items - Create Eventhouse

Engedélyek

Kötelező delegált hatókörök

Korlátozások

Microsoft Entra által támogatott identitások

Interfész

URI-paraméterek

Kérelem törzse

Válaszok

Példák

Create an eventhouse example

Mintakérelem

Mintaválasz

create an eventhouse with creationPayload example

Mintakérelem

Mintaválasz

Create an eventhouse with definition example

Mintakérelem

Mintaválasz

Definíciók

CreateEventhouseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

Eventhouse

EventhouseCreationPayload

EventhouseDefinition

EventhouseDefinitionPart

EventhouseProperties

ItemTag

ItemType

PayloadType

További források