Items - Create Eventhouse

Tworzy magazyn zdarzeń w określonym obszarze roboczym.
Ten interfejs API obsługuje długotrwałych operacji (LRO).

Uprawnienia

Obiekt wywołujący musi mieć rolę obszaru roboczego współautora .

Wymagane zakresy delegowane

Eventhouse.ReadWrite.All lub Item.ReadWrite.All

Ograniczenia

  • Aby utworzyć magazyn zdarzeń, obszar roboczy musi znajdować się w obsługiwanej pojemności Fabric. Aby uzyskać więcej informacji, zobacz: typy licencji Microsoft Fabric.

Microsoft Entra obsługiwane tożsamości

Ten interfejs API obsługuje Microsoft identities wymienione w tej sekcji.

Tożsamość Wsparcie
Użytkownik Tak
Główne usługi i Tożsamości zarządzane Tak

Interfejs

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

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
workspaceId
path True

string (uuid)

Identyfikator obszaru roboczego.

Treść żądania

Nazwisko Wymagane Typ Opis
displayName True

string

Nazwa wyświetlana magazynu zdarzeń. Nazwa magazynu zdarzeń może zawierać znaki alfanumeryczne, podkreślenia, kropki i łączniki. Znaki specjalne nie są obsługiwane.

creationPayload

EventhouseCreationPayload

Ładunek tworzenia magazynu zdarzeń. Użyj definition lub creationPayload. Nie można używać obu tych elementów w tym samym czasie.

definition

EventhouseDefinition

Definicja publiczna magazynu zdarzeń. Użyj definition lub creationPayload. Nie można używać obu tych elementów w tym samym czasie.

description

string

Opis magazynu zdarzeń. Maksymalna długość to 256 znaków.

folderId

string (uuid)

Identyfikator folderu. Jeśli nie zostanie określony lub ma wartość null, zostanie utworzony z użyciem obszaru roboczego jako jego folderu.

sensitivityLabelSettings

SensitivityLabelSettings

Ustawienia etykiety poufności dla magazynu zdarzeń.

Odpowiedzi

Nazwisko Typ Opis
201 Created

Eventhouse

Pomyślnie utworzono

202 Accepted

Żądanie zaakceptowane, aprowizowanie magazynu zdarzeń w toku

Nagłówki

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

ErrorResponse

Przekroczono limit szybkości usługi. Serwer zwraca nagłówek wskazujący Retry-After w sekundach, jak długo klient musi czekać przed wysłaniem dodatkowych żądań.

Nagłówki

Retry-After: integer

Other Status Codes

ErrorResponse

Typowe kody błędów:

  • InvalidItemType — typ elementu jest nieprawidłowy

  • ItemDisplayNameAlreadyInUse — nazwa wyświetlana elementu jest już używana.

  • CorruptedPayload — podany ładunek jest uszkodzony.

  • WorkspaceItemsLimitExceeded — przekroczono limit elementu obszaru roboczego.

Przykłady

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

Create an eventhouse example

Przykładowe żądanie

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

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwisko Opis
CreateEventhouseRequest

Utwórz żądanie magazynu zdarzeń.

EntireTenantPrincipal

Reprezentuje podmiot zabezpieczeń dzierżawy

ErrorParameter

Parametr ustrukturyzowany zapewniający dodatkowy kontekst czytelny dla maszyny o błędzie.

ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.

ErrorResponse

Odpowiedź na błąd.

ErrorResponseDetails

Szczegóły odpowiedzi na błąd.

Eventhouse

Obiekt magazynu zdarzeń.

EventhouseCreationPayload

Ładunek elementu usługi Eventhouse

EventhouseDefinition

Obiekt definicji publicznej usługi Eventhouse. Zapoznaj się z tym artykułem , aby uzyskać więcej informacji na temat struktury definicji usługi Eventhouse.

EventhouseDefinitionPart

Obiekt części definicji usługi Eventhouse.

EventhouseProperties

Właściwości magazynu zdarzeń.

GroupDetails

Grupuj szczegółowe informacje. Dotyczy, gdy typ podmiotu zabezpieczeń to Group.

GroupPrincipal

Reprezentuje grupę zabezpieczeń.

GroupType

Typ grupy. Dodatkowe typy grup mogą być dodawane w czasie.

ItemTag

Reprezentuje tag zastosowany w elemencie.

ItemType

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.

PayloadType

Typ ładunku części definicji. Dodatkowe typy ładunków mogą być dodawane w czasie.

PrincipalType

Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

SensitivityLabel

Reprezentuje etykietę poufności zastosowaną do elementu.

SensitivityLabelApplyStrategy

Strategia stosowania etykiety poufności. Wartość domyślna to ApplyOrFail. Dodatkowe typy mogą być dodawane w czasie.

SensitivityLabelSettings

Ustawienia etykiety poufności.

ServicePrincipalDetails

Szczegóły dotyczące jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to ServicePrincipal.

ServicePrincipalPrincipal

Reprezentuje Microsoft Entra jednostkę usługi.

ServicePrincipalProfileDetails

Szczegóły profilu jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to ServicePrincipalProfile.

ServicePrincipalProfilePrincipal

Reprezentuje profil jednostki usługi.

UserDetails

Szczegóły dotyczące podmiotu zabezpieczeń użytkownika. Dotyczy, gdy typ podmiotu zabezpieczeń to User.

UserPrincipal

Reprezentuje Microsoft Entra podmiot zabezpieczeń użytkownika.

CreateEventhouseRequest

Utwórz żądanie magazynu zdarzeń.

Nazwisko Typ Opis
creationPayload

EventhouseCreationPayload

Ładunek tworzenia magazynu zdarzeń. Użyj definition lub creationPayload. Nie można używać obu tych elementów w tym samym czasie.

definition

EventhouseDefinition

Definicja publiczna magazynu zdarzeń. Użyj definition lub creationPayload. Nie można używać obu tych elementów w tym samym czasie.

description

string

Opis magazynu zdarzeń. Maksymalna długość to 256 znaków.

displayName

string

Nazwa wyświetlana magazynu zdarzeń. Nazwa magazynu zdarzeń może zawierać znaki alfanumeryczne, podkreślenia, kropki i łączniki. Znaki specjalne nie są obsługiwane.

folderId

string (uuid)

Identyfikator folderu. Jeśli nie zostanie określony lub ma wartość null, zostanie utworzony z użyciem obszaru roboczego jako jego folderu.

sensitivityLabelSettings

SensitivityLabelSettings

Ustawienia etykiety poufności dla magazynu zdarzeń.

EntireTenantPrincipal

Reprezentuje podmiot zabezpieczeń dzierżawy

Nazwisko Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń.

id

string (uuid)

Identyfikator podmiotu zabezpieczeń.

type string:

EntireTenant

Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

ErrorParameter

Parametr ustrukturyzowany zapewniający dodatkowy kontekst czytelny dla maszyny o błędzie.

Nazwisko Typ Opis
message

string

Czytelny dla człowieka opis znaczenia parametru.

name

string

Identyfikator parametru.

value

string

Wartość parametru.

ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwisko Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.

resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Odpowiedź na błąd.

Nazwisko Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.

isRetriable

boolean

Jeśli to prawda, żądanie można ponowić. Użyj nagłówka Retry-After odpowiedzi, aby określić opóźnienie, jeśli jest dostępne.

message

string

Czytelna reprezentacja błędu przez człowieka.

moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.

parameters

ErrorParameter[]

Parametry ustrukturyzowane zapewniające dodatkowy kontekst czytelny dla maszyny o błędzie.

relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

requestId

string (uuid)

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Szczegóły odpowiedzi na błąd.

Nazwisko Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.

message

string

Czytelna reprezentacja błędu przez człowieka.

parameters

ErrorParameter[]

Parametry ustrukturyzowane zapewniające dodatkowy kontekst czytelny dla maszyny o błędzie.

relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

Eventhouse

Obiekt magazynu zdarzeń.

Nazwisko Typ Opis
defaultIdentity Principal:

Tożsamość domyślna elementu.

description

string

Opis elementu.

displayName

string

Nazwa wyświetlana elementu.

folderId

string (uuid)

Identyfikator folderu.

id

string (uuid)

Identyfikator elementu.

logicalId

string (uuid)

Identyfikator logiczny elementu. Odpowiadające wystąpienia elementów mają ten sam identyfikator logiczny. Wartość ma wartość null, gdy nie przypisano identyfikatora logicznego.

properties

EventhouseProperties

Właściwości magazynu zdarzeń.

sensitivityLabel

SensitivityLabel

Etykieta poufności elementu.

tags

ItemTag[]

Lista zastosowanych tagów.

type

ItemType

Typ elementu.

workspaceId

string (uuid)

Identyfikator obszaru roboczego.

EventhouseCreationPayload

Ładunek elementu usługi Eventhouse

Nazwisko Typ Domyślna wartość Opis
minimumConsumptionUnits

number (double)

0

Użyj opcji Minimalne zużycie w przypadku wysoce wrażliwych na czas systemów, aby zachować dostępność usługi zawsze na wybranym poziomie minimalnym. Płacisz za minimalny poziom zużycia lub rzeczywiste zużycie, jeśli jest wyższe niż minimum. Obsługiwane wartości obejmują [0, 2.25, 4.25, 8.5, 13, 18, 26, 34, 50] lub dowolną liczbę z zakresu od 51 do 322. Aby uzyskać więcej informacji, zobacz minimalne zużycie.

EventhouseDefinition

Obiekt definicji publicznej usługi Eventhouse. Zapoznaj się z tym artykułem , aby uzyskać więcej informacji na temat struktury definicji usługi Eventhouse.

Nazwisko Typ Opis
format

string

Format definicji magazynu zdarzeń.

parts

EventhouseDefinitionPart[]

Lista części definicji.

EventhouseDefinitionPart

Obiekt części definicji usługi Eventhouse.

Nazwisko Typ Opis
path

string

Ścieżka części magazynu zdarzeń.

payload

string

Ładunek części magazynu zdarzeń.

payloadType

PayloadType

Typ ładunku.

EventhouseProperties

Właściwości magazynu zdarzeń.

Nazwisko Typ Domyślna wartość Opis
databasesItemIds

string[] (uuid)

Lista wszystkich elementów podrzędnych bazy danych KQL

ingestionServiceUri

string

Identyfikator URI usługi pozyskiwania.

minimumConsumptionUnits

number (double)

0

Użyj opcji Minimalne zużycie w przypadku wysoce wrażliwych na czas systemów, aby zachować dostępność usługi zawsze na wybranym poziomie minimalnym. Płacisz za minimalny poziom zużycia lub rzeczywiste zużycie, jeśli jest wyższe niż minimum. Obsługiwane wartości obejmują [0, 2.25, 4.25, 8.5, 13, 18, 26, 34, 50] lub dowolną liczbę z zakresu od 51 do 322. Aby uzyskać więcej informacji, zobacz minimalne zużycie.

queryServiceUri

string

Identyfikator URI usługi kwerendy.

GroupDetails

Grupuj szczegółowe informacje. Dotyczy, gdy typ podmiotu zabezpieczeń to Group.

Nazwisko Typ Opis
groupType

GroupType

Typ grupy. Dodatkowe typy grup mogą być dodawane w czasie.

GroupPrincipal

Reprezentuje grupę zabezpieczeń.

Nazwisko Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń.

groupDetails

GroupDetails

Grupuj szczegółowe informacje. Dotyczy, gdy typ podmiotu zabezpieczeń to Group.

id

string (uuid)

Identyfikator podmiotu zabezpieczeń.

type string:

Group

Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

GroupType

Typ grupy. Dodatkowe typy grup mogą być dodawane w czasie.

Wartość Opis
Unknown

Typ grupy podmiotu zabezpieczeń jest nieznany.

SecurityGroup

Podmiot zabezpieczeń jest grupą zabezpieczeń.

DistributionList

Podmiot zabezpieczeń jest listą dystrybucyjną.

ItemTag

Reprezentuje tag zastosowany w elemencie.

Nazwisko Typ Opis
displayName

string

Nazwa znacznika.

id

string (uuid)

Identyfikator tagu.

ItemType

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.

Wartość Opis
Dashboard

Pulpit nawigacyjny usługi Power BI.

Report

Raport usługi Power BI.

SemanticModel

Model semantyczny usługi PowerBI.

PaginatedReport

Raport podzielony na strony usługi PowerBI.

Datamart

Datamart usługi Power BI.

Lakehouse

Jezioro.

Eventhouse

Magazyn zdarzeń.

Environment

Środowisko.

KQLDatabase

Baza danych KQL.

KQLQueryset

Zestaw zapytań KQL.

KQLDashboard

Pulpit nawigacyjny KQL.

DataPipeline

Potok danych.

Notebook

Notes.

SparkJobDefinition

Definicja zadania platformy Spark.

MLExperiment

Eksperyment uczenia maszynowego.

MLModel

Model uczenia maszynowego.

Warehouse

Magazyn.

Eventstream

Strumień zdarzeń.

SQLEndpoint

Punkt końcowy SQL.

MirroredWarehouse

Dublowany magazyn.

MirroredDatabase

Dublowana baza danych.

Reflex

Refleks.

GraphQLApi

Interfejs API dla elementu GraphQL.

MountedDataFactory

A MountedDataFactory.

SQLDatabase

Baza danych SQLDatabase.

CopyJob

Zadanie kopiowania.

VariableLibrary

ZmiennaLibrary.

Dataflow

Przepływ danych.

ApacheAirflowJob

Zadanie ApacheAirflowJob.

WarehouseSnapshot

Migawka magazynu.

DigitalTwinBuilder

A DigitalTwinBuilder.

DigitalTwinBuilderFlow

Przepływ usługi Digital Twin Builder.

MirroredAzureDatabricksCatalog

Dublowany wykaz usługi Azure Databricks.

Map

Mapa.

AnomalyDetector

Wykrywacz anomalii.

UserDataFunction

Funkcja danych użytkownika.

GraphModel

Model programu Graph.

GraphQuerySet

Zestaw zapytań programu Graph.

SnowflakeDatabase

Baza danych Snowflake do przechowywania tabel góry lodowej utworzonych na podstawie konta Snowflake.

OperationsAgent

A OperationsAgent.

CosmosDBDatabase

Baza danych usługi Cosmos DB.

Ontology

Ontologia.

EventSchemaSet

An EventSchemaSet.

DataAgent

A DataAgent.

MirroredCatalog

A MirroredCatalog.

AppBackend

Element AppBackend.

OrgApp

Aplikacja organizacji.

OrgAppAudience

Odbiorcy aplikacji organizacji.

DataBuildToolJob

Obiekt DataBuildToolJob.

AzureDatabricksStorage

Element magazynu oparty na usłudze OneLake dla Azure Databricks.

Plan

Plan.

PayloadType

Typ ładunku części definicji. Dodatkowe typy ładunków mogą być dodawane w czasie.

Wartość Opis
InlineBase64

Śródliniowa baza 64.

PrincipalType

Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

Wartość Opis
User

Podmiot zabezpieczeń jest podmiotem zabezpieczeń Microsoft Entra użytkownika.

ServicePrincipal

Jednostka jest jednostką usługi Microsoft Entra.

Group

Podmiot zabezpieczeń jest grupą zabezpieczeń.

ServicePrincipalProfile

Jednostka jest profilem jednostki usługi.

EntireTenant

Podmiot zabezpieczeń reprezentuje wszystkich użytkowników dzierżawy.

SensitivityLabel

Reprezentuje etykietę poufności zastosowaną do elementu.

Nazwisko Typ Opis
id

string (uuid)

Identyfikator etykiety poufności.

SensitivityLabelApplyStrategy

Strategia stosowania etykiety poufności. Wartość domyślna to ApplyOrFail. Dodatkowe typy mogą być dodawane w czasie.

Wartość Opis
ApplyOrFail

Zastosuj etykietę poufności lub nie powiedzie się operacji, jeśli nie można jej zastosować.

Ignore

Zignoruj etykietę poufności, jeśli nie można jej zastosować i kontynuuj operację bez stosowania etykiety.

SensitivityLabelSettings

Ustawienia etykiety poufności.

Nazwisko Typ Opis
labelId

string (uuid)

Identyfikator etykiety poufności.

sensitivityLabelApplyStrategy

SensitivityLabelApplyStrategy

Strategia stosowania etykiety poufności.

ServicePrincipalDetails

Szczegóły dotyczące jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to ServicePrincipal.

Nazwisko Typ Opis
aadAppId

string (uuid)

Microsoft Entra AppId jednostki usługi.

ServicePrincipalPrincipal

Reprezentuje Microsoft Entra jednostkę usługi.

Nazwisko Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń.

id

string (uuid)

Identyfikator podmiotu zabezpieczeń.

servicePrincipalDetails

ServicePrincipalDetails

Szczegóły dotyczące jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to ServicePrincipal.

type string:

ServicePrincipal

Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

ServicePrincipalProfileDetails

Szczegóły profilu jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to ServicePrincipalProfile.

Nazwisko Typ Opis
parentPrincipal Principal:

Jednostka nadrzędna profilu jednostki usługi.

ServicePrincipalProfilePrincipal

Reprezentuje profil jednostki usługi.

Nazwisko Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń.

id

string (uuid)

Identyfikator podmiotu zabezpieczeń.

servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Szczegóły profilu jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to ServicePrincipalProfile.

type string:

ServicePrincipalProfile

Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

UserDetails

Szczegóły dotyczące podmiotu zabezpieczeń użytkownika. Dotyczy, gdy typ podmiotu zabezpieczeń to User.

Nazwisko Typ Opis
userPrincipalName

string

Główna nazwa użytkownika.

UserPrincipal

Reprezentuje Microsoft Entra podmiot zabezpieczeń użytkownika.

Nazwisko Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń.

id

string (uuid)

Identyfikator podmiotu zabezpieczeń.

type string:

User

Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

userDetails

UserDetails

Szczegóły dotyczące podmiotu zabezpieczeń użytkownika. Dotyczy, gdy typ podmiotu zabezpieczeń to User.