Items - Get Upstream Relations (beta)

Dienst:: Core

API-Version:: v1

Ruft Upstreambeziehungen für ein Element ab.

Hinweis

Diese API ist Teil einer Betaversion und wird nur für Evaluierungs- und Entwicklungszwecke bereitgestellt. Sie kann sich basierend auf Feedback ändern und wird nicht für den Produktionseinsatz empfohlen. Beim Aufrufen dieser API müssen Aufrufer als Wert für den Abfrageparameter trueangebenbeta.

Gibt alle Elemente zurück, die sich vor dem angegebenen Element befinden, einschließlich der Beziehungsränder und der Arbeitsbereiche, auf die verwiesen wird.

Berechtigungen

Der Aufrufer muss über Leseberechtigungen für das Element verfügen.

Erforderliche delegierte Zugriffsbereiche

Item.Read.All oder Item.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität	Support
Benutzer	Ja
Service Principal und Verwaltete Identitäten	Ja

Schnittstelle

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
itemId	path	True	string (uuid)	Die Element-ID.
workspaceId	path	True	string (uuid)	Die Arbeitsbereichs-ID.
beta	query	True	boolean	Dieser erforderliche Parameter muss für den Zugriff auf diese API festgelegt `true` werden, die sich derzeit in der Betaversion befindet.

Antworten

Name Typ Beschreibung

200 OK

Name	Typ	Beschreibung
200 OK	RelationsResponse	Der Auftrag wurde erfolgreich abgeschlossen.
429 Too Many Requests	ErrorResponse	Der Dienstratenlimit wurde überschritten. Der Server gibt einen `Retry-After` Header zurück, der in Sekunden angibt, wie lange der Client warten muss, bevor zusätzliche Anforderungen gesendet werden. Header Retry-After: integer
Other Status Codes	ErrorResponse	Häufige Fehlercodes: ItemNotFound – Das angeforderte Element wurde nicht gefunden. InsufficientPrivileges – Der Aufrufer verfügt nicht über ausreichende Berechtigungen für den Zugriff auf das Element.

RelationsResponse

Der Auftrag wurde erfolgreich abgeschlossen.

429 Too Many Requests

ErrorResponse

Der Dienstratenlimit wurde überschritten. Der Server gibt einen Retry-After Header zurück, der in Sekunden angibt, wie lange der Client warten muss, bevor zusätzliche Anforderungen gesendet werden.

Header

Retry-After: integer

Other Status Codes

ErrorResponse

Häufige Fehlercodes:

ItemNotFound – Das angeforderte Element wurde nicht gefunden.
InsufficientPrivileges – Der Aufrufer verfügt nicht über ausreichende Berechtigungen für den Zugriff auf das Element.

Beispiele

Get upstream relations example

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
ErrorRelatedResource	Das Objekt der fehlerbezogenen Ressourcendetails.
ErrorResponse	Die Fehlerantwort.
ErrorResponseDetails	Die Fehlerantwortdetails.
ItemType	Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.
RelationsEdge	Ein Beziehungsrand zwischen zwei Elementen.
RelationsRelatedItem	Ein Element, das mit dem angegebenen Element verknüpft ist. Dies ist eine Teilmenge des vollständigen Elementobjekts, das nur die eigenschaften enthält, die von den Beziehungen-APIs zurückgegeben werden.
RelationsResponse	Eine Antwort, die verwandte Elemente, Beziehungsränder und referenzierte Arbeitsbereiche enthält.
RelationsWorkspace	Ein Arbeitsbereich, auf den in der Beziehungsantwort verwiesen wird.
RelationType	Der Typ der Beziehung zwischen den beiden Elementen. Im Laufe der Zeit können zusätzliche Beziehungstypen hinzugefügt werden.

ErrorRelatedResource

Objekt

Das Objekt der fehlerbezogenen Ressourcendetails.

Name	Typ	Beschreibung
resourceId	string	Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType	string	Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name	Typ	Beschreibung
errorCode	string	Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
isRetriable	boolean	Wenn true, kann die Anforderung wiederholt werden. Verwenden Sie den `Retry-After` Antwortheader, um die Verzögerung zu ermitteln, falls verfügbar.
message	string	Eine menschenlesbare Darstellung des Fehlers.
moreDetails	ErrorResponseDetails[]	Liste der zusätzlichen Fehlerdetails.
relatedResource	ErrorRelatedResource	Die fehlerbezogenen Ressourcendetails.
requestId	string (uuid)	ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name	Typ	Beschreibung
errorCode	string	Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message	string	Eine menschenlesbare Darstellung des Fehlers.
relatedResource	ErrorRelatedResource	Die fehlerbezogenen Ressourcendetails.

ItemType

Enumeration

Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.

Wert	Beschreibung
Dashboard	PowerBI-Dashboard.
Report	PowerBI-Bericht.
SemanticModel	PowerBI-Semantikmodell.
PaginatedReport	PowerBI-Paginated-Bericht.
Datamart	PowerBI datamart.
Lakehouse	Ein Seehaus.
Eventhouse	Ein Eventhouse.
Environment	Eine Umgebung.
KQLDatabase	Eine KQL-Datenbank.
KQLQueryset	Ein KQL-Abfrageset.
KQLDashboard	Ein KQL-Dashboard.
DataPipeline	Eine Datenpipeline.
Notebook	Ein Notebook
SparkJobDefinition	Eine Sparkauftragsdefinition.
MLExperiment	Ein Machine Learning-Experiment.
MLModel	Ein Machine Learning-Modell.
Warehouse	Ein Lagerhaus.
Eventstream	Ein Event-Stream.
SQLEndpoint	Ein SQL-Endpunkt.
MirroredWarehouse	Ein gespiegeltes Lager.
MirroredDatabase	Eine gespiegelte Datenbank.
Reflex	Ein Reflex.
GraphQLApi	Eine API für GraphQL-Element.
MountedDataFactory	Eine MountedDataFactory.
SQLDatabase	Eine SQLDatabase.
CopyJob	Ein Kopierauftrag.
VariableLibrary	Eine VariableLibrary.
Dataflow	Ein Datenfluss.
ApacheAirflowJob	Ein ApacheAirflowJob.
WarehouseSnapshot	Eine Warehouse-Momentaufnahme.
DigitalTwinBuilder	Ein DigitalTwinBuilder.
DigitalTwinBuilderFlow	Ein Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	Ein gespiegelter Azure Databricks-Katalog.
Map	Eine Karte.
AnomalyDetector	Anomaliedetektor.
UserDataFunction	Eine Benutzerdatenfunktion.
GraphModel	Ein GraphModel.
GraphQuerySet	Ein Graph QuerySet.
SnowflakeDatabase	Eine Snowflake-Datenbank zum Speichern von Iceberg-Tabellen, die aus dem Snowflake-Konto erstellt wurden.
OperationsAgent	Ein OperationsAgent.
CosmosDBDatabase	Eine Cosmos DB-Datenbank.
Ontology	Eine Ontologie.
EventSchemaSet	Ein EventSchemaSet.
DataAgent	Ein DataAgent.
MirroredCatalog	A MirroredCatalog.
AppBackend	Ein AppBackend.
OrgApp	Eine Organisations-App.
OrgAppAudience	Eine Organisations-App-Zielgruppe.
DataBuildToolJob	Ein DataBuildToolJob.
AzureDatabricksStorage	Ein OneLake-gesichertes Speicherelement für Azure Databricks.

RelationsEdge

Objekt

Ein Beziehungsrand zwischen zwei Elementen.

Name	Typ	Beschreibung
dependentOnItemId	string (uuid)	Der Bezeichner des Elements, von dem das Quellelement abhängt.
itemId	string (uuid)	Der Quellelementbezeichner.
relationType	RelationType	Der Typ der Beziehung zwischen den beiden Elementen. Im Laufe der Zeit können zusätzliche Beziehungstypen hinzugefügt werden.

RelationsRelatedItem

Objekt

Ein Element, das mit dem angegebenen Element verknüpft ist. Dies ist eine Teilmenge des vollständigen Elementobjekts, das nur die eigenschaften enthält, die von den Beziehungen-APIs zurückgegeben werden.

Name	Typ	Beschreibung
displayName	string	Der Anzeigename des Elements.
id	string (uuid)	Die Element-ID.
type	ItemType	Der Elementtyp.
workspaceId	string (uuid)	Die ID des Arbeitsbereichs, der das Element enthält. Verwenden Sie diese ID, um den Arbeitsbereich in der `workspaces` Liste zu finden.

RelationsResponse

Objekt

Eine Antwort, die verwandte Elemente, Beziehungsränder und referenzierte Arbeitsbereiche enthält.

Name	Typ	Beschreibung
items	RelationsRelatedItem[]	Eine Liste verwandter Elemente.
relations	RelationsEdge[]	Eine Liste der Beziehungsränder zwischen Elementen.
workspaces	RelationsWorkspace[]	Eine Liste der Arbeitsbereiche, auf die von den zugehörigen Elementen verwiesen wird.

RelationsWorkspace

Objekt

Ein Arbeitsbereich, auf den in der Beziehungsantwort verwiesen wird.

Name	Typ	Beschreibung
displayName	string	Der Anzeigename des Arbeitsbereichs.
id	string (uuid)	Der Arbeitsbereichsbezeichner.

RelationType

Enumeration

Der Typ der Beziehung zwischen den beiden Elementen. Im Laufe der Zeit können zusätzliche Beziehungstypen hinzugefügt werden.

Wert	Beschreibung
CascadeDelete	Eine CascadeDelete-Beziehung gibt an, dass das Element das übergeordnete Element der abhängigenOnItemId ist und das Löschen des Elements bewirkt, dass das abhängige Element ebenfalls gelöscht wird.
WeakAssociation	Eine WeakAssociation-Beziehung gibt an, dass es eine weiche Abhängigkeit von dem Element gibt, das durch die dependentOnItemId identifiziert wird. Wenn das abhängige Element gelöscht wird, wird die Beziehung entfernt.
Datasource	Eine Datenquellenbeziehung gibt an, dass es eine weiche Abhängigkeit von dem Element gibt, das von einer gemeinsamen Datenquelle identifiziert wird. Wenn das abhängige Element gelöscht wird, wird die Beziehung entfernt.
PushData	Eine PushData-Beziehung gibt an, dass ein abhängiges Element Daten schreibt/pusht, um ein abhängiges Element (das element, das durch die abhängigeOnItemId identifiziert wurde) abhängig zu machen. Wenn das abhängige Element gelöscht wird, wird die Beziehung entfernt.
Orchestration	Eine Orchestrierungsbeziehung gibt an, dass ein Element Verwaltungs- oder Orchestrierungsprozesse des Abhängigkeitselements ausführt(das element, das durch die dependentOnItemId identifiziert wurde). Wenn das abhängige Element gelöscht wird, wird die Beziehung entfernt.
Shortcut	Eine Verknüpfungsbeziehung gibt an, dass ein Element über eine Verknüpfung oder eine Verknüpfung mit Daten oder Datenbereich aus dem element verfügt, das von der abhängigenOnItemId identifiziert wird. Wenn das abhängige Element gelöscht wird, wird die Beziehung entfernt.
HiddenInWorkspace	HiddenInWorkspace gibt an, dass das Element, das diese Beziehung besitzt, im Arbeitsbereich ausgeblendet wird.