Items - Get Upstream Relations (beta)

Hizmet:: Core

API Sürümü:: v1

Bir öğe için yukarı akış ilişkilerini alır.

Uyarı

Bu API, Beta sürümünün bir parçasıdır ve yalnızca değerlendirme ve geliştirme amacıyla sağlanır. Geri bildirim temelinde değişebilir ve üretim kullanımı için önerilmez. Bu API'yi çağırırken, çağıranların sorgu parametresinin truedeğeri olarak belirtmesi beta gerekir.

İlişki kenarları ve başvuruda bulunan çalışma alanları dahil olmak üzere belirtilen öğenin yukarı akışı olan tüm öğeleri döndürür.

İzinler

Çağıranın öğe için okuma izinlerine sahip olması gerekir.

Gerekli Devredilen Kapsamlar

Item.Read.All veya Item.ReadWrite.All

Microsoft Entra destekli kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Identity	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Arayüz

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
itemId	path	True	string (uuid)	Öğe kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.
beta	query	True	boolean	Şu anda beta sürümünde olan bu API'ye erişmek için bu gerekli parametre olarak ayarlanmalıdır `true` .

Yanıtlar

Name Tür Description

200 OK

Name	Tür	Description
200 OK	RelationsResponse	İstek başarıyla tamamlandı.
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Sık karşılaşılan hata kodları: ItemNotFound - İstenen öğe bulunamadı. InsufficientPrivileges - Çağıranın öğeye erişmek için yeterli izinleri yok.

RelationsResponse

İstek başarıyla tamamlandı.

429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

Retry-After: integer

Other Status Codes

ErrorResponse

Sık karşılaşılan hata kodları:

ItemNotFound - İstenen öğe bulunamadı.
InsufficientPrivileges - Çağıranın öğeye erişmek için yeterli izinleri yok.

Örnekler

Get upstream relations example

Örnek isteği

HTTP

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

Örnek yanıt

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

Tanımlar

Name	Description
ErrorRelatedResource	Hata ile ilişkili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
ItemType	Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.
RelationsEdge	İki öğe arasındaki ilişki kenarı.
RelationsRelatedItem	Belirtilen öğeyle ilişkili bir öğe. Bu, yalnızca ilişkiler API'leri tarafından döndürülen özellikleri içeren tam öğe nesnesinin bir alt kümesidir.
RelationsResponse	İlgili öğeleri, ilişki kenarlarını ve başvuruda bulunılan çalışma alanlarını içeren bir yanıt.
RelationsWorkspace	İlişkiler yanıtında başvuruda bulunan bir çalışma alanı.
RelationType	İki öğe arasındaki ilişki türü. Zaman içinde ek ilişki türleri eklenebilir.

ErrorRelatedResource

Nesne

Hata ile ilişkili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi `Retry-After` belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın insan tarafından okunabilir bir temsilidir.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın insan tarafından okunabilir bir temsilidir.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

ItemType

Numaralandırma

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer	Description
Dashboard	PowerBI panosu.
Report	PowerBI raporu.
SemanticModel	PowerBI anlam modeli.
PaginatedReport	PowerBI sayfalandırılmış raporu.
Datamart	PowerBI datamart.
Lakehouse	Göl evi.
Eventhouse	Bir olay evi.
Environment	Bir ortam.
KQLDatabase	KQL veritabanı.
KQLQueryset	KQL sorgu kümesi.
KQLDashboard	KQL panosu.
DataPipeline	Veri işlem hattı.
Notebook	Bir not defteri.
SparkJobDefinition	Spark iş tanımı.
MLExperiment	Makine öğrenmesi denemesi.
MLModel	Makine öğrenmesi modeli.
Warehouse	Bir depo.
Eventstream	Bir olay akışı.
SQLEndpoint	Bir SQL uç noktası.
MirroredWarehouse	Aynalı bir depo.
MirroredDatabase	Yansıtılmış veritabanı.
Reflex	Bir refleks.
GraphQLApi	GraphQL öğesi için bir API.
MountedDataFactory	Bir MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Kopyalama işi.
VariableLibrary	Bir VariableLibrary.
Dataflow	Veri akışı.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Ambar anlık görüntüsü.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Dijital İkiz Oluşturucu Akışı.
MirroredAzureDatabricksCatalog	Yansıtılmış azure databricks kataloğu.
Map	Bir harita.
AnomalyDetector	Anomali Algılayıcısı.
UserDataFunction	Kullanıcı Verileri İşlevi.
GraphModel	A GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake hesabından oluşturulan Iceberg tablolarını depolamak için bir Snowflake Veritabanı.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Cosmos DB Veritabanı.
Ontology	Bir Ontoloji.
EventSchemaSet	Bir EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	A MirroredCatalog.
AppBackend	An AppBackend.
OrgApp	Kuruluş uygulaması.
OrgAppAudience	Kuruluş Uygulaması Hedef Kitlesi.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	Azure Databricks için OneLake destekli bir depolama öğesi.

RelationsEdge

Nesne

İki öğe arasındaki ilişki kenarı.

Name	Tür	Description
dependentOnItemId	string (uuid)	Kaynak öğenin bağımlı olduğu öğenin tanımlayıcısı.
itemId	string (uuid)	Kaynak öğe tanımlayıcısı.
relationType	RelationType	İki öğe arasındaki ilişki türü. Zaman içinde ek ilişki türleri eklenebilir.

RelationsRelatedItem

Nesne

Belirtilen öğeyle ilişkili bir öğe. Bu, yalnızca ilişkiler API'leri tarafından döndürülen özellikleri içeren tam öğe nesnesinin bir alt kümesidir.

Name	Tür	Description
displayName	string	Öğenin görünen adı.
id	string (uuid)	Öğe kimliği.
type	ItemType	Öğe türü.
workspaceId	string (uuid)	Öğeyi içeren çalışma alanının kimliği. Listede çalışma alanını `workspaces` bulmak için bu kimliği kullanın.

RelationsResponse

Nesne

İlgili öğeleri, ilişki kenarlarını ve başvuruda bulunılan çalışma alanlarını içeren bir yanıt.

Name	Tür	Description
items	RelationsRelatedItem[]	İlgili öğelerin listesi.
relations	RelationsEdge[]	Öğeler arasındaki ilişki kenarlarının listesi.
workspaces	RelationsWorkspace[]	İlgili öğeler tarafından başvuruda bulunan çalışma alanlarının listesi.

RelationsWorkspace

Nesne

İlişkiler yanıtında başvuruda bulunan bir çalışma alanı.

Name	Tür	Description
displayName	string	Çalışma alanı görünen adı.
id	string (uuid)	Çalışma alanı tanımlayıcısı.

RelationType

Numaralandırma

İki öğe arasındaki ilişki türü. Zaman içinde ek ilişki türleri eklenebilir.

Değer	Description
CascadeDelete	CascadeDelete ilişkisi, öğenin dependentOnItemId öğesinin Üst öğesi olduğunu gösterir ve öğenin silinmesi, Dependent öğesinin de silinmesine neden olur.
WeakAssociation	WeakAssociation ilişkisi, dependentOnItemId tarafından tanımlanan öğede geçici bir bağımlılık olduğunu gösterir. Bağımlı öğe silinirse ilişki kaldırılır.
Datasource	Veri Kaynağı ilişkisi, ortak bir Veri Kaynağı tarafından tanımlanan öğede geçici bir bağımlılık olduğunu gösterir. Bağımlı öğe silinirse ilişki kaldırılır.
PushData	PushData ilişkisi, bağımlı bir öğenin bağımlı öğeye (dependentOnItemId tarafından tanımlanan öğe) veri yazdığını/gönderdiğini gösterir. Bağımlı öğe silinirse ilişki kaldırılır.
Orchestration	Orchestration ilişkisi, bir öğenin bağımlılık öğesinin (dependentOnItemId tarafından tanımlanan öğe) yönetim veya düzenleme işlemlerini yürüttüğüne işaret eder. Bağımlı öğe silinirse ilişki kaldırılır.
Shortcut	Kısayol ilişkisi, bir öğenin dependentOnItemId tarafından tanımlanan öğeden veri veya veri alanına kısayolu veya bağlantısı olduğunu gösterir. Bağımlı öğe silinirse ilişki kaldırılır.
HiddenInWorkspace	HiddenInWorkspace, bu ilişkinin sahibi olan öğenin çalışma alanında gizleneceğini gösterir.