Items - Get Downstream Relations (beta)

Service:

Core

API-versie:

v1

Hiermee haalt u downstreamrelaties voor een item op.

Note

Deze API maakt deel uit van een bètaversie en is alleen beschikbaar voor evaluatie- en ontwikkelingsdoeleinden. Het kan veranderen op basis van feedback en wordt niet aanbevolen voor productiegebruik. Bij het aanroepen van deze API moeten aanroepers de waarde voor de queryparameter trueopgevenbeta.

Retourneert alle items die downstream van het opgegeven item zijn, inclusief de relationele randen en werkruimten waarnaar wordt verwezen.

Machtigingen

De beller moet leesmachtigingen voor het item hebben.

Vereiste gedelegeerde bevoegdheden

Item.Read.All of Item.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.

Identiteit	Support
User	Yes
serviceprincipal en beheerde identiteiten	Yes

Interface

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

URI-parameters

Name	In	Vereist	Type	Description
itemId	path	True	string (uuid)	De item-id.
workspaceId	path	True	string (uuid)	De werkruimte-ID.
beta	query	True	boolean	Deze vereiste parameter moet worden ingesteld voor true toegang tot deze API, die momenteel in bèta is.

Antwoorden

Name	Type	Description
200 OK	RelationsResponse	De aanvraag is voltooid.
429 Too Many Requests	ErrorResponse	De servicesnelheidslimiet is overschreden. De server retourneert een Retry-After header die in seconden aangeeft hoe lang de client moet wachten voordat extra aanvragen worden verzonden. Kopteksten Retry-After: integer
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: ItemNotFound : het aangevraagde item is niet gevonden. InsufficientPrivileges - De beller heeft onvoldoende machtigingen voor toegang tot het item.

Voorbeelden

Get downstream relations example

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	De foutreactie.
ErrorResponseDetails	De details van het foutbericht.
ItemType	Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
RelationsEdge	Een relationele rand tussen twee items.
RelationsRelatedItem	Een item dat is gerelateerd aan het opgegeven item. Dit is een subset van het volledige itemobject, dat alleen de eigenschappen bevat die worden geretourneerd door de relatie-API's.
RelationsResponse	Een antwoord met gerelateerde items, relationele randen en werkruimten waarnaar wordt verwezen.
RelationsWorkspace	Een werkruimte waarnaar wordt verwezen in het antwoord op relaties.
RelationType	Het type relatie tussen de twee items. Er kunnen in de loop van de tijd extra relationele typen worden toegevoegd.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-ID die betrokken is bij het probleem.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

De foutreactie.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
isRetriable	boolean	Wanneer waar, kan de aanvraag opnieuw worden geprobeerd. Gebruik de Retry-After antwoordheader om de vertraging te bepalen, indien beschikbaar.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	Details van de foutgerelateerde resource.
requestId	string (uuid)	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	Details van de foutgerelateerde resource.

ItemType

Opsomming

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde	Description
Dashboard	PowerBI-dashboard.
Report	PowerBI-rapport.
SemanticModel	Semantisch Power BI-model.
PaginatedReport	Gepagineerd Power BI-rapport.
Datamart	PowerBI-datamart.
Lakehouse	Een lakehouse.
Eventhouse	Een eventhouse.
Environment	Een omgeving.
KQLDatabase	Een KQL-database.
KQLQueryset	Een KQL-queryset.
KQLDashboard	Een KQL-dashboard.
DataPipeline	Een gegevenspijplijn.
Notebook	Een notitieblok.
SparkJobDefinition	Een Spark-taakdefinitie.
MLExperiment	Een machine learning-experiment.
MLModel	Een machine learning-model.
Warehouse	Een magazijn.
Eventstream	Een eventstream.
SQLEndpoint	Een SQL-eindpunt.
MirroredWarehouse	Een gespiegeld magazijn.
MirroredDatabase	Een gespiegelde database.
Reflex	Een reflex.
GraphQLApi	Een API voor GraphQL-item.
MountedDataFactory	Een MountedDataFactory.
SQLDatabase	Een SQLDatabase.
CopyJob	Een kopieertaak.
VariableLibrary	Een VariableLibrary.
Dataflow	Een gegevensstroom.
ApacheAirflowJob	Een ApacheAirflowJob.
WarehouseSnapshot	Een momentopname van een magazijn.
DigitalTwinBuilder	Een DigitalTwinBuilder.
DigitalTwinBuilderFlow	Een Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	Een gespiegelde Azure Databricks-catalogus.
Map	Een kaart.
AnomalyDetector	Een Anomaly Detector.
UserDataFunction	Een gebruikersgegevensfunctie.
GraphModel	Een GraphModel.
GraphQuerySet	Een Graph QuerySet.
SnowflakeDatabase	Een Snowflake-database voor het opslaan van Iceberg-tabellen die zijn gemaakt op basis van het Snowflake-account.
OperationsAgent	Een OperationsAgent.
CosmosDBDatabase	Een Cosmos DB-database.
Ontology	Een Ontologie.
EventSchemaSet	Een EventSchemaSet.
DataAgent	Een DataAgent.
MirroredCatalog	Een mirroredCatalog.
AppBackend	Een AppBackend.
OrgApp	Een organisatie-app.
OrgAppAudience	Een organisatie-app-doelgroep.
DataBuildToolJob	Een DataBuildToolJob.
AzureDatabricksStorage	Een door OneLake ondersteund opslagitem voor Azure Databricks.

RelationsEdge

Object

Een relationele rand tussen twee items.

Name	Type	Description
dependentOnItemId	string (uuid)	De id van het item waarvan het bronitem afhankelijk is.
itemId	string (uuid)	De bronitem-id.
relationType	RelationType	Het type relatie tussen de twee items. Er kunnen in de loop van de tijd extra relationele typen worden toegevoegd.

RelationsRelatedItem

Object

Een item dat is gerelateerd aan het opgegeven item. Dit is een subset van het volledige itemobject, dat alleen de eigenschappen bevat die worden geretourneerd door de relatie-API's.

Name	Type	Description
displayName	string	De weergavenaam van het item.
id	string (uuid)	De item-id.
type	ItemType	Het itemtype.
workspaceId	string (uuid)	De id van de werkruimte die het item bevat. Gebruik deze id om de werkruimte in de workspaces lijst te vinden.

RelationsResponse

Object

Een antwoord met gerelateerde items, relationele randen en werkruimten waarnaar wordt verwezen.

Name	Type	Description
items	RelationsRelatedItem[]	Een lijst met gerelateerde items.
relations	RelationsEdge[]	Een lijst met relationele randen tussen items.
workspaces	RelationsWorkspace[]	Een lijst met werkruimten waarnaar wordt verwezen door de gerelateerde items.

RelationsWorkspace

Object

Een werkruimte waarnaar wordt verwezen in het antwoord op relaties.

Name	Type	Description
displayName	string	De weergavenaam van de werkruimte.
id	string (uuid)	De werkruimte-id.

RelationType

Opsomming

Het type relatie tussen de twee items. Er kunnen in de loop van de tijd extra relationele typen worden toegevoegd.

Waarde	Description
CascadeDelete	Een CascadeDelete-relatie geeft aan dat het item het bovenliggende item is van de dependentOnItemId en het verwijderen van het item zorgt ervoor dat het afhankelijke item ook wordt verwijderd.
WeakAssociation	Een WeakAssociation-relatie geeft aan dat er een zachte afhankelijkheid is van het item dat wordt geïdentificeerd door de dependentOnItemId. Als het afhankelijke item wordt verwijderd, wordt de relatie verwijderd.
Datasource	Een gegevensbronrelatie geeft aan dat er een zachte afhankelijkheid is van het item dat wordt geïdentificeerd door een gemeenschappelijke gegevensbron. Als het afhankelijke item wordt verwijderd, wordt de relatie verwijderd.
PushData	Een PushData-relatie geeft aan dat een afhankelijk item gegevens schrijft/pusht naar afhankelijk item (het item dat is geïdentificeerd door de dependentOnItemId). Als het afhankelijke item wordt verwijderd, wordt de relatie verwijderd.
Orchestration	Een indelingsrelatie geeft aan dat een item beheer- of indelingsprocessen van het afhankelijkheidsitem uitvoert (het item dat wordt geïdentificeerd door de dependentOnItemId). Als het afhankelijke item wordt verwijderd, wordt de relatie verwijderd.
Shortcut	Een snelkoppelingsrelatie geeft aan dat een item een snelkoppeling of koppeling heeft naar gegevens of gegevensgebied van het item dat is geïdentificeerd door de dependentOnItemId. Als het afhankelijke item wordt verwijderd, wordt de relatie verwijderd.
HiddenInWorkspace	HiddenInWorkspace geeft aan dat het item dat eigenaar is van deze relatie wordt verborgen in de werkruimte.