Items - Create Eventhouse

服務:: Eventhouse

API 版本:: v1

在指定的工作區中建立 eventhouse。
此 API 支援長時間執行的作業（LRO）。

權限

呼叫端必須具有 參與者 工作區角色。

必要的委派範圍

Eventhouse.ReadWrite.All 或 Item.ReadWrite.All

局限性

若要建立 eventhouse，工作區必須位於支援的網狀架構容量上。如需詳細資訊，請參閱：Microsoft Fabric 授權類型。

Microsoft Entra 支援的身分識別

此 API 支援本節中列出的Microsoft 身分識別。

身份	支援
使用者	是的
服務主體和受控識別	是的

介面

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

URI 參數

名稱	位於	必要	類型	Description
workspaceId	path	True	string (uuid)	工作區標識碼。

要求本文

名稱	必要	類型	Description
displayName	True	string	eventhouse 顯示名稱。 eventhouse 名稱可以包含英數位元、底線、句號和連字元。不支援特殊字元。
creationPayload		EventhouseCreationPayload	Eventhouse 建立承載。使用 `definition` 或 `creationPayload`。您無法同時使用這兩者。
definition		EventhouseDefinition	eventhouse 公用定義。使用 `definition` 或 `creationPayload`。您無法同時使用這兩者。
description		string	eventhouse 描述。長度上限為 256 個字元。
folderId		string (uuid)	資料夾識別碼。如果未指定或 Null，則會使用工作區作為其資料夾來建立 eventhouse。

回應

名稱	類型	Description
201 Created	Eventhouse	已成功建立
202 Accepted		要求已接受，正在進行 eventhouse 布建標題 Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	常見的錯誤碼： InvalidItemType - 項目類型無效 ItemDisplayNameAlreadyInUse - 已使用項目顯示名稱。 CorruptedPayload - 提供的承載已損毀。 WorkspaceItemsLimitExceeded - 超過工作區專案限制。

名稱

類型

Description

201 Created

Eventhouse

已成功建立

202 Accepted

要求已接受，正在進行 eventhouse 布建

標題

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

常見的錯誤碼：

InvalidItemType - 項目類型無效
ItemDisplayNameAlreadyInUse - 已使用項目顯示名稱。
CorruptedPayload - 提供的承載已損毀。
WorkspaceItemsLimitExceeded - 超過工作區專案限制。

範例

Create an eventhouse example

create an eventhouse with creationPayload example

Create an eventhouse with definition example

Create an eventhouse example

範例要求

HTTP

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

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

範例回覆

狀態碼:: 201

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}

狀態碼:: 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

範例要求

HTTP

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

範例回覆

狀態碼:: 201

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}

狀態碼:: 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

範例要求

HTTP

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

範例回覆

狀態碼:: 201

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}

狀態碼:: 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

定義

名稱	Description
CreateEventhouseRequest	建立 eventhouse 要求。
ErrorRelatedResource	錯誤相關的資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應詳細數據。
Eventhouse	eventhouse 物件。
EventhouseCreationPayload	Eventhouse 項目承載
EventhouseDefinition	Eventhouse 公用定義物件。
EventhouseDefinitionPart	Eventhouse 定義部分物件。
EventhouseProperties	eventhouse 屬性。
ItemTag	表示在專案上套用的標記。
ItemType	專案的型別。可能會隨著時間新增其他項目類型。
PayloadType	定義元件承載的類型。可能會隨著時間新增其他承載類型。

CreateEventhouseRequest

Object

建立 eventhouse 要求。

名稱	類型	Description
creationPayload	EventhouseCreationPayload	Eventhouse 建立承載。使用 `definition` 或 `creationPayload`。您無法同時使用這兩者。
definition	EventhouseDefinition	eventhouse 公用定義。使用 `definition` 或 `creationPayload`。您無法同時使用這兩者。
description	string	eventhouse 描述。長度上限為 256 個字元。
displayName	string	eventhouse 顯示名稱。 eventhouse 名稱可以包含英數位元、底線、句號和連字元。不支援特殊字元。
folderId	string (uuid)	資料夾識別碼。如果未指定或 Null，則會使用工作區作為其資料夾來建立 eventhouse。

ErrorRelatedResource

Object

錯誤相關的資源詳細資料物件。

名稱	類型	Description
resourceId	string	發生錯誤的資源識別碼。
resourceType	string	發生錯誤的資源類型。

ErrorResponse

Object

錯誤回應。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
moreDetails	ErrorResponseDetails[]	其他錯誤詳細數據的清單。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。
requestId	string	與錯誤相關聯的要求標識碼。

ErrorResponseDetails

Object

錯誤回應詳細數據。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。

Eventhouse

Object

eventhouse 物件。

名稱	類型	Description
description	string	專案描述。
displayName	string	項目顯示名稱。
folderId	string (uuid)	資料夾識別碼。
id	string (uuid)	項目標識碼。
properties	EventhouseProperties	eventhouse 屬性。
tags	ItemTag[]	已套用標籤的清單。
type	ItemType	項目類型。
workspaceId	string (uuid)	工作區標識碼。

EventhouseCreationPayload

Object

Eventhouse 項目承載

名稱	類型	預設值	Description
minimumConsumptionUnits	number (double)	0	針對高度時間敏感的系統使用最低耗用量，讓服務一律保持在選取的最低層級。如果高於最小值，您需支付最低耗用量層級或實際耗用量的費用。支援的值包括 [0、2.25、4.25、8.5、13、18、26、34、50] 或任何介於 51 到 322 之間的數位。如需詳細資訊，請參閱最低耗用量。

EventhouseDefinition

Object

Eventhouse 公用定義物件。

名稱	類型	Description
format	string	項目定義的格式。
parts	EventhouseDefinitionPart[]	定義元件的清單。

EventhouseDefinitionPart

Object

Eventhouse 定義部分物件。

名稱	類型	Description
path	string	eventhouse 元件路徑。
payload	string	Eventhouse 元件承載。
payloadType	PayloadType	承載類型。

EventhouseProperties

Object

eventhouse 屬性。

名稱	類型	預設值	Description
databasesItemIds	string[] (uuid)		所有 KQL 資料庫子系的清單
ingestionServiceUri	string		擷取服務 URI。
minimumConsumptionUnits	number (double)	0	針對高度時間敏感的系統使用最低耗用量，讓服務一律保持在選取的最低層級。如果高於最小值，您需支付最低耗用量層級或實際耗用量的費用。支援的值包括 [0、2.25、4.25、8.5、13、18、26、34、50] 或任何介於 51 到 322 之間的數位。如需詳細資訊，請參閱最低耗用量。
queryServiceUri	string		查詢服務 URI。

ItemTag

Object

表示在專案上套用的標記。

名稱	類型	Description
displayName	string	標籤的名稱。
id	string (uuid)	標記標識碼。

ItemType

列舉型別

專案的型別。可能會隨著時間新增其他項目類型。

值	Description
Dashboard	PowerBI 儀錶板。
Report	PowerBI 報表。
SemanticModel	PowerBI 語意模型。
PaginatedReport	PowerBI 編頁報表。
Datamart	PowerBI datamart。
Lakehouse	湖屋
Eventhouse	事件屋。
Environment	環境。
KQLDatabase	KQL 資料庫。
KQLQueryset	KQL 查詢集。
KQLDashboard	KQL 儀錶板。
DataPipeline	數據管線。
Notebook	筆記本。
SparkJobDefinition	Spark 作業定義。
MLExperiment	機器學習實驗。
MLModel	機器學習模型。
Warehouse	倉儲。
Eventstream	eventstream。
SQLEndpoint	SQL 端點。
MirroredWarehouse	鏡像倉儲。
MirroredDatabase	鏡像資料庫。
Reflex	反射。
GraphQLApi	GraphQL 專案的 API。
MountedDataFactory	MountedDataFactory。
SQLDatabase	SQLDatabase。
CopyJob	複製作業。
VariableLibrary	VariableLibrary。
Dataflow	數據流。
ApacheAirflowJob	ApacheAirflowJob。
WarehouseSnapshot	倉儲快照集。
DigitalTwinBuilder	DigitalTwinBuilder。
DigitalTwinBuilderFlow	數字對應項產生器流程。
MirroredAzureDatabricksCatalog	鏡像的 Azure databricks 目錄。
Map	一張地圖。
AnomalyDetector	異常偵測器。
UserDataFunction	使用者資料函數。
GraphModel	GraphModel 的 GraphModel。
GraphQuerySet	圖形 QuerySet。
SnowflakeDatabase	一個 Snowflake 資料庫，用來儲存由 Snowflake 帳號建立的 Iceberg 表格。
OperationsAgent	一個行動特工。
CosmosDBDatabase	一個 Cosmos 資料庫。
Ontology	一個本體論。
EventSchemaSet	一個事件結構集。

PayloadType

列舉型別

定義元件承載的類型。可能會隨著時間新增其他承載類型。

值	Description
InlineBase64	內嵌基底 64。

共用方式為

Items - Create Eventhouse

權限

必要的委派範圍

局限性

Microsoft Entra 支援的身分識別

介面

URI 參數

要求本文

回應

範例

Create an eventhouse example

範例要求

範例回覆

create an eventhouse with creationPayload example

範例要求

範例回覆

Create an eventhouse with definition example

範例要求

範例回覆

定義

CreateEventhouseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

Eventhouse

EventhouseCreationPayload

EventhouseDefinition

EventhouseDefinitionPart

EventhouseProperties

ItemTag

ItemType

PayloadType