Items - Get Downstream Relations (beta)

Tjänst:: Core

API-version:: v1

Hämtar underordnade relationer för ett objekt.

Anmärkning

Det här API:et är en del av en betaversion och tillhandahålls endast i utvärderings- och utvecklingssyfte. Den kan ändras baserat på feedback och rekommenderas inte för produktionsanvändning. När du anropar det här API:et måste anropare ange true som värde för frågeparametern beta.

Returnerar alla objekt som är underordnade det angivna objektet, inklusive relationskanter och refererade arbetsytor.

Behörigheter

Anroparen måste ha läsbehörighet för objektet.

Obligatoriska delegerade omfång

Item.Read.All eller Item.ReadWrite.All

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet	Support
User	Ja
Tjänsthuvudnamn och hanterade identiteter	Ja

Interface

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
itemId	path	True	string (uuid)	Objekt-ID:t.
workspaceId	path	True	string (uuid)	Arbetsyte-ID.
beta	query	True	boolean	Den här obligatoriska parametern måste anges för att få åtkomst till `true` det här API:et, som för närvarande är i betaversion.

Svar

Name Typ Description

200 OK

Name	Typ	Description
200 OK	RelationsResponse	Begäran har slutförts.
429 Too Many Requests	ErrorResponse	Gränsen för tjänstfrekvens överskreds. Servern returnerar ett `Retry-After` huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas. Sidhuvuden Retry-After: integer
Other Status Codes	ErrorResponse	Vanliga felkoder: ItemNotFound – Det begärda objektet hittades inte. InsufficientPrivileges – Anroparen har inte tillräcklig behörighet för att komma åt objektet.

RelationsResponse

Begäran har slutförts.

429 Too Many Requests

ErrorResponse

Gränsen för tjänstfrekvens överskreds. Servern returnerar ett Retry-After huvud som anger i sekunder hur länge klienten måste vänta innan ytterligare begäranden skickas.

Sidhuvuden

Retry-After: integer

Other Status Codes

ErrorResponse

Vanliga felkoder:

ItemNotFound – Det begärda objektet hittades inte.
InsufficientPrivileges – Anroparen har inte tillräcklig behörighet för att komma åt objektet.

Exempel

Get downstream relations example

Exempelbegäran

HTTP

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

Exempelsvar

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

Definitioner

Name	Description
ErrorRelatedResource	Det felrelaterade resursinformationsobjektet.
ErrorResponse	Felsvaret.
ErrorResponseDetails	Detaljer om felsvaret.
ItemType	Typ av objekt. Ytterligare objekttyper kan läggas till över tid.
RelationsEdge	En relationsgräns mellan två objekt.
RelationsRelatedItem	Ett objekt som är relaterat till det angivna objektet. Det här är en delmängd av det fullständiga objektobjektet som endast innehåller de egenskaper som returneras av relations-API:erna.
RelationsResponse	Ett svar som innehåller relaterade objekt, relationskanter och refererade arbetsytor.
RelationsWorkspace	En arbetsyta som refereras till i relationssvaret.
RelationType	Typ av relation mellan de två objekten. Ytterligare relationstyper kan läggas till över tid.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name	Typ	Description
resourceId	string	Resurs-ID:t som är inblandat i felet.
resourceType	string	Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
isRetriable	boolean	När det är sant kan begäran göras på nytt. Använd svarshuvudet `Retry-After` för att fastställa fördröjningen, om den är tillgänglig.
message	string	En mänsklig läsbar representation av felet.
moreDetails	ErrorResponseDetails[]	Lista över ytterligare felinformation.
relatedResource	ErrorRelatedResource	Detaljer om resursen relaterad till felet.
requestId	string (uuid)	ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Detaljer om felsvaret.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
relatedResource	ErrorRelatedResource	Detaljer om resursen relaterad till felet.

ItemType

Uppräkning

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

Värde	Description
Dashboard	PowerBI-instrumentpanel.
Report	PowerBI-rapport.
SemanticModel	PowerBI-semantisk modell.
PaginatedReport	Sidnumrerad PowerBI-rapport.
Datamart	PowerBI-datamart.
Lakehouse	Ett sjöhus.
Eventhouse	Ett eventhouse.
Environment	En miljö.
KQLDatabase	En KQL-databas.
KQLQueryset	En KQL-frågeuppsättning.
KQLDashboard	En KQL-instrumentpanel.
DataPipeline	En datapipeline.
Notebook	En anteckningsbok.
SparkJobDefinition	En definition för Spark-jobb.
MLExperiment	Ett maskininlärningsexperiment.
MLModel	En maskininlärningsmodell.
Warehouse	Ett lager.
Eventstream	En händelseström.
SQLEndpoint	En SQL-slutpunkt.
MirroredWarehouse	Ett speglat lager.
MirroredDatabase	En speglad databas.
Reflex	En reflex.
GraphQLApi	Ett API för GraphQL-objekt.
MountedDataFactory	En MountedDataFactory.
SQLDatabase	En SQLDatabase.
CopyJob	Ett kopieringsjobb.
VariableLibrary	En VariableLibrary.
Dataflow	Ett dataflöde.
ApacheAirflowJob	Ett ApacheAirflowJob.
WarehouseSnapshot	En ögonblicksbild av lagret.
DigitalTwinBuilder	En DigitalTwinBuilder.
DigitalTwinBuilderFlow	Ett Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	En speglad azure databricks-katalog.
Map	En karta.
AnomalyDetector	En avvikelseidentifiering.
UserDataFunction	En användardatafunktion.
GraphModel	En GraphModel.
GraphQuerySet	En Graph QuerySet.
SnowflakeDatabase	En Snowflake-databas för att lagra isbergstabeller som skapats från Snowflake-kontot.
OperationsAgent	En OperationsAgent.
CosmosDBDatabase	En Cosmos DB-databas.
Ontology	En ontologi.
EventSchemaSet	En EventSchemaSet.
DataAgent	En DataAgent.
MirroredCatalog	En MirroredCatalog.
AppBackend	En AppBackend.
OrgApp	En organisationsapp.
OrgAppAudience	En målgrupp för en organisationsapp.
DataBuildToolJob	Ett DataBuildToolJob.
AzureDatabricksStorage	Ett OneLake-säkerhetskopierat lagringsobjekt för Azure Databricks.

RelationsEdge

Objekt

En relationsgräns mellan två objekt.

Name	Typ	Description
dependentOnItemId	string (uuid)	Identifieraren för det objekt som källobjektet är beroende av.
itemId	string (uuid)	Källobjektets identifierare.
relationType	RelationType	Typ av relation mellan de två objekten. Ytterligare relationstyper kan läggas till över tid.

RelationsRelatedItem

Objekt

Ett objekt som är relaterat till det angivna objektet. Det här är en delmängd av det fullständiga objektobjektet som endast innehåller de egenskaper som returneras av relations-API:erna.

Name	Typ	Description
displayName	string	Objektets visningsnamn.
id	string (uuid)	Objekt-ID:t.
type	ItemType	Objekttypen.
workspaceId	string (uuid)	ID för arbetsytan som innehåller objektet. Använd det här ID:t för att hitta arbetsytan i `workspaces` listan.

RelationsResponse

Objekt

Ett svar som innehåller relaterade objekt, relationskanter och refererade arbetsytor.

Name	Typ	Description
items	RelationsRelatedItem[]	En lista över relaterade objekt.
relations	RelationsEdge[]	En lista över relationskanter mellan objekt.
workspaces	RelationsWorkspace[]	En lista över arbetsytor som refereras av relaterade objekt.

RelationsWorkspace

Objekt

En arbetsyta som refereras till i relationssvaret.

Name	Typ	Description
displayName	string	Arbetsytans visningsnamn.
id	string (uuid)	Arbetsytans ID.

RelationType

Uppräkning

Typ av relation mellan de två objekten. Ytterligare relationstyper kan läggas till över tid.

Värde	Description
CascadeDelete	En CascadeDelete-relation anger att objektet är överordnat för det beroendeOnItemId och om du tar bort objektet tas även det beroende objektet bort.
WeakAssociation	En WeakAssociation-relation anger att det finns ett mjukt beroende av objektet som identifieras av det beroendeOnItemId. Om det beroende objektet tas bort tas relationen bort.
Datasource	En Datasource-relation anger att det finns ett mjukt beroende av objektet som identifieras av en gemensam datakälla. Om det beroende objektet tas bort tas relationen bort.
PushData	En PushData-relation anger att ett beroende objekt skriver/push-överför data till beroende objekt (objektet som identifieras av det beroendeOnItemId). Om det beroende objektet tas bort tas relationen bort.
Orchestration	En orkestreringsrelation anger att ett objekt kör hanterings- eller orkestreringsprocesser för beroendeobjektet (objektet som identifieras av det beroendeOnItemId). Om det beroende objektet tas bort tas relationen bort.
Shortcut	En genvägsrelation anger att ett objekt har en genväg eller länk till data eller dataområde från objekt som identifierats av det beroendeOnItemId. Om det beroende objektet tas bort tas relationen bort.
HiddenInWorkspace	HiddenInWorkspace anger att objektet som äger den här relationen kommer att döljas på arbetsytan.