Items - Get Downstream Relations (beta)

Palvelu:: Core

Ohjelmointirajapinnan versio:: v1

Hakee kohteen alapuoliset suhteet.

Note

Tämä ohjelmointirajapinta on osa beetaversiota, ja se on saatavilla vain arviointi- ja kehitystarkoituksiin. Muutos saattaa perustua palautteeseen, eikä sitä suositella tuotantokäyttöön. Kun kutsut tätä ohjelmointirajapintaa, kutsujien on määritettävä true kyselyparametrin betaarvoksi .

Palauttaa kaikki kohteet, jotka ovat määritetyn kohteen alapuolisia, mukaan lukien relaatioreunat ja viitatut työtilat.

Käyttöoikeudet

Soittajalla on oltava kohteen lukuoikeudet .

Vaaditut delegoidut vaikutusalueet

Item.Read.All tai Item.ReadWrite.All

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identity	Tuki
Käyttäjä	Yes
palvelun päänimen ja Hallittujen käyttäjätietojen	Yes

Liittymä

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Kuvaus
itemId	path	True	string (uuid)	Kohdetunnus.
workspaceId	path	True	string (uuid)	Työtilan tunnus.
beta	query	True	boolean	Tämä pakollinen parametri on määritettävä, jotta `true` voit käyttää tätä ohjelmointirajapintaa, joka on tällä hetkellä beetaversiossa.

Vastaukset

Nimi Tyyppi Kuvaus

200 OK

Nimi	Tyyppi	Kuvaus
200 OK	RelationsResponse	Pyynnön valmistuttua.
429 Too Many Requests	ErrorResponse	Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka `Retry-After` ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään. Otsikot Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: ItemNotFound – Pyydettyä kohdetta ei löytynyt. InsufficientPrivileges – soittajalla ei ole riittäviä käyttöoikeuksia kohteen käyttämiseen.

RelationsResponse

Pyynnön valmistuttua.

429 Too Many Requests

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer

Other Status Codes

ErrorResponse

Yleiset virhekoodit:

ItemNotFound – Pyydettyä kohdetta ei löytynyt.
InsufficientPrivileges – soittajalla ei ole riittäviä käyttöoikeuksia kohteen käyttämiseen.

Esimerkit

Get downstream relations example

Mallipyyntö

HTTP

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

Mallivastaus

Tilakoodi:: 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"
    }
  ]
}

Määritelmät

Nimi	Kuvaus
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
ItemType	Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.
RelationsEdge	Kahden kohteen välinen suhteellinen reuna.
RelationsRelatedItem	Kohde, joka liittyy määritettyyn kohteeseen. Tämä on koko kohdeobjektin alijoukko, joka sisältää vain suhteiden ohjelmointirajapintojen palauttamat ominaisuudet.
RelationsResponse	Vastaus, joka sisältää liittyvät kohteet, suhteen reunat ja viitatut työtilat.
RelationsWorkspace	Työtila, johon viitataan suhteiden vastauksessa.
RelationType	Kahden kohteen välisen suhteen tyyppi. Muita relaatiotyyppejä voidaan lisätä ajan kuluessa.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Kuvaus
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi	Tyyppi	Kuvaus
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
isRetriable	boolean	Kun arvo on tosi, pyyntöä voidaan yrittää uudelleen. Määritä viive vastausotsikon `Retry-After` avulla, jos se on käytettävissä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string (uuid)	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi	Tyyppi	Kuvaus
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

ItemType

Luettelointi

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

Arvo	Kuvaus
Dashboard	Power BI -koontinäyttö.
Report	PowerBI -raportti.
SemanticModel	PowerBI:n semanttinen malli.
PaginatedReport	PowerBI:n sivutettu raportti.
Datamart	PowerBI -tietomarssi.
Lakehouse	Tämä on lakehouse.
Eventhouse	Tapahtumatalo.
Environment	Ympäristö.
KQLDatabase	KQL-tietokanta.
KQLQueryset	KQL-kyselyjoukko.
KQLDashboard	KQL-koontinäyttö.
DataPipeline	Tietoputki.
Notebook	Muistikirja.
SparkJobDefinition	Spark-työn määritelmä.
MLExperiment	Koneoppimisen kokeilu.
MLModel	Koneoppimismalli.
Warehouse	Varasto.
Eventstream	Tapahtumavirta.
SQLEndpoint	SQL-päätepiste.
MirroredWarehouse	Peilattu varasto.
MirroredDatabase	Peilattu tietokanta.
Reflex	Refleksi.
GraphQLApi	Ohjelmointirajapinta GraphQL-kohteelle.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Kopiotyö.
VariableLibrary	MuuttujaLibrary.
Dataflow	Tietovuo.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Varastotilannevedos.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Digital Twin Builder -työnkulku.
MirroredAzureDatabricksCatalog	Peilattu Azure Databricks -luettelo.
Map	Kartta.
AnomalyDetector	Poikkeamien tunnistaminen.
UserDataFunction	Käyttäjätietofunktio.
GraphModel	A GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake-tietokannalla tallennetaan Snowflake-tililtä luodut Iceberg-taulukot.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Cosmos DB -tietokanta.
Ontology	Ontologia.
EventSchemaSet	An EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	A MirroredCatalog.
AppBackend	An AppBackend.
OrgApp	Organisaatiosovellus.
OrgAppAudience	An Org App Audience.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	OneLake-taustainen tallennuskohde Azure Databricks.
Plan	Suunnitelma.

RelationsEdge

Kohde

Kahden kohteen välinen suhteellinen reuna.

Nimi	Tyyppi	Kuvaus
dependentOnItemId	string (uuid)	Lähdekohteen tarvitseman kohteen tunnus.
itemId	string (uuid)	Lähdekohteen tunnus.
relationType	RelationType	Kahden kohteen välisen suhteen tyyppi. Muita relaatiotyyppejä voidaan lisätä ajan kuluessa.

RelationsRelatedItem

Kohde

Kohde, joka liittyy määritettyyn kohteeseen. Tämä on koko kohdeobjektin alijoukko, joka sisältää vain suhteiden ohjelmointirajapintojen palauttamat ominaisuudet.

Nimi	Tyyppi	Kuvaus
displayName	string	Kohteen näyttönimi.
id	string (uuid)	Kohdetunnus.
type	ItemType	Kohdetyyppi.
workspaceId	string (uuid)	Kohteen sisältävän työtilan tunnus. Etsi luettelosta työtila `workspaces` tämän tunnuksen avulla.

RelationsResponse

Kohde

Vastaus, joka sisältää liittyvät kohteet, suhteen reunat ja viitatut työtilat.

Nimi	Tyyppi	Kuvaus
items	RelationsRelatedItem[]	Luettelo liittyvistä kohteista.
relations	RelationsEdge[]	Luettelo kohteiden väli olevista suhteellisista reunuksista.
workspaces	RelationsWorkspace[]	Luettelo työtiloista, joihin liittyvät kohteet viittaavat.

RelationsWorkspace

Kohde

Työtila, johon viitataan suhteiden vastauksessa.

Nimi	Tyyppi	Kuvaus
displayName	string	Työtilan näyttönimi.
id	string (uuid)	Työtilan tunnus.

RelationType

Luettelointi

Kahden kohteen välisen suhteen tyyppi. Muita relaatiotyyppejä voidaan lisätä ajan kuluessa.

Arvo	Kuvaus
CascadeDelete	CascadeDelete-suhde ilmaisee, että kohde on dependentOnItemId:n pääkohde, ja kohteen poistaminen aiheuttaa myös Riippuvaisen kohteen poistamisen.
WeakAssociation	WeakAssociation-suhde ilmaisee, että dependentOnItemId-tunnuksen tunnistamalla kohteella on pehmeä riippuvuussuhde. Jos Riippuvainen kohde poistetaan, suhde poistetaan.
Datasource	Tietolähdesuhde ilmaisee, että yleisen tietolähteen tunnistamalla kohteella on pehmeä riippuvuussuhde. Jos Riippuvainen kohde poistetaan, suhde poistetaan.
PushData	PushData-suhde ilmaisee, että riippuvaisen kohteen kirjoitus-/työntötiedot riippuvat kohteesta (dependentOnItemId-tunnuksen tunnistama kohde). Jos Riippuvainen kohde poistetaan, suhde poistetaan.
Orchestration	Orkestrointiyhteys ilmaisee, että kohde suorittaa riippuvuuskohteen (dependentOnItemId-tunnuksen tunnistaman kohteen) hallinta- tai orkestrointiprosesseja. Jos Riippuvainen kohde poistetaan, suhde poistetaan.
Shortcut	Pikakuvakesuhde ilmaisee, että kohteella on pikakuvake tai linkki dependentOnItemId-kohteen tunnistaman kohteen tietoihin tai tietoalueeseen. Jos Riippuvainen kohde poistetaan, suhde poistetaan.
HiddenInWorkspace	HiddenInWorkspace ilmaisee, että tämän suhteen omistava kohde piilotetaan työtilassa.