Items - Create Eventstream

Szolgáltatás:: Eventstream

API-verzió:: v1

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

Az eventstream definícióval való létrehozásához tekintse meg eventstream definíciós.

Engedélyek

A hívónak közreműködői munkaterületi szerepkörrel kell rendelkeznie.

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

Eventstream.ReadWrite.All vagy Item.ReadWrite.All

Korlátozások

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

Microsoft Entra támogatott identitások

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

Azonosság	Támogat
Felhasználó	Igen
szolgáltatás-princípium és felügyelt identitások	Igen

Interfész

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

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énystream megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.
definition		EventstreamDefinition	Az eventstream nyilvános definíciós.
description		string	Az eseménystream leírása. A maximális hossz 256 karakter.
folderId		string (uuid)	A mappa azonosítója. Ha nincs megadva vagy null, az eseménystream a munkaterülettel jön létre mappaként.
sensitivityLabelSettings		SensitivityLabelSettings	Az eseménystream bizalmassági címkebeállításai.

Válaszok

Name	Típus	Description
201 Created	Eventstream	Sikeresen létrehozva
202 Accepted		A kérelem elfogadott, az eventstream kiépítése folyamatban van Fejlécek Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Túllépte a szolgáltatási sebesség korlátját. A kiszolgáló egy `Retry-After` fejlécet ad vissza másodpercek alatt, amely jelzi, hogy az ügyfélnek mennyi ideig kell várnia a további kérések elküldése előtt. Fejlécek 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 eventstream example

Create an eventstream with public definition example

Create an eventstream example

Mintakérelem

HTTP

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

{
  "displayName": "Eventstream_1",
  "description": "Eventstream_1 description."
}

Mintaválasz

Állapotkód:: 201

{
  "displayName": "Eventstream_1",
  "description": "Eventstream_1 description.",
  "type": "Eventstream",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Á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 eventstream with public definition example

Mintakérelem

HTTP

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

{
  "displayName": "Eventstream_1",
  "description": "Eventstream_1 description.",
  "definition": {
    "format": "eventstream",
    "parts": [
      {
        "path": "eventstream.json",
        "payload": "SSdkIGxpa2UgdG8gdGVsbCBh..IGpva2UgZm9yIHlvdS4K",
        "payloadType": "InlineBase64"
      },
      {
        "path": "eventstreamProperties.json",
        "payload": "ewogICJyZXRlbnRpb25UaW1l..V2ZWwiOiAiTG93Igp9",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Mintaválasz

Állapotkód:: 201

{
  "displayName": "Eventstream_1",
  "description": "Eventstream_1 description.",
  "type": "Eventstream",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Á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
CreateEventstreamRequest	Eventstream-kérelem hasznos adatainak létrehozása.
EntireTenantPrincipal	Bérlői tagot jelöl
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
Eventstream	Eseménystream objektum.
EventstreamDefinition	Eventstream nyilvános definíciós objektum. Ebben a cikkben további részleteket talál az Eventstream definíciójának szerkezetéről.
EventstreamDefinitionPart	Eventstream definition part object.
GroupDetails	Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus `Group`.
GroupPrincipal	Biztonsági csoportot jelöl.
GroupType	A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.
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.
PrincipalType	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.
SensitivityLabel	Egy elemre alkalmazott bizalmassági címkét jelöl.
SensitivityLabelApplyStrategy	A bizalmassági címke alkalmazásának stratégiája. Az alapértelmezett érték az ApplyOrFail. Idővel további típusok is hozzáadhatók.
SensitivityLabelSettings	A bizalmassági címke beállításai.
ServicePrincipalDetails	A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipal`.
ServicePrincipalPrincipal	Egy Microsoft Entra szolgáltatásnevet jelöl.
ServicePrincipalProfileDetails	A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Szolgáltatásnév-profilt jelöl.
UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus `User`.
UserPrincipal	Egy Microsoft Entra felhasználónevet jelöl.

CreateEventstreamRequest

Tárgy

Eventstream-kérelem hasznos adatainak létrehozása.

Name	Típus	Description
definition	EventstreamDefinition	Az eventstream nyilvános definíciós.
description	string	Az eseménystream leírása. A maximális hossz 256 karakter.
displayName	string	Az eseménystream megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.
folderId	string (uuid)	A mappa azonosítója. Ha nincs megadva vagy null, az eseménystream a munkaterülettel jön létre mappaként.
sensitivityLabelSettings	SensitivityLabelSettings	Az eseménystream bizalmassági címkebeállításai.

EntireTenantPrincipal

Tárgy

Bérlői tagot jelöl

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
type	string: EntireTenant	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

ErrorRelatedResource

Tárgy

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

Tárgy

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.
isRetriable	boolean	Ha igaz, a kérés újrapróbálkozott. Ha elérhető, a `Retry-After` válaszfejléc használatával állapítsa meg a késést.
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 (uuid)	A hibához társított kérés azonosítója.

ErrorResponseDetails

Tárgy

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.

Eventstream

Tárgy

Eseménystream objektum.

Name	Típus	Description
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Az elem alapértelmezett identitása.
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.
sensitivityLabel	SensitivityLabel	Az elem bizalmassági címkéje.
tags	ItemTag[]	Az alkalmazott címkék listája.
type	ItemType	Az elem típusa.
workspaceId	string (uuid)	A munkaterület azonosítója.

EventstreamDefinition

Tárgy

Eventstream nyilvános definíciós objektum. Ebben a cikkben további részleteket talál az Eventstream definíciójának szerkezetéről.

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

EventstreamDefinitionPart

Tárgy

Eventstream definition part object.

Name	Típus	Description
path	string	Az eseménystream rész elérési útja.
payload	string	Az eventstream rész hasznos adatai.
payloadType	PayloadType	A hasznos adat típusa.

GroupDetails

Tárgy

Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus Group.

Name	Típus	Description
groupType	GroupType	A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.

GroupPrincipal

Tárgy

Biztonsági csoportot jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
groupDetails	GroupDetails	Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus `Group`.
id	string (uuid)	Az igazgató azonosítója.
type	string: Group	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

GroupType

Felsorolás

A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.

Érték	Description
Unknown	Az egyszerű csoport típusa ismeretlen.
SecurityGroup	Az egyszerű egy biztonsági csoport.
DistributionList	Az egyszerű egy terjesztési lista.

ItemTag

Tárgy

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

Felsorolás

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

Érték	Description
Dashboard	PowerBI-irányítópult.
Report	PowerBI-jelentés.
SemanticModel	PowerBI szemantikai modell.
PaginatedReport	Többoldalas PowerBI-jelentés.
Datamart	PowerBI datamart.
Lakehouse	Egy tóház.
Eventhouse	Egy rendezvényház.
Environment	Egy környezet.
KQLDatabase	KQL-adatbázis.
KQLQueryset	KQL-lekérdezéskészlet.
KQLDashboard	KQL-irányítópult.
DataPipeline	Egy adatfolyam.
Notebook	Egy jegyzetfüzet.
SparkJobDefinition	Spark-feladat definíciója.
MLExperiment	Gépi tanulási kísérlet.
MLModel	Gépi tanulási modell.
Warehouse	Egy raktár.
Eventstream	Eseménystream.
SQLEndpoint	EGY SQL-végpont.
MirroredWarehouse	Egy tükrözött raktár.
MirroredDatabase	Tükrözött adatbázis.
Reflex	Egy reflex.
GraphQLApi	Api a GraphQL-elemhez.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Másolási feladat.
VariableLibrary	Egy VariableLibrary.
Dataflow	Adatfolyam.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Raktári pillanatkép.
DigitalTwinBuilder	Egy DigitalTwinBuilder.
DigitalTwinBuilderFlow	A Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	Tükrözött Azure Databricks-katalógus.
Map	Térkép.
AnomalyDetector	Anomáliadetektor.
UserDataFunction	Felhasználói adatfüggvény.
GraphModel	Egy GraphModel.
GraphQuerySet	Egy Graph Queryset.
SnowflakeDatabase	Snowflake-adatbázis a Snowflake-fiókból létrehozott Iceberg-táblák tárolására.
OperationsAgent	Egy OperationsAgent.
CosmosDBDatabase	Cosmos DB-adatbázis.
Ontology	Egy ontológia.
EventSchemaSet	An EventSchemaSet.
DataAgent	Egy DataAgent.
MirroredCatalog	Tükrözöttcatalog.
AppBackend	Egy AppBackend.

PayloadType

Felsorolá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.

PrincipalType

Felsorolás

A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

Érték	Description
User	A rendszernév egy Microsoft Entra felhasználónév.
ServicePrincipal	Az egyszerű szolgáltatásnév egy Microsoft Entra szolgáltatásnév.
Group	Az egyszerű egy biztonsági csoport.
ServicePrincipalProfile	Az egyszerű szolgáltatásnév egy szolgáltatásnév-profil.
EntireTenant	Az egyszerűség az összes bérlőfelhasználót jelöli.

SensitivityLabel

Tárgy

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

Name	Típus	Description
id	string (uuid)	A bizalmassági címke azonosítója.

SensitivityLabelApplyStrategy

Felsorolás

A bizalmassági címke alkalmazásának stratégiája. Az alapértelmezett érték az ApplyOrFail. Idővel további típusok is hozzáadhatók.

Érték	Description
ApplyOrFail	Alkalmazza a bizalmassági címkét, vagy ha nem alkalmazható, akkor a művelet meghiúsul.
Ignore	Hagyja figyelmen kívül a bizalmassági címkét, ha nem alkalmazható, és folytassa a műveletet a címke alkalmazása nélkül.

SensitivityLabelSettings

Tárgy

A bizalmassági címke beállításai.

Name	Típus	Description
labelId	string (uuid)	A bizalmassági címke azonosítója.
sensitivityLabelApplyStrategy	SensitivityLabelApplyStrategy	A bizalmassági címke alkalmazásának stratégiája.

ServicePrincipalDetails

Tárgy

A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus ServicePrincipal.

Name	Típus	Description
aadAppId	string (uuid)	A szolgáltatásnév Microsoft Entra AppId.

ServicePrincipalPrincipal

Tárgy

Egy Microsoft Entra szolgáltatásnevet jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
servicePrincipalDetails	ServicePrincipalDetails	A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipal`.
type	string: ServicePrincipal	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

ServicePrincipalProfileDetails

Tárgy

A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus ServicePrincipalProfile.

Name	Típus	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	A szolgáltatásnév-profil szülőnevét.

ServicePrincipalProfilePrincipal

Tárgy

Szolgáltatásnév-profilt jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

UserDetails

Tárgy

A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus User.

Name	Típus	Description
userPrincipalName	string	A felhasználói főnév.

UserPrincipal

Tárgy

Egy Microsoft Entra felhasználónevet jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
type	string: User	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.
userDetails	UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus `User`.