Items - Update Eventhouse Definition

Служба:: Eventhouse

Версия API:: v1

Переопределяет определение для указанного дома событий.
Этот API поддерживает длительные операции (LRO).

Разрешения

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

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

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

Идентификаторы, поддерживаемые Microsoft Entra

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

Идентичность	Поддержка
Пользователь	Да
Представитель службы и управляемые удостоверения	Да

Интерфейс

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

С использованием необязательных параметров:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/eventhouses/{eventhouseId}/updateDefinition?updateMetadata={updateMetadata}

Параметры URI

Имя	В	Обязательно	Тип	Описание
eventhouseId	path	True	string (uuid)	Идентификатор дома событий.
workspaceId	path	True	string (uuid)	Идентификатор рабочей области.
updateMetadata	query		boolean	Если задано значение true и файл платформы предоставляется в рамках определения, метаданные элемента обновляются с помощью метаданных в файле платформы.

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

Имя	Обязательно	Тип	Описание
definition	True	EventhouseDefinition	Объект общедоступного определения Eventhouse. Дополнительные сведения о структуре определения Eventhouse см. в этой статье .

Ответы

Имя	Тип	Описание
200 OK		Запрос успешно завершен.
202 Accepted		Запрос принят. Определение обновления выполняется. Заголовки Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Превышено ограничение скорости обслуживания. Сервер возвращает заголовок, указывающий `Retry-After` в секундах, сколько времени клиент должен ждать перед отправкой дополнительных запросов. Заголовки Retry-After: integer
Other Status Codes	ErrorResponse	Распространенные коды ошибок: OperationNotSupportedForItem — операция не поддерживается для запрошенного элемента. Поврежденный Payload — предоставленные полезные данные повреждены.

Примеры

Update an eventhouse definition example

Образец запроса

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventhouses/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "EventhouseProperties.json",
        "payload": "e30=",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Пример ответа

Код состояния:: 200

Код состояния:: 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

Определения

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

ErrorRelatedResource

Объект

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

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

ErrorResponse

Объект

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

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

ErrorResponseDetails

Объект

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

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

EventhouseDefinition

Объект

Объект общедоступного определения Eventhouse. Дополнительные сведения о структуре определения Eventhouse см. в этой статье .

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

EventhouseDefinitionPart

Объект

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

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

PayloadType

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

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

Значение	Описание
InlineBase64	Встроенная база 64.

UpdateEventhouseDefinitionRequest

Объект

Обновление полезных данных запроса общедоступного определения в хранилище событий.

Имя	Тип	Описание
definition	EventhouseDefinition	Объект общедоступного определения Eventhouse. Дополнительные сведения о структуре определения Eventhouse см. в этой статье .