Items - Get Downstream Relations (beta)

Service:: Core

Version d’API:: v1

Obtient les relations en aval pour un élément.

Note

Cette API fait partie d’une version bêta et est fournie uniquement à des fins d’évaluation et de développement. Il peut changer en fonction des commentaires et n’est pas recommandé pour une utilisation en production. Lors de l’appel de cette API, les appelants doivent spécifier true comme valeur pour le paramètre betade requête.

Retourne tous les éléments en aval de l’élément spécifié, y compris les bords de relation et les espaces de travail référencés.

Permissions

L’appelant doit disposer d’autorisations de lecture pour l’élément.

Étendues déléguées requises

Item.Read.All ou Item.ReadWrite.All

Identités prises en charge par Microsoft Entra

Cette API prend en charge les identités Microsoft répertoriées dans cette section.

Identité	Support
Utilisateur	Oui
Service principal et identités gérées	Oui

Interface

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
itemId	path	True	string (uuid)	ID d’élément.
workspaceId	path	True	string (uuid)	Identifiant de l’espace de travail.
beta	query	True	boolean	Ce paramètre obligatoire doit être défini pour accéder à `true` cette API, qui est actuellement en version bêta.

Réponses

Nom Type Description

200 OK

Nom	Type	Description
200 OK	RelationsResponse	La demande s’est terminée avec succès.
429 Too Many Requests	ErrorResponse	La limite de débit de service a été dépassée. Le serveur retourne un `Retry-After` en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires. En-têtes Retry-After: integer
Other Status Codes	ErrorResponse	Codes d’erreur courants : ItemNotFound : l’élément demandé n’a pas été trouvé. InsufficientPrivileges : l’appelant ne dispose pas des autorisations suffisantes pour accéder à l’élément.

RelationsResponse

La demande s’est terminée avec succès.

429 Too Many Requests

ErrorResponse

La limite de débit de service a été dépassée. Le serveur retourne un Retry-After en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires.

En-têtes

Retry-After: integer

Other Status Codes

ErrorResponse

Codes d’erreur courants :

ItemNotFound : l’élément demandé n’a pas été trouvé.
InsufficientPrivileges : l’appelant ne dispose pas des autorisations suffisantes pour accéder à l’élément.

Exemples

Get downstream relations example

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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"
    }
  ]
}

Définitions

Nom	Description
ErrorRelatedResource	Objet de détails de ressource associé à l’erreur.
ErrorResponse	Réponse d’erreur.
ErrorResponseDetails	Détails de la réponse d’erreur.
ItemType	Type de l’élément. Des types d’éléments supplémentaires peuvent être ajoutés au fil du temps.
RelationsEdge	Arête de relation entre deux éléments.
RelationsRelatedItem	Élément lié à l’élément spécifié. Il s’agit d’un sous-ensemble de l’objet d’élément complet, contenant uniquement les propriétés retournées par les API de relations.
RelationsResponse	Réponse contenant des éléments connexes, des bords de relation et des espaces de travail référencés.
RelationsWorkspace	Espace de travail référencé dans la réponse des relations.
RelationType	Type de relation entre les deux éléments. Des types de relation supplémentaires peuvent être ajoutés au fil du temps.

ErrorRelatedResource

Objet

Objet de détails de ressource associé à l’erreur.

Nom	Type	Description
resourceId	string	ID de ressource impliqué dans l’erreur.
resourceType	string	Type de la ressource impliquée dans l’erreur.

ErrorResponse

Objet

Réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
isRetriable	boolean	Lorsque la valeur est true, la requête peut être retentée. Utilisez l’en-tête `Retry-After` de réponse pour déterminer le délai, le cas échéant.
message	string	Représentation lisible humaine de l’erreur.
moreDetails	ErrorResponseDetails[]	Liste des détails d’erreur supplémentaires.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.
requestId	string (uuid)	ID de la demande associée à l’erreur.

ErrorResponseDetails

Objet

Détails de la réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message	string	Représentation lisible humaine de l’erreur.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.

ItemType

Énumération

Type de l’élément. Des types d’éléments supplémentaires peuvent être ajoutés au fil du temps.

Valeur	Description
Dashboard	Tableau de bord PowerBI.
Report	Rapport PowerBI.
SemanticModel	Modèle sémantique PowerBI.
PaginatedReport	Rapport paginé PowerBI.
Datamart	Datamart PowerBI.
Lakehouse	Un lakehouse.
Eventhouse	Un eventhouse.
Environment	Environnement.
KQLDatabase	Base de données KQL.
KQLQueryset	Ensemble de requêtes KQL.
KQLDashboard	Tableau de bord KQL.
DataPipeline	Un pipeline de données.
Notebook	Un notebook.
SparkJobDefinition	Définition d’un travail Spark.
MLExperiment	Une expérience de Machine Learning.
MLModel	Modèle Machine Learning.
Warehouse	Un entrepôt.
Eventstream	Flux d’événements.
SQLEndpoint	Point de terminaison SQL.
MirroredWarehouse	Un entrepôt mis en miroir.
MirroredDatabase	Une base de données mise en miroir.
Reflex	Un réflexe.
GraphQLApi	API pour l’élément GraphQL.
MountedDataFactory	Un MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Tâche de copie.
VariableLibrary	A VariableLibrary.
Dataflow	Flux de données.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Capture instantanée de l’entrepôt.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Flux de générateur de jumeaux numériques.
MirroredAzureDatabricksCatalog	Catalogue Azure databricks mis en miroir.
Map	Carte.
AnomalyDetector	Détecteur d’anomalies.
UserDataFunction	Fonction de données utilisateur.
GraphModel	A GraphModel.
GraphQuerySet	Ensemble de requêtes Graph.
SnowflakeDatabase	Une base de données Snowflake pour stocker les tables Iceberg créées à partir du compte Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Base de données Cosmos DB.
Ontology	Une ontologie.
EventSchemaSet	An EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	A MirroredCatalog.
AppBackend	An AppBackend.
OrgApp	Une application d’organisation.
OrgAppAudience	Audience d’application d’organisation.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	Élément de stockage soutenu par OneLake pour Azure Databricks.

RelationsEdge

Objet

Arête de relation entre deux éléments.

Nom	Type	Description
dependentOnItemId	string (uuid)	Identificateur de l’élément dont dépend l’élément source.
itemId	string (uuid)	Identificateur de l’élément source.
relationType	RelationType	Type de relation entre les deux éléments. Des types de relation supplémentaires peuvent être ajoutés au fil du temps.

RelationsRelatedItem

Objet

Élément lié à l’élément spécifié. Il s’agit d’un sous-ensemble de l’objet d’élément complet, contenant uniquement les propriétés retournées par les API de relations.

Nom	Type	Description
displayName	string	Nom complet de l’élément.
id	string (uuid)	ID d’élément.
type	ItemType	Type d’élément.
workspaceId	string (uuid)	ID de l’espace de travail qui contient l’élément. Utilisez cet ID pour rechercher l’espace de travail dans la `workspaces` liste.

RelationsResponse

Objet

Réponse contenant des éléments connexes, des bords de relation et des espaces de travail référencés.

Nom	Type	Description
items	RelationsRelatedItem[]	Liste des éléments associés.
relations	RelationsEdge[]	Liste des arêtes de relation entre les éléments.
workspaces	RelationsWorkspace[]	Liste des espaces de travail référencés par les éléments associés.

RelationsWorkspace

Objet

Espace de travail référencé dans la réponse des relations.

Nom	Type	Description
displayName	string	Nom complet de l’espace de travail.
id	string (uuid)	Identificateur de l’espace de travail.

RelationType

Énumération

Type de relation entre les deux éléments. Des types de relation supplémentaires peuvent être ajoutés au fil du temps.

Valeur	Description
CascadeDelete	Une relation CascadeDelete indique que l’élément est le parent de l’élément dépendantOnItemId et que la suppression de l’élément entraîne la suppression de l’élément dépendant.
WeakAssociation	Une relation WeakAssociation indique qu’il existe une dépendance réversible sur l’élément identifié par l’élément dépendantOnItemId. Si l’élément Dépendant est supprimé, la relation est supprimée.
Datasource	Une relation de source de données indique qu’il existe une dépendance réversible sur l’élément identifié par une source de données commune. Si l’élément Dépendant est supprimé, la relation est supprimée.
PushData	Une relation PushData indique qu’un élément dépendant écrit/envoie des données à un élément dépendant (l’élément identifié par l’élément dépendantOnItemId). Si l’élément Dépendant est supprimé, la relation est supprimée.
Orchestration	Une relation d’orchestration indique qu’un élément exécute des processus de gestion ou d’orchestration de l’élément de dépendance (l’élément identifié par l’élément dépendantOnItemId). Si l’élément Dépendant est supprimé, la relation est supprimée.
Shortcut	Une relation de raccourci indique qu’un élément a un raccourci ou un lien vers des données ou une zone de données de l’élément identifié par l’élément dépendantOnItemId. Si l’élément Dépendant est supprimé, la relation est supprimée.
HiddenInWorkspace	HiddenInWorkspace indique que l’élément propriétaire de cette relation sera masqué dans l’espace de travail.