Items - Get Upstream Relations (beta)

Serviço:
Core
Versão da API:
v1

Obtém relações a montante para um item.

Note

Esta API faz parte de uma versão Beta e é fornecida apenas para fins de avaliação e desenvolvimento. Ele pode mudar com base no feedback e não é recomendado para uso em produção. Ao chamar essa API, os chamadores devem especificar true como o valor para o parâmetro betade consulta .

Devolve todos os itens que estão a montante do item especificado, incluindo as arestas de relação e os espaços de trabalho referenciados.

Permissões

O chamador deve ter permissões de leitura para o item.

Escopos delegados necessários

Item.Read.All ou Item.ReadWrite.All

Identidades suportadas pelo Entra da Microsoft

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identidade Support
User Sim
Entidade de serviço e identidades geridas Sim

Interface

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

Parâmetros do URI

Name Em Obrigatório Tipo Descrição
itemId
 path True

string (uuid)

O ID do item.
workspaceId
 path True

string (uuid)

O ID do espaço de trabalho.
beta
 query True

boolean

Este parâmetro exigido deve ser definido para true aceder a esta API, que está atualmente em beta.

Respostas

Name Tipo Descrição
200 OK

RelationsResponse

Pedido concluído com sucesso.
429 Too Many Requests

ErrorResponse

O limite de tarifa de serviço foi ultrapassado. O servidor devolve um Retry-After cabeçalho que indica, em segundos, quanto tempo o cliente deve esperar antes de enviar pedidos adicionais.

Cabeçalhos

Retry-After: integer
Other Status Codes

ErrorResponse

Códigos de erro comuns:

  • ItemNotFound - O item solicitado não foi encontrado.

  • InsufficientPrivileges - O chamador não tem permissões suficientes para acessar o item.

Exemplos

Get upstream relations example

Pedido de amostra

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

Resposta da amostra

Código de estado:
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"
    }
  ]
}

Definições

Name Descrição
ErrorRelatedResource

Os detalhes do objeto de recurso relacionado ao erro.
ErrorResponse

A resposta de erro.
ErrorResponseDetails

Os detalhes do erro na resposta.
ItemType

O tipo do artigo. Tipos de itens adicionais podem ser adicionados ao longo do tempo.
RelationsEdge

Uma aresta de relação entre dois itens.
RelationsRelatedItem

Um item relacionado com o item especificado. Este é um subconjunto do objeto item completo, contendo apenas as propriedades devolvidas pelas APIs de relações.
RelationsResponse

Uma resposta contendo itens relacionados, arestas de relação e espaços de trabalho referenciados.
RelationsWorkspace

Um espaço de trabalho referenciado na resposta de relações.
RelationType

O tipo de relação entre os dois itens. Podem ser adicionados tipos de relações adicionais ao longo do tempo.

ErrorRelatedResource

Object

Os detalhes do objeto de recurso relacionado ao erro.

Name Tipo Descrição
resourceId

string

O ID do recurso envolvido no erro.
resourceType

string

O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Name Tipo Descrição
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.
isRetriable

boolean

Quando confirmado, o pedido pode ser retentado. Use o Retry-After cabeçalho de resposta para determinar o atraso, se disponível.
message

string

Uma representação legível por humanos do erro.
moreDetails

ErrorResponseDetails[]

Lista de detalhes de erro adicionais.
relatedResource

ErrorRelatedResource

Detalhes do recurso relacionado ao erro.
requestId

string (uuid)

ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes do erro na resposta.

Name Tipo Descrição
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

ErrorRelatedResource

Detalhes do recurso relacionado ao erro.

ItemType

Enumeração

O tipo do artigo. Tipos de itens adicionais podem ser adicionados ao longo do tempo.

Valor Descrição
Dashboard

Painel do PowerBI.
Report

Relatório do PowerBI.
SemanticModel

Modelo semântico do PowerBI.
PaginatedReport

Relatório paginado do PowerBI.
Datamart

Datamart do PowerBI.
Lakehouse

Uma casa no lago.
Eventhouse

Uma casa de eventos.
Environment

Um ambiente.
KQLDatabase

Um banco de dados KQL.
KQLQueryset

Um conjunto de consultas KQL.
KQLDashboard

Um painel KQL.
DataPipeline

Um pipeline de dados.
Notebook

Um caderno.
SparkJobDefinition

Uma definição de trabalho de faísca.
MLExperiment

Uma experiência de aprendizagem automática.
MLModel

Um modelo de aprendizagem automática.
Warehouse

Um armazém.
Eventstream

Um fluxo de eventos.
SQLEndpoint

Um ponto de extremidade SQL.
MirroredWarehouse

Um armazém espelhado.
MirroredDatabase

Um banco de dados espelhado.
Reflex

Um reflexo.
GraphQLApi

Uma API para o item GraphQL.
MountedDataFactory

Um MountedDataFactory.
SQLDatabase

Um SQLDatabase.
CopyJob

Um trabalho de cópia.
VariableLibrary

Uma VariableLibrary.
Dataflow

Um fluxo de dados.
ApacheAirflowJob

Um ApacheAirflowJob.
WarehouseSnapshot

Um instantâneo do Warehouse.
DigitalTwinBuilder

Um DigitalTwinBuilder.
DigitalTwinBuilderFlow

Um fluxo de construtor de gêmeos digitais.
MirroredAzureDatabricksCatalog

Um catálogo de databricks azure espelhado.
Map

Um mapa.
AnomalyDetector

Um detetor de anomalias.
UserDataFunction

Uma função de dados do usuário.
GraphModel

Um GraphModel.
GraphQuerySet

Um Graph QuerySet.
SnowflakeDatabase

Uma base de dados Snowflake para armazenar tabelas Iceberg criadas a partir da conta Snowflake.
OperationsAgent

Um Agente de Operações.
CosmosDBDatabase

Uma base de dados Cosmos DB.
Ontology

Uma ontologia.
EventSchemaSet

Um EventoSchemaSet.
DataAgent

Um DataAgent.
MirroredCatalog

Um Catálogo Espelhado.
AppBackend

Um AppBackend.
OrgApp

Uma aplicação de organização.
OrgAppAudience

Uma audiência de Org App.
DataBuildToolJob

Um DataBuildToolJob.
AzureDatabricksStorage

Um item de armazenamento apoiado por OneLake para Azure Databricks.

RelationsEdge

Object

Uma aresta de relação entre dois itens.

Name Tipo Descrição
dependentOnItemId

string (uuid)

O identificador do item do qual o item de origem depende.
itemId

string (uuid)

O identificador do item de origem.
relationType

RelationType

O tipo de relação entre os dois itens. Podem ser adicionados tipos de relações adicionais ao longo do tempo.

RelationsRelatedItem

Object

Um item relacionado com o item especificado. Este é um subconjunto do objeto item completo, contendo apenas as propriedades devolvidas pelas APIs de relações.

Name Tipo Descrição
displayName

string

O nome de exibição do item.
id

string (uuid)

O ID do item.
type

ItemType

O tipo de item.
workspaceId

string (uuid)

O ID do espaço de trabalho que contém o item. Use este ID para encontrar o espaço de trabalho na workspaces lista.

RelationsResponse

Object

Uma resposta contendo itens relacionados, arestas de relação e espaços de trabalho referenciados.

Name Tipo Descrição
items

RelationsRelatedItem[]

Uma lista de itens relacionados.
relations

RelationsEdge[]

Uma lista de arestas de relação entre itens.
workspaces

RelationsWorkspace[]

Uma lista de espaços de trabalho referenciados pelos itens relacionados.

RelationsWorkspace

Object

Um espaço de trabalho referenciado na resposta de relações.

Name Tipo Descrição
displayName

string

O nome de exibição do espaço de trabalho.
id

string (uuid)

O identificador do espaço de trabalho.

RelationType

Enumeração

O tipo de relação entre os dois itens. Podem ser adicionados tipos de relações adicionais ao longo do tempo.

Valor Descrição
CascadeDelete

Uma relação CascadeDelete indica que o item é o Pai do dependentOnItemId e eliminar o item fará com que o item dependente também seja eliminado.
WeakAssociation

Uma relação WeakAssociation indica que existe uma dependência suave do item identificado pelo dependentOnItemId. Se o item Dependente for eliminado, a relação será removida.
Datasource

Uma relação Datasource indica que existe uma dependência suave do item identificado por uma Data Source comum. Se o item Dependente for eliminado, a relação será removida.
PushData

Uma relação PushData indica que um item dependente escreve/envia dados para o item dependente (o item identificado pelo dependentOnItemId). Se o item Dependente for eliminado, a relação será removida.
Orchestration

Uma relação de Orquestração indica que um item executa processos de gestão ou orquestração do item de dependência (o item identificado pelo dependentOnItemId). Se o item Dependente for eliminado, a relação será removida.
Shortcut

Uma relação Atalho indica que um item tem um atalho ou ligação para dados ou área de dados identificada pelo dependentOnItemId. Se o item Dependente for eliminado, a relação será removida.
HiddenInWorkspace

HiddenInWorkspace indica que o item que detém esta relação ficará oculto no workspace.