Items - Create Eventhouse
Cria uma casa de eventos no espaço de trabalho especificado.
Esta API suporta operações de longa duração (LRO).
Permissões
O chamador deve ter função de colaborador ou superior do espaço de trabalho.
Escopos delegados necessários
Eventhouse.ReadWrite.All ou Item.ReadWrite.All
Limitações
- Para criar uma casa de eventos, o espaço de trabalho deve estar em uma capacidade de malha suportada. Para obter mais informações, consulte: Tipos de licença do Microsoft Fabric.
Identidades suportadas pelo Microsoft Entra
Esta API suporta as identidades do Microsoft listadas nesta secção.
Identidade | Suporte |
---|---|
Utilizador | Sim |
da entidade de serviço e identidades gerenciadas | Sim |
Interface
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/eventhouses
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
O ID do espaço de trabalho. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
displayName | True |
string |
O nome de exibição da casa de eventos. O nome da casa de eventos pode conter caracteres alfanuméricos, sublinhados, pontos e hífenes. Não há suporte para caracteres especiais. |
creationPayload |
A carga útil de criação da casa de eventos. Use |
||
definition |
A definição pública da casa de eventos. Use |
||
description |
string |
A descrição da casa de eventos. O comprimento máximo é de 256 caracteres. |
Respostas
Name | Tipo | Description |
---|---|---|
201 Created |
Criado com sucesso |
|
202 Accepted |
Pedido aceite, fornecimento de eventhouse em curso Cabeçalhos
|
|
Other Status Codes |
Códigos de erro comuns:
|
Exemplos
Create an eventhouse example |
create an eventhouse with creation |
Create an eventhouse with definition example |
Create an eventhouse example
Pedido de amostra
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventhouses
{
"displayName": "Eventhouse_1",
"description": "An eventhouse description."
}
Resposta da amostra
{
"displayName": "Eventhouse_1",
"description": "An eventhouse description.",
"type": "Eventhouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047655"
}
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
Pedido de amostra
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
}
}
Resposta da amostra
{
"displayName": "Eventhouse_1",
"description": "An eventhouse description.",
"type": "Eventhouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047655"
}
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
Pedido de amostra
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"
}
]
}
}
Resposta da amostra
{
"displayName": "Eventhouse_1",
"description": "An eventhouse description.",
"type": "Eventhouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047655"
}
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
Definições
Name | Description |
---|---|
Create |
Crie uma solicitação de casa de eventos. |
Error |
O objeto de detalhes do recurso relacionado ao erro. |
Error |
A resposta de erro. |
Error |
Os detalhes da resposta de erro. |
Eventhouse |
Um objeto eventhouse. |
Eventhouse |
Carga útil do item Eventhouse |
Eventhouse |
Objeto de definição pública da Eventhouse. |
Eventhouse |
Objeto da parte de definição da casa de eventos. |
Eventhouse |
As propriedades da casa de eventos. |
Item |
O tipo do item. Tipos de itens adicionais podem ser adicionados ao longo do tempo. |
Payload |
O tipo de carga útil da peça de definição. Ao longo do tempo, podem ser adicionados tipos de carga útil adicionais. |
CreateEventhouseRequest
Crie uma solicitação de casa de eventos.
Name | Tipo | Description |
---|---|---|
creationPayload |
A carga útil de criação da casa de eventos. Use |
|
definition |
A definição pública da casa de eventos. Use |
|
description |
string |
A descrição da casa de eventos. O comprimento máximo é de 256 caracteres. |
displayName |
string |
O nome de exibição da casa de eventos. O nome da casa de eventos pode conter caracteres alfanuméricos, sublinhados, pontos e hífenes. Não há suporte para caracteres especiais. |
ErrorRelatedResource
O objeto de detalhes do recurso relacionado ao erro.
Name | Tipo | Description |
---|---|---|
resourceId |
string |
A ID do recurso envolvida no erro. |
resourceType |
string |
O tipo de recurso envolvido no erro. |
ErrorResponse
A resposta de erro.
Name | Tipo | Description |
---|---|---|
errorCode |
string |
Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários. |
message |
string |
Uma representação legível por humanos do erro. |
moreDetails |
Lista de detalhes de erro adicionais. |
|
relatedResource |
Os detalhes do recurso relacionados ao erro. |
|
requestId |
string |
ID da solicitação associada ao erro. |
ErrorResponseDetails
Os detalhes da resposta de erro.
Name | Tipo | Description |
---|---|---|
errorCode |
string |
Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários. |
message |
string |
Uma representação legível por humanos do erro. |
relatedResource |
Os detalhes do recurso relacionados ao erro. |
Eventhouse
Um objeto eventhouse.
Name | Tipo | Description |
---|---|---|
description |
string |
A descrição do item. |
displayName |
string |
O nome de exibição do item. |
id |
string uuid |
O ID do item. |
properties |
As propriedades da casa de eventos. |
|
type |
O tipo de item. |
|
workspaceId |
string uuid |
O ID do espaço de trabalho. |
EventhouseCreationPayload
Carga útil do item Eventhouse
EventhouseDefinition
Objeto de definição pública da Eventhouse.
Name | Tipo | Description |
---|---|---|
format |
string |
O formato da definição do item. |
parts |
Uma lista de partes de definição. |
EventhouseDefinitionPart
Objeto da parte de definição da casa de eventos.
Name | Tipo | Description |
---|---|---|
path |
string |
O caminho da parte da casa de eventos. |
payload |
string |
A carga útil da parte da casa de eventos. |
payloadType |
O tipo de carga útil. |
EventhouseProperties
As propriedades da casa de eventos.
Name | Tipo | Description |
---|---|---|
databasesItemIds |
string[] uuid |
Lista de todos os filhos do banco de dados KQL |
ingestionServiceUri |
string |
URI do serviço de ingestão. |
queryServiceUri |
string |
URI do serviço de consulta. |
ItemType
O tipo do item. Tipos de itens adicionais podem ser adicionados ao longo do tempo.
Valor | Description |
---|---|
Dashboard |
Painel do PowerBI. |
DataPipeline |
Um pipeline de dados. |
Datamart |
Datamart do PowerBI. |
Environment |
Um ambiente. |
Eventhouse |
Uma casa de eventos. |
Eventstream |
Um fluxo de eventos. |
GraphQLApi |
Uma API para o item GraphQL. |
KQLDashboard |
Um painel KQL. |
KQLDatabase |
Um banco de dados KQL. |
KQLQueryset |
Um conjunto de consultas KQL. |
Lakehouse |
Uma casa no lago. |
MLExperiment |
Uma experiência de aprendizagem automática. |
MLModel |
Um modelo de aprendizagem automática. |
MirroredDatabase |
Um banco de dados espelhado. |
MirroredWarehouse |
Um armazém espelhado. |
MountedDataFactory |
Um MountedDataFactory. |
Notebook |
Um caderno. |
PaginatedReport |
Relatório paginado do PowerBI. |
Reflex |
Um reflexo. |
Report |
Relatório do PowerBI. |
SQLDatabase |
Um SQLDatabase. |
SQLEndpoint |
Um ponto de extremidade SQL. |
SemanticModel |
Modelo semântico do PowerBI. |
SparkJobDefinition |
Uma definição de trabalho de faísca. |
Warehouse |
Um armazém. |
PayloadType
O tipo de carga útil da peça de definição. Ao longo do tempo, podem ser adicionados tipos de carga útil adicionais.
Valor | Description |
---|---|
InlineBase64 |
Base em linha 64. |