Items - Update Eventstream

Szolgáltatás:: Eventstream

API-verzió:: v1

Frissíti a megadott eseménystream tulajdonságait.

Engedélyek

A hívónak olvasási és írási engedélyekkel kell rendelkeznie az eseménystreamhez.

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

Eventstream.ReadWrite.All vagy Item.ReadWrite.All

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

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

URI-paraméterek

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

Kérelem törzse

Name	Típus	Description
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.

Válaszok

Name Típus Description

200 OK

Name	Típus	Description
200 OK	Eventstream	A kérés sikeresen befejeződött.
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: ItemNotFound – A kért elem nem található. InvalidRequest – Érvénytelen frissítési kérelem.

Eventstream

A kérés sikeresen befejeződött.

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:

ItemNotFound – A kért elem nem található.
InvalidRequest – Érvénytelen frissítési kérelem.

Példák

Update an eventstream example

Mintakérelem

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventstreams/5b218778-e7a5-4d73-8187-f10824047715

{
  "displayName": "Eventstream_New_Name",
  "description": "A new description for eventstream."
}

Mintaválasz

Állapotkód:: 200

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

Definíciók

Name	Description
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.
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.
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.
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.
UpdateEventstreamRequest	Eseménystream-kérés frissítése.
UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus `User`.
UserPrincipal	Egy Microsoft Entra felhasználónevet jelöl.

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.

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.

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.

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.

UpdateEventstreamRequest

Tárgy

Eseménystream-kérés frissítése.

Name	Típus	Description
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.

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`.