Items - Get Downstream Relations (beta)

Služba:: Core

Verzia rozhrania API:: v1

Načíta následné vzťahy pre položku.

Poznámka

Toto rozhranie API je súčasťou verzie Beta a je určené len na účely hodnotenia a vývoja. Môže sa zmeniť na základe pripomienok a neodporúča sa na použitie v produkčnom prostredí. Pri volaní tohto rozhrania API musia volajúci zadať true hodnotu parametra betadotazu .

Vráti všetky položky, ktoré sú v smere toku zadanou položkou, vrátane relačných okrajov a odkazovaných pracovných priestorov.

Permissions

Volajúci musí mať povolenia na čítanie položky.

Povinné delegované rozsahy

Item.Read.All alebo Item.ReadWrite.All

podporované identity Microsoft Entra

Toto rozhranie API podporuje Microsoft identity uvedené v tejto časti.

Identita	Podpora
Používateľ	Áno
Objekt služby a spravované identity	Áno

Rozhranie

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

Parametre URI

Name	V	Povinné	Typ	Description
itemId	path	True	string (uuid)	ID položky.
workspaceId	path	True	string (uuid)	ID pracovného priestoru.
beta	query	True	boolean	Tento povinný parameter musí byť nastavený na prístup k `true` tomuto API, ktoré je momentálne v beta verzii.

Odpovede

Name Typ Description

200 OK

Name	Typ	Description
200 OK	RelationsResponse	Požiadavka sa úspešne dokončila.
429 Too Many Requests	ErrorResponse	Prekročil sa limit rýchlosti služby. Server vráti hlavičku `Retry-After` v sekundách, ako dlho musí klient počkať, kým odošle ďalšie požiadavky. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Bežné kódy chýb: ItemNotFound – požadovaná položka sa nenašla. InsufficientPrivileges – volajúci nemá dostatočné povolenia na prístup k položke.

RelationsResponse

Požiadavka sa úspešne dokončila.

429 Too Many Requests

ErrorResponse

Prekročil sa limit rýchlosti služby. Server vráti hlavičku Retry-After v sekundách, ako dlho musí klient počkať, kým odošle ďalšie požiadavky.

Hlavičky

Retry-After: integer

Other Status Codes

ErrorResponse

Bežné kódy chýb:

ItemNotFound – požadovaná položka sa nenašla.
InsufficientPrivileges – volajúci nemá dostatočné povolenia na prístup k položke.

Príklady

Get downstream relations example

Vzorová požiadavka

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/9b218778-e7a5-4d73-8187-f10824047715/relations/downstream?beta=True

Vzorová odpoveď

Kód stavu:: 200

{
  "items": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "type": "Report",
      "displayName": "Q4 Sales Dashboard",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    {
      "id": "9b218778-e7a5-4d73-8187-f10824047715",
      "type": "SemanticModel",
      "displayName": "Sales Semantic Model",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ],
  "relations": [
    {
      "itemId": "3546052c-ae64-4526-b1a8-52af7761426f",
      "dependentOnItemId": "9b218778-e7a5-4d73-8187-f10824047715",
      "relationType": "PushData"
    }
  ],
  "workspaces": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "displayName": "Finance Analytics Workspace"
    }
  ]
}

Definície

Name	Description
ErrorRelatedResource	Objekt s podrobnosťami o zdroji súvisiacej s chybou.
ErrorResponse	Odpoveď na chybu.
ErrorResponseDetails	Podrobnosti o chybovej odpovedi.
ItemType	Typ položky. V priebehu času je možné pridať ďalšie typy položiek.
RelationsEdge	Relačný okraj medzi dvomi položkami.
RelationsRelatedItem	Položka, ktorá súvisí so zadanou položkou. Toto je podmnožina objektu úplnej položky obsahujúca iba vlastnosti vrátené rozhraniami API pre vzťahy.
RelationsResponse	Odpoveď obsahujúca súvisiace položky, relačné okraje a odkazované pracovné priestory.
RelationsWorkspace	Pracovný priestor, na ktorý sa odkazuje v odpovedi vzťahov.
RelationType	Typ vzťahu medzi týmito dvomi položkami. V priebehu času je možné pridať ďalšie typy vzťahov.

ErrorRelatedResource

Object

Objekt s podrobnosťami o zdroji súvisiacej s chybou.

Name	Typ	Description
resourceId	string	ID prostriedku, ktoré je súčasťou chyby.
resourceType	string	Typ prostriedku, ktorý je zapojený do chyby.

ErrorResponse

Object

Odpoveď na chybu.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
isRetriable	boolean	Ak je hodnota true, žiadosť sa môže zopakovať. `Retry-After` Ak je k dispozícii, oneskorenie môžete určiť pomocou hlavičky odpovede.
message	string	Zobrazenie chyby čitateľné ľuďmi.
moreDetails	ErrorResponseDetails[]	Zoznam ďalších podrobností o chybe.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.
requestId	string (uuid)	ID požiadavky súvisiacej s chybou.

ErrorResponseDetails

Object

Podrobnosti o chybovej odpovedi.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.

ItemType

Enumerácia

Typ položky. V priebehu času je možné pridať ďalšie typy položiek.

Hodnota	Description
Dashboard	Tabuľa služby PowerBI.
Report	Zostava PowerBI.
SemanticModel	Sémantický model PowerBI.
PaginatedReport	Stránkovaná zostava služby PowerBI.
Datamart	Údajový diagram služby PowerBI.
Lakehouse	Jazero.
Eventhouse	Eventhouse.
Environment	Prostredie.
KQLDatabase	Databáza KQL.
KQLQueryset	Množina dotazov KQL.
KQLDashboard	Tabuľa KQL.
DataPipeline	Kanál údajov.
Notebook	Poznámkový blok.
SparkJobDefinition	Definícia úlohy iskry.
MLExperiment	Experiment strojového učenia.
MLModel	Model strojového učenia.
Warehouse	Sklad.
Eventstream	Udalosť eventstream.
SQLEndpoint	Koncový bod SQL.
MirroredWarehouse	Zrkadlový sklad.
MirroredDatabase	Zrkadlová databáza.
Reflex	A Reflex.
GraphQLApi	Rozhranie API pre položku GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Databáza SQLDatabase.
CopyJob	Kopírovať úlohu.
VariableLibrary	A VariableLibrary.
Dataflow	Tok údajov.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Snímka skladu.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Digitálny postup Twin Buildera.
MirroredAzureDatabricksCatalog	Zrkadlový katalóg Azure databricks.
Map	Mapa.
AnomalyDetector	Detektor anomálií.
UserDataFunction	Funkcia user data function.
GraphModel	A GraphModel.
GraphQuerySet	Množina dotazov Graphu.
SnowflakeDatabase	Databáza Snowflake na ukladanie tabuliek ľadovec vytvorených z konta Snowflake.
OperationsAgent	OperationsAgent (Operácia).
CosmosDBDatabase	Databáza Cosmos DB.
Ontology	Ontológia.
EventSchemaSet	Množina schém udalosti.
DataAgent	DataAgent (Údajovýgens).
MirroredCatalog	Zrkadlovýcatalog.
AppBackend	An AppBackend.
OrgApp	Aplikácia organizácie.
OrgAppAudience	Publikum aplikácií organizácie.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	Úložný priestor podložený OneLakeom pre Azure Databricks.
Plan	Plán.

RelationsEdge

Object

Relačný okraj medzi dvomi položkami.

Name	Typ	Description
dependentOnItemId	string (uuid)	Identifikátor položky, od ktorou závisí zdrojová položka.
itemId	string (uuid)	Identifikátor zdrojovej položky.
relationType	RelationType	Typ vzťahu medzi týmito dvomi položkami. V priebehu času je možné pridať ďalšie typy vzťahov.

RelationsRelatedItem

Object

Položka, ktorá súvisí so zadanou položkou. Toto je podmnožina objektu úplnej položky obsahujúca iba vlastnosti vrátené rozhraniami API pre vzťahy.

Name	Typ	Description
displayName	string	Zobrazovaný názov položky.
id	string (uuid)	ID položky.
type	ItemType	Typ položky.
workspaceId	string (uuid)	ID pracovného priestoru, ktorý obsahuje danú položku. Pomocou tohto ID nájdite pracovný priestor v `workspaces` zozname.

RelationsResponse

Object

Odpoveď obsahujúca súvisiace položky, relačné okraje a odkazované pracovné priestory.

Name	Typ	Description
items	RelationsRelatedItem[]	Zoznam súvisiacich položiek.
relations	RelationsEdge[]	Zoznam relačných okrajov medzi položkami.
workspaces	RelationsWorkspace[]	Zoznam pracovných priestorov, na ktoré odkazujú súvisiace položky.

RelationsWorkspace

Object

Pracovný priestor, na ktorý sa odkazuje v odpovedi vzťahov.

Name	Typ	Description
displayName	string	Zobrazovaný názov pracovného priestoru.
id	string (uuid)	Identifikátor pracovného priestoru.

RelationType

Enumerácia

Typ vzťahu medzi týmito dvomi položkami. V priebehu času je možné pridať ďalšie typy vzťahov.

Hodnota	Description
CascadeDelete	Vzťah KaskádaDelete označuje, že položka je Nadradená hodnota závislého identifikátoraOnItemId a odstránením položky sa odstráni aj závislá položka.
WeakAssociation	Vzťah Slabé priradenie označuje, že na položke identifikovanej závislým idOnItemId existuje mäkká závislosť. Ak sa položka Závislé odstráni, vzťah sa odstráni.
Datasource	Vzťah medzi zdrojmi údajov označuje, že na položke identifikovanej spoločným zdrojom údajov existuje mäkká závislosť. Ak sa položka Závislé odstráni, vzťah sa odstráni.
PushData	Vzťah PushData označuje, že závislá položka zapisuje/presúva údaje do položky závislého používateľa (položka identifikovaná závislým identifikátoromOnItemId). Ak sa položka Závislé odstráni, vzťah sa odstráni.
Orchestration	Vzťah slúžiaci na slúžiaci slúžiaci na zosúlaďovanie označuje, že položka spúšťa procesy spravovania alebo zoradenia položky závislosti (položka identifikovaná závislým identifikátoromOnItemId). Ak sa položka Závislé odstráni, vzťah sa odstráni.
Shortcut	Vzťah Odkaz označuje, že položka má odkaz alebo prepojenie na údaje alebo oblasť údajov z položky identifikovaná závislým identifikátoromOnItemId. Ak sa položka Závislé odstráni, vzťah sa odstráni.
HiddenInWorkspace	HiddenInWorkspace označuje, že položka, ktorá vlastní tento vzťah, bude v pracovnom priestore skrytá.