Items - Get Upstream Relations (beta)

Služba:: Core

Verze rozhraní API:: v1

Získá upstreamové relace pro položku.

Note

Toto rozhraní API je součástí beta verze a poskytuje se pouze pro účely vyhodnocení a vývoje. Může se změnit na základě zpětné vazby a nedoporučuje se pro produkční použití. Při volání tohoto rozhraní API musí volající zadat true hodnotu parametru betadotazu .

Vrátí všechny položky, které jsou nadřazené zadané položce, včetně relačních hran a odkazovaných pracovních prostorů.

Oprávnění

Volající musí mít oprávnění ke čtení položky.

Požadované delegované rozsahy

Item.Read.All nebo Item.ReadWrite.All

Podporované identity v Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita	Support
User	Yes
Hlavní služba a Spravované identity	Yes

Rozhraní

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
itemId	path	True	string (uuid)	ID položky.
workspaceId	path	True	string (uuid)	Identifikátor pracovního prostoru.
beta	query	True	boolean	Tento povinný parametr musí být nastavený tak, aby `true` měl přístup k tomuto rozhraní API, který je aktuálně v beta verzi.

Odpovědi

Name Typ Description

200 OK

Name	Typ	Description
200 OK	RelationsResponse	Žádost byla úspěšně dokončena.
429 Too Many Requests	ErrorResponse	Byl překročen limit přenosové rychlosti služby. Server vrátí hlavičku `Retry-After` udávající, kolik sekund musí klient čekat před odesláním dalších požadavků. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Běžné kódy chyb: ItemNotFound – Požadovaná položka nebyla nalezena. InsufficientPrivileges – Volající nemá dostatečná oprávnění pro přístup k položce.

RelationsResponse

Žádost byla úspěšně dokončena.

429 Too Many Requests

ErrorResponse

Byl překročen limit přenosové rychlosti služby. Server vrátí hlavičku Retry-After udávající, kolik sekund musí klient čekat před odesláním dalších požadavků.

Hlavičky

Retry-After: integer

Other Status Codes

ErrorResponse

Běžné kódy chyb:

ItemNotFound – Požadovaná položka nebyla nalezena.
InsufficientPrivileges – Volající nemá dostatečná oprávnění pro přístup k položce.

Příklady

Get upstream relations example

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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"
    }
  ]
}

Definice

Name	Description
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.
ItemType	Typ položky. V průběhu času je možné přidat další typy položek.
RelationsEdge	Relační hrana mezi dvěma položkami.
RelationsRelatedItem	Položka, která souvisí se zadanou položkou. Jedná se o podmnožinu objektu celé položky, která obsahuje pouze vlastnosti vrácené rozhraními API relací.
RelationsResponse	Odpověď obsahující související položky, relační hrany a odkazované pracovní prostory.
RelationsWorkspace	Pracovní prostor odkazovaný v odpovědi na vztahy.
RelationType	Typ vztahu mezi těmito dvěma položkami. V průběhu času je možné přidat další typy relací.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který se podílí na chybě.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
isRetriable	boolean	Pokud je hodnota true, je možné požadavek opakovat. Pomocí hlavičky `Retry-After` odpovědi určete zpoždění, pokud je k dispozici.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string (uuid)	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou

ItemType

Výčet

Typ položky. V průběhu času je možné přidat další typy položek.

Hodnota	Description
Dashboard	Řídicí panel PowerBI
Report	Sestava PowerBI
SemanticModel	Sémantický model PowerBI
PaginatedReport	Stránkovaná sestava PowerBI
Datamart	Datový diagram PowerBI
Lakehouse	Jezero.
Eventhouse	Eventhouse.
Environment	Prostředí.
KQLDatabase	Databáze KQL.
KQLQueryset	Sada dotazů KQL.
KQLDashboard	Řídicí panel KQL.
DataPipeline	Datový kanál.
Notebook	Poznámkový blok.
SparkJobDefinition	Definice úlohy Sparku.
MLExperiment	Experiment strojového učení.
MLModel	Model strojového učení.
Warehouse	Sklad.
Eventstream	Datový proud událostí.
SQLEndpoint	Koncový bod SQL.
MirroredWarehouse	Zrcadlený sklad.
MirroredDatabase	Zrcadlené databáze.
Reflex	A Reflex.
GraphQLApi	Rozhraní API pro položku GraphQL
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Databáze SQLDatabase.
CopyJob	Úloha kopírování.
VariableLibrary	ProměnnáLibrary.
Dataflow	Tok dat.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Snímek skladu.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Tok digitálního dvojčete.
MirroredAzureDatabricksCatalog	Zrcadlený katalog Azure Databricks.
Map	Mapa.
AnomalyDetector	Detektor anomálií.
UserDataFunction	Funkce uživatelských dat.
GraphModel	A GraphModel.
GraphQuerySet	Sada dotazů grafu.
SnowflakeDatabase	Snowflake Database pro ukládání tabulek Iceberg vytvořených z účtu Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Databáze Cosmos DB.
Ontology	Ontologie.
EventSchemaSet	An EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	ZrcadlenýCatalog.
AppBackend	An AppBackend.
OrgApp	Aplikace organizace.
OrgAppAudience	Cílová skupina aplikace organizace.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	Položka úložiště založené na OneLake pro Azure Databricks.
Plan	Plán.

RelationsEdge

Objekt

Relační hrana mezi dvěma položkami.

Name	Typ	Description
dependentOnItemId	string (uuid)	Identifikátor položky, na které zdrojová položka závisí.
itemId	string (uuid)	Identifikátor zdrojové položky.
relationType	RelationType	Typ vztahu mezi těmito dvěma položkami. V průběhu času je možné přidat další typy relací.

RelationsRelatedItem

Objekt

Položka, která souvisí se zadanou položkou. Jedná se o podmnožinu objektu celé položky, která obsahuje pouze vlastnosti vrácené rozhraními API relací.

Name	Typ	Description
displayName	string	Zobrazovaný název položky.
id	string (uuid)	ID položky.
type	ItemType	Typ položky.
workspaceId	string (uuid)	ID pracovního prostoru, který obsahuje položku. Pomocí tohoto ID vyhledejte pracovní prostor v `workspaces` seznamu.

RelationsResponse

Objekt

Odpověď obsahující související položky, relační hrany a odkazované pracovní prostory.

Name	Typ	Description
items	RelationsRelatedItem[]	Seznam souvisejícíchpoložekch
relations	RelationsEdge[]	Seznam relačních hran mezi položkami
workspaces	RelationsWorkspace[]	Seznam pracovních prostorů odkazovaných souvisejícími položkami

RelationsWorkspace

Objekt

Pracovní prostor odkazovaný v odpovědi na vztahy.

Name	Typ	Description
displayName	string	Zobrazovaný název pracovního prostoru.
id	string (uuid)	Identifikátor pracovního prostoru.

RelationType

Výčet

Typ vztahu mezi těmito dvěma položkami. V průběhu času je možné přidat další typy relací.

Hodnota	Description
CascadeDelete	Relace CascadeDelete označuje, že položka je nadřazená závisléHoOnItemId a odstranění položky způsobí také odstranění závislé položky.
WeakAssociation	Vztah WeakAssociation označuje, že existuje měkká závislost na položce identifikované dependentOnItemId. Pokud je závislá položka odstraněna, relace bude odebrána.
Datasource	Relace Zdroje dat označuje, že existuje měkká závislost na položce identifikované běžným zdroji dat. Pokud je závislá položka odstraněna, relace bude odebrána.
PushData	Relace PushData označuje, že závislá položka zapisuje nebo odesílá data do závislé položky (položka identifikovaná závislýmOnItemId). Pokud je závislá položka odstraněna, relace bude odebrána.
Orchestration	Relace orchestrace označuje, že položka provádí procesy správy nebo orchestrace položky závislosti (položka identifikovaná závislýmOnItemId). Pokud je závislá položka odstraněna, relace bude odebrána.
Shortcut	Relace Zástupce označuje, že položka má zástupce nebo odkaz na data nebo datovou oblast z položky identifikované závislýmOnItemId. Pokud je závislá položka odstraněna, relace bude odebrána.
HiddenInWorkspace	HiddenInWorkspace označuje, že položka, která tuto relaci vlastní, bude v pracovním prostoru skrytá.