Condividi tramite

Items - Create Eventhouse

  • Riferimento
Servizio:
Eventhouse
Versione API:
v1

Crea una eventhouse nell'area di lavoro specificata.
Questa API supporta operazioni con esecuzione prolungata (LRO).

Autorizzazioni

Il chiamante deve avere ruolo collaboratore o superiore dell'area di lavoro.

Ambiti delegati obbligatori

Eventhouse.ReadWrite.All o Item.ReadWrite.All

Limitazioni

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identità Appoggiare
Utente Sì
'entità servizio e identità gestite Sì

Interfaccia

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
workspaceId
 path True

string

uuid

ID dell'area di lavoro.

Corpo della richiesta

Nome Necessario Tipo Descrizione
displayName True

string

Nome visualizzato dell'eventhouse. Il nome della casa eventi può contenere caratteri alfanumerici, caratteri di sottolineatura, punti e trattini. I caratteri speciali non sono supportati.
creationPayload

EventhouseCreationPayload

Payload di creazione dell'evento. Usare definition o creationPayload. Non è possibile usare entrambi contemporaneamente.
definition

EventhouseDefinition

Definizione pubblica dell'eventhouse. Usare definition o creationPayload. Non è possibile usare entrambi contemporaneamente.
description

string

Descrizione dell'evento. La lunghezza massima è di 256 caratteri.

Risposte

Nome Tipo Descrizione
201 Created

Eventhouse

Creazione completata
202 Accepted

Richiesta accettata, provisioning eventhouse in corso

Intestazioni

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

ErrorResponse

Codici di errore comuni:

  • InvalidItemType - Tipo di elemento non valido

  • ItemDisplayNameAlreadyInUse: il nome visualizzato dell'elemento è già usato.

  • CorruptedPayload: il payload fornito è danneggiato.

Esempio

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

Create an eventhouse example

Esempio di richiesta

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

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

Risposta di esempio

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

Esempio di richiesta

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

Risposta di esempio

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

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
CreateEventhouseRequest

Creare una richiesta di eventhouse.
ErrorRelatedResource

Oggetto dettagli risorsa correlato all'errore.
ErrorResponse

Risposta di errore.
ErrorResponseDetails

Dettagli della risposta di errore.
Eventhouse

Oggetto eventhouse.
EventhouseCreationPayload

Payload dell'elemento eventhouse
EventhouseDefinition

Oggetto definizione pubblica dell'eventhouse.
EventhouseDefinitionPart

Oggetto parte della definizione dell'evento.
EventhouseProperties

Proprietà dell'eventhouse.
ItemType

Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.
PayloadType

Tipo del payload della parte di definizione. È possibile aggiungere altri tipi di payload nel tempo.

CreateEventhouseRequest

Object

Creare una richiesta di eventhouse.

Nome Tipo Descrizione
creationPayload

EventhouseCreationPayload

Payload di creazione dell'evento. Usare definition o creationPayload. Non è possibile usare entrambi contemporaneamente.
definition

EventhouseDefinition

Definizione pubblica dell'eventhouse. Usare definition o creationPayload. Non è possibile usare entrambi contemporaneamente.
description

string

Descrizione dell'evento. La lunghezza massima è di 256 caratteri.
displayName

string

Nome visualizzato dell'eventhouse. Il nome della casa eventi può contenere caratteri alfanumerici, caratteri di sottolineatura, punti e trattini. I caratteri speciali non sono supportati.

ErrorRelatedResource

Object

Oggetto dettagli risorsa correlato all'errore.

Nome Tipo Descrizione
resourceId

string

ID risorsa coinvolto nell'errore.
resourceType

string

Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Object

Risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
moreDetails

ErrorResponseDetails[]

Elenco di dettagli aggiuntivi sull'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.
requestId

string

ID della richiesta associata all'errore.

ErrorResponseDetails

Object

Dettagli della risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.

Eventhouse

Object

Oggetto eventhouse.

Nome Tipo Descrizione
description

string

Descrizione dell'elemento.
displayName

string

Nome visualizzato dell'elemento.
id

string

uuid

ID elemento.
properties

EventhouseProperties

Proprietà dell'eventhouse.
type

ItemType

Tipo di elemento.
workspaceId

string

uuid

ID dell'area di lavoro.

EventhouseCreationPayload

Object

Payload dell'elemento eventhouse

Nome Tipo Valore predefinito Descrizione
minimumConsumptionUnits

number

double 		0

Quando attivato, la eventhouse è sempre disponibile al livello minimo selezionato e si paga almeno il calcolo minimo selezionato. I valori supportati includono [0, 2.25, 4.25, 8.5, 13, 18, 26, 34, 50] o qualsiasi numero compreso tra 51 e 322. Per altre informazioni, vedere consumo minimo

EventhouseDefinition

Object

Oggetto definizione pubblica dell'eventhouse.

Nome Tipo Descrizione
format

string

Formato della definizione dell'elemento.
parts

EventhouseDefinitionPart[]

Elenco di parti di definizione.

EventhouseDefinitionPart

Object

Oggetto parte della definizione dell'evento.

Nome Tipo Descrizione
path

string

Percorso della parte dell'eventhouse.
payload

string

Payload della parte dell'eventhouse.
payloadType

PayloadType

Tipo di payload.

EventhouseProperties

Object

Proprietà dell'eventhouse.

Nome Tipo Descrizione
databasesItemIds

string[]

uuid

Elenco di tutti gli elementi figlio del database KQL
ingestionServiceUri

string

URI del servizio di inserimento.
queryServiceUri

string

URI del servizio di query.

ItemType

Enumeration

Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.

Valore Descrizione
Dashboard

Dashboard di Power BI.
DataPipeline

Una pipeline di dati.
Datamart

Datamart di PowerBI.
Environment

Un ambiente.
Eventhouse

Una casa eventi.
Eventstream

Flusso di eventi.
GraphQLApi

API per l'elemento GraphQL.
KQLDashboard

Dashboard KQL.
KQLDatabase

Un database KQL.
KQLQueryset

Set di query KQL.
Lakehouse

Una lakehouse.
MLExperiment

Esperimento di Machine Learning.
MLModel

Modello di Machine Learning.
MirroredDatabase

Database con mirroring.
MirroredWarehouse

Magazzino con mirroring.
MountedDataFactory

Oggetto MountedDataFactory.
Notebook

Un notebook.
PaginatedReport

Report impaginato di Power BI.
Reflex

Un riflesso.
Report

Report di Power BI.
SQLDatabase

A SQLDatabase.
SQLEndpoint

Endpoint SQL.
SemanticModel

Modello semantico di PowerBI.
SparkJobDefinition

Definizione di processo Spark.
Warehouse

Un magazzino.

PayloadType

Enumeration

Tipo del payload della parte di definizione. È possibile aggiungere altri tipi di payload nel tempo.

Valore Descrizione
InlineBase64

Inline Base 64.