Items - Create Eventhouse

Служба:: Eventhouse

Версия API:: v1

Создает хранилище событий в указанной рабочей области.
Этот API поддерживает длительные операции (LRO).

Разрешения

Вызывающий объект должен иметь роль рабочей области участника .

Обязательные делегированные области

Eventhouse.ReadWrite.All или Item.ReadWrite.All

Ограничения

Чтобы создать хранилище событий, рабочая область должна находиться в поддерживаемой емкости Fabric. Дополнительные сведения см. в статье типов лицензий Microsoft Fabric.

Поддерживаемые удостоверения Microsoft Entra

Этот API поддерживает удостоверения Microsoft , перечисленные в этом разделе.

Тождество	Поддержка
Пользователь	Да
субъекта-службы и управляемых удостоверений	Да

Интерфейс

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
workspaceId	path	True	string (uuid)	Идентификатор рабочей области.

Текст запроса

Имя	Обязательно	Тип	Описание
displayName	True	string	Отображаемое имя дома событий. Имя хранилища событий может содержать буквенно-цифровые символы, символы подчеркивания, периоды и дефисы. Специальные символы не поддерживаются.
creationPayload		EventhouseCreationPayload	Полезные данные создания дома событий. Используйте `definition` или `creationPayload`. Вы не можете использовать оба одновременно.
definition		EventhouseDefinition	Общедоступное определение дома событий. Используйте `definition` или `creationPayload`. Вы не можете использовать оба одновременно.
description		string	Описание дома событий. Максимальная длина — 256 символов.
folderId		string (uuid)	Идентификатор папки. Если не задано или не задано значение NULL, хранилище событий создается с рабочей областью в качестве папки.

Ответы

Имя	Тип	Описание
201 Created	Eventhouse	Успешно создано
202 Accepted		Запрос принят, подготовка в хранилище событий выполняется Заголовки Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Распространенные коды ошибок: InvalidItemType — тип элемента недопустим ItemDisplayNameAlreadyInUse — отображаемое имя элемента уже используется. Поврежденный Payload — предоставленные полезные данные повреждены. WorkspaceItemsLimitExceed — превышено ограничение элемента рабочей области.

Имя

Тип

Описание

201 Created

Eventhouse

Успешно создано

202 Accepted

Запрос принят, подготовка в хранилище событий выполняется

Заголовки

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

Other Status Codes

ErrorResponse

Распространенные коды ошибок:

InvalidItemType — тип элемента недопустим
ItemDisplayNameAlreadyInUse — отображаемое имя элемента уже используется.
Поврежденный Payload — предоставленные полезные данные повреждены.
WorkspaceItemsLimitExceed — превышено ограничение элемента рабочей области.

Примеры

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

Определения

Имя	Описание
CreateEventhouseRequest	Создайте запрос eventhouse.
ErrorRelatedResource	Объект сведений об ошибках, связанных с ресурсом.
ErrorResponse	Ответ на ошибку.
ErrorResponseDetails	Сведения об ответе на ошибку.
Eventhouse	Объект eventhouse.
EventhouseCreationPayload	Полезные данные элемента Eventhouse
EventhouseDefinition	Объект общедоступного определения Eventhouse.
EventhouseDefinitionPart	Объект части определения eventhouse.
EventhouseProperties	Свойства eventhouse.
ItemTag	Представляет тег, примененный к элементу.
ItemType	Тип элемента. С течением времени могут добавляться дополнительные типы элементов.
PayloadType	Тип полезных данных части определения. С течением времени могут добавляться дополнительные типы полезных данных.

CreateEventhouseRequest

Object

Создайте запрос eventhouse.

Имя	Тип	Описание
creationPayload	EventhouseCreationPayload	Полезные данные создания дома событий. Используйте `definition` или `creationPayload`. Вы не можете использовать оба одновременно.
definition	EventhouseDefinition	Общедоступное определение дома событий. Используйте `definition` или `creationPayload`. Вы не можете использовать оба одновременно.
description	string	Описание дома событий. Максимальная длина — 256 символов.
displayName	string	Отображаемое имя дома событий. Имя хранилища событий может содержать буквенно-цифровые символы, символы подчеркивания, периоды и дефисы. Специальные символы не поддерживаются.
folderId	string (uuid)	Идентификатор папки. Если не задано или не задано значение NULL, хранилище событий создается с рабочей областью в качестве папки.

ErrorRelatedResource

Object

Объект сведений об ошибках, связанных с ресурсом.

Имя	Тип	Описание
resourceId	string	Идентификатор ресурса, участвующий в ошибке.
resourceType	string	Тип ресурса, который участвует в ошибке.

ErrorResponse

Object

Ответ на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
moreDetails	ErrorResponseDetails[]	Список дополнительных сведений об ошибке.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.
requestId	string	Идентификатор запроса, связанного с ошибкой.

ErrorResponseDetails

Object

Сведения об ответе на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.

Eventhouse

Object

Объект eventhouse.

Имя	Тип	Описание
description	string	Описание элемента.
displayName	string	Отображаемое имя элемента.
folderId	string (uuid)	Идентификатор папки.
id	string (uuid)	Идентификатор элемента.
properties	EventhouseProperties	Свойства eventhouse.
tags	ItemTag[]	Список примененных тегов.
type	ItemType	Тип элемента.
workspaceId	string (uuid)	Идентификатор рабочей области.

EventhouseCreationPayload

Object

Полезные данные элемента Eventhouse

Имя	Тип	Default value	Описание
minimumConsumptionUnits	number (double)	0	Используйте минимальное потребление для высокочувствительных систем времени, чтобы обеспечить доступность службы на выбранном минимальном уровне. Вы платите за минимальный уровень потребления или фактическое потребление, если выше минимального. Поддерживаемые значения включают [0, 2.25, 4.25, 8.5, 13, 18, 26, 34, 50] или любое число от 51 до 322. Дополнительные сведения см. в разделе минимальныхпотребления.

EventhouseDefinition

Object

Объект общедоступного определения Eventhouse.

Имя	Тип	Описание
format	string	Формат определения элемента.
parts	EventhouseDefinitionPart[]	Список частей определения.

EventhouseDefinitionPart

Object

Объект части определения eventhouse.

Имя	Тип	Описание
path	string	Путь к части события.
payload	string	Полезные данные части eventhouse.
payloadType	PayloadType	Тип полезных данных.

EventhouseProperties

Object

Свойства eventhouse.

Имя	Тип	Default value	Описание
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

Представляет тег, примененный к элементу.

Имя	Тип	Описание
displayName	string	Имя тега.
id	string (uuid)	Идентификатор тега.

ItemType

Перечисление

Тип элемента. С течением времени могут добавляться дополнительные типы элементов.

Значение	Описание
ApacheAirflowJob	An ApacheAirflowJob.
CopyJob	Задание копирования.
Dashboard	Панель мониторинга PowerBI.
DataPipeline	Конвейер данных.
Dataflow	Поток данных.
Datamart	Datamart PowerBI.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Поток Конструктора цифровых двойников.
Environment	Среда.
Eventhouse	Хранилище событий.
Eventstream	Поток событий.
GraphQLApi	API для элемента GraphQL.
KQLDashboard	Панель мониторинга KQL.
KQLDatabase	База данных KQL.
KQLQueryset	Набор запросов KQL.
Lakehouse	Озеро.
MLExperiment	Эксперимент машинного обучения.
MLModel	Модель машинного обучения.
MirroredAzureDatabricksCatalog	Зеркальный каталог azure databricks.
MirroredDatabase	Зеркальная база данных.
MirroredWarehouse	Зеркальный склад.
MountedDataFactory	ПодключеннаяdataFactory.
Notebook	Записная книжка.
PaginatedReport	Отчет с разбивкой на страницы PowerBI.
Reflex	Рефлекс.
Report	Отчет PowerBI.
SQLDatabase	База данных SQLDatabase.
SQLEndpoint	Конечная точка SQL.
SemanticModel	Семантическая модель PowerBI.
SparkJobDefinition	Определение задания Spark.
VariableLibrary	ПеременнаяLibrary.
Warehouse	Склад.
WarehouseSnapshot	Моментальный снимок хранилища.

PayloadType

Перечисление

Тип полезных данных части определения. С течением времени могут добавляться дополнительные типы полезных данных.

Значение	Описание
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