Items - Get Upstream Relations (beta)

Служба:: Core

Версия API:: v1

Возвращает отношения вышестоящего потока для элемента.

Note

Этот API является частью бета-версии и предоставляется только для оценки и разработки. Он может изменяться на основе отзывов и не рекомендуется для производственного использования. При вызове этого API вызывающие серверы должны указать true значение параметра betaзапроса.

Возвращает все элементы, которые являются вышестоящими элементами указанного элемента, включая реляционные края и ссылки на рабочие области.

Разрешения

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

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

Item.Read.All или Item.ReadWrite.All

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

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

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

Интерфейс

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/relations/upstream?beta={beta}

Параметры URI

Имя	В	Обязательно	Тип	Описание
itemId	path	True	string (uuid)	Идентификатор элемента.
workspaceId	path	True	string (uuid)	Идентификатор рабочей области.
beta	query	True	boolean	Этот обязательный параметр должен быть установлен для `true` доступа к этому API, который в настоящее время находится в бета-версии.

Ответы

Имя Тип Описание

200 OK

Имя	Тип	Описание
200 OK	RelationsResponse	Запрос успешно завершен.
429 Too Many Requests	ErrorResponse	Превышено ограничение скорости обслуживания. Сервер возвращает заголовок, указывающий `Retry-After` в секундах, сколько времени клиент должен ждать перед отправкой дополнительных запросов. Заголовки Retry-After: integer
Other Status Codes	ErrorResponse	Распространенные коды ошибок: ItemNotFound — запрошенный элемент не найден. НедостаточноPrivileges — вызывающий объект не имеет достаточных разрешений для доступа к элементу.

RelationsResponse

Запрос успешно завершен.

429 Too Many Requests

ErrorResponse

Превышено ограничение скорости обслуживания. Сервер возвращает заголовок, указывающий Retry-After в секундах, сколько времени клиент должен ждать перед отправкой дополнительных запросов.

Заголовки

Retry-After: integer

Other Status Codes

ErrorResponse

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

ItemNotFound — запрошенный элемент не найден.
НедостаточноPrivileges — вызывающий объект не имеет достаточных разрешений для доступа к элементу.

Примеры

Get upstream relations example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/3546052c-ae64-4526-b1a8-52af7761426f/relations/upstream?beta=True

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

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

{
  "items": [
    {
      "id": "9b218778-e7a5-4d73-8187-f10824047715",
      "type": "Lakehouse",
      "displayName": "Enterprise Sales Lakehouse",
      "workspaceId": "9a1f7d8b-4f9c-4c1e-b8e7-3d6c2b0a5f41"
    }
  ],
  "relations": [
    {
      "itemId": "3546052c-ae64-4526-b1a8-52af7761426f",
      "dependentOnItemId": "9b218778-e7a5-4d73-8187-f10824047715",
      "relationType": "PushData"
    }
  ],
  "workspaces": [
    {
      "id": "9a1f7d8b-4f9c-4c1e-b8e7-3d6c2b0a5f41",
      "displayName": "Data Engineering Workspace"
    }
  ]
}

Определения

Имя	Описание
ErrorRelatedResource	Объект сведений об ошибках, связанных с ресурсом.
ErrorResponse	Ответ на ошибку.
ErrorResponseDetails	Сведения об ответе на ошибку.
ItemType	Тип элемента. С течением времени могут добавляться дополнительные типы элементов.
RelationsEdge	Реляционная граница между двумя элементами.
RelationsRelatedItem	Элемент, связанный с указанным элементом. Это подмножество полного объекта элемента, содержащее только свойства, возвращаемые API отношений.
RelationsResponse	Ответ, содержащий связанные элементы, реляционные края и ссылки на рабочие области.
RelationsWorkspace	Рабочая область, указанная в ответе на отношения.
RelationType	Тип отношения между двумя элементами. С течением времени могут добавляться дополнительные типы отношений.

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	Сведения об ошибках, связанных с ресурсом.

ItemType

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

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

Значение	Описание
Dashboard	Панель мониторинга PowerBI.
Report	Отчет PowerBI.
SemanticModel	Семантическая модель PowerBI.
PaginatedReport	Отчет с разбивкой на страницы PowerBI.
Datamart	Datamart PowerBI.
Lakehouse	Лейкхаус.
Eventhouse	Хранилище событий.
Environment	Среда.
KQLDatabase	База данных KQL.
KQLQueryset	Набор запросов KQL.
KQLDashboard	Панель мониторинга KQL.
DataPipeline	Конвейер данных.
Notebook	Записная книжка.
SparkJobDefinition	Определение задания Spark.
MLExperiment	Эксперимент машинного обучения.
MLModel	Модель машинного обучения.
Warehouse	Склад.
Eventstream	Поток событий.
SQLEndpoint	Конечная точка SQL.
MirroredWarehouse	Зеркальный склад.
MirroredDatabase	Зеркальная база данных.
Reflex	Рефлекс.
GraphQLApi	API для элемента GraphQL.
MountedDataFactory	ПодключеннаяdataFactory.
SQLDatabase	База данных SQLDatabase.
CopyJob	Задание копирования.
VariableLibrary	ПеременнаяLibrary.
Dataflow	Поток данных.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Моментальный снимок хранилища.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Поток Конструктора цифровых двойников.
MirroredAzureDatabricksCatalog	Зеркальный каталог azure databricks.
Map	Карта.
AnomalyDetector	Детектор аномалий.
UserDataFunction	Функция данных пользователя.
GraphModel	A GraphModel.
GraphQuerySet	Набор запросов Graph.
SnowflakeDatabase	База данных Snowflake для хранения таблиц Iceberg, созданных из учетной записи Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	База данных Cosmos DB.
Ontology	An Ontology.
EventSchemaSet	An EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	ЗеркальныйCatalog.
AppBackend	An AppBackend.
OrgApp	Приложение организации.
OrgAppAudience	Аудитория приложений организации.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	Элемент хранилища с поддержкой OneLake для Azure Databricks.
Plan	План.

RelationsEdge

Объект

Реляционная граница между двумя элементами.

Имя	Тип	Описание
dependentOnItemId	string (uuid)	Идентификатор элемента, от который зависит исходный элемент.
itemId	string (uuid)	Идентификатор исходного элемента.
relationType	RelationType	Тип отношения между двумя элементами. С течением времени могут добавляться дополнительные типы отношений.

RelationsRelatedItem

Объект

Элемент, связанный с указанным элементом. Это подмножество полного объекта элемента, содержащее только свойства, возвращаемые API отношений.

Имя	Тип	Описание
displayName	string	Отображаемое имя элемента.
id	string (uuid)	Идентификатор элемента.
type	ItemType	Тип элемента.
workspaceId	string (uuid)	Идентификатор рабочей области, содержащей элемент. Используйте этот идентификатор, чтобы найти рабочую область в списке `workspaces` .

RelationsResponse

Объект

Ответ, содержащий связанные элементы, реляционные края и ссылки на рабочие области.

Имя	Тип	Описание
items	RelationsRelatedItem[]	Список связанных элементов.
relations	RelationsEdge[]	Список реляционных ребер между элементами.
workspaces	RelationsWorkspace[]	Список рабочих областей, на которые ссылается связанные элементы.

RelationsWorkspace

Объект

Рабочая область, указанная в ответе на отношения.

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

RelationType

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

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

Значение	Описание
CascadeDelete	Связь CascadeDelete указывает, что элемент является родительским элементом зависимого ЭлементаOnItemId и удаление элемента приведет к удалению зависимого элемента.
WeakAssociation	Связь WeakAssociation указывает на то, что у элемента, определяемого зависимымOnItemId, имеется обратимая зависимость. Если зависимый элемент удален, связь будет удалена.
Datasource	Связь источника данных указывает на то, что существует мягкая зависимость от элемента, определяемого общим источником данных. Если зависимый элемент удален, связь будет удалена.
PushData	Связь PushData указывает, что зависимый элемент записывает или отправляет данные в элемент зависимости (элемент, определенный зависимымOnItemId). Если зависимый элемент удален, связь будет удалена.
Orchestration	Связь оркестрации указывает, что элемент выполняет процессы управления или оркестрации элемента зависимости (элемент, определяемый зависимымOnItemId). Если зависимый элемент удален, связь будет удалена.
Shortcut	Связь ярлыка указывает, что элемент имеет ярлык или ссылку на данные или область данных из элемента, определяемого зависимымOnItemId. Если зависимый элемент удален, связь будет удалена.
HiddenInWorkspace	HiddenInWorkspace указывает, что элемент, принадлежащий этой связи, будет скрыт в рабочей области.