Items - Get Upstream Relations (beta)

Layanan:: Core

Versi API:: v1

Mendapatkan hubungan upstram untuk item.

Note

API ini adalah bagian dari rilis Beta dan disediakan hanya untuk tujuan evaluasi dan pengembangan. Ini dapat berubah berdasarkan umpan balik dan tidak disarankan untuk penggunaan produksi. Saat memanggil API ini, penelepon harus menentukan true sebagai nilai untuk parameter betakueri .

Mengembalikan semua item yang merupakan upstream dari item yang ditentukan, termasuk tepi relasi dan ruang kerja yang dirujuk.

Permissions

Pemanggil harus memiliki izin baca untuk item tersebut.

Cakupan Didelegasikan yang Diperlukan

Item.Read.All atau Item.ReadWrite.All

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas	Support
Pengguna	Ya
Prinsipal Layanan dan Identitas Terkelola	Ya

Interface

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
itemId	path	True	string (uuid)	ID item.
workspaceId	path	True	string (uuid)	ID ruangkerja.
beta	query	True	boolean	Parameter yang diperlukan ini harus diatur ke `true` untuk mengakses API ini, yang saat ini dalam versi beta.

Respons

Nama Jenis Deskripsi

200 OK

Nama	Jenis	Deskripsi
200 OK	RelationsResponse	Permintaan berhasil diselesaikan.
429 Too Many Requests	ErrorResponse	Batas tarif layanan terlampaui. Server mengembalikan header `Retry-After` yang menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan. Header Retry-After: integer
Other Status Codes	ErrorResponse	Kode kesalahan umum: ItemNotFound - Item yang diminta tidak ditemukan. InsufficientPrivileges - Pemanggil tidak memiliki izin yang memadai untuk mengakses item.

RelationsResponse

Permintaan berhasil diselesaikan.

429 Too Many Requests

ErrorResponse

Batas tarif layanan terlampaui. Server mengembalikan header Retry-After yang menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan.

Header

Retry-After: integer

Other Status Codes

ErrorResponse

Kode kesalahan umum:

ItemNotFound - Item yang diminta tidak ditemukan.
InsufficientPrivileges - Pemanggil tidak memiliki izin yang memadai untuk mengakses item.

Contoh

Get upstream relations example

Permintaan sampel

HTTP

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

Respon sampel

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

Definisi

Nama	Deskripsi
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Rincian respons kesalahan.
ItemType	Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.
RelationsEdge	Tepi relasi antara dua item.
RelationsRelatedItem	Item yang terkait dengan item yang ditentukan. Ini adalah subset dari objek item lengkap, yang hanya berisi properti yang dikembalikan oleh API relasi.
RelationsResponse	Respons yang berisi item terkait, tepi relasi, dan ruang kerja yang dirujuk.
RelationsWorkspace	Ruang kerja yang dirujuk dalam respons hubungan.
RelationType	Jenis hubungan antara dua item. Jenis relasi tambahan dapat ditambahkan dari waktu ke waktu.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama	Jenis	Deskripsi
resourceId	string	ID sumber daya yang terlibat dalam kesalahan.
resourceType	string	Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
isRetriable	boolean	Jika benar, permintaan dapat dicoba kembali. `Retry-After` Gunakan header respons untuk menentukan penundaan, jika tersedia.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
relatedResource	ErrorRelatedResource	Detail dari sumber daya yang terkait dengan kesalahan.
requestId	string (uuid)	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Rincian respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
relatedResource	ErrorRelatedResource	Detail dari sumber daya yang terkait dengan kesalahan.

ItemType

Enumerasi

Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Dashboard	Dasbor PowerBI.
Report	Laporan PowerBI.
SemanticModel	Model semantik PowerBI.
PaginatedReport	Laporan paginasi PowerBI.
Datamart	Datamart PowerBI.
Lakehouse	Sebuah lakehouse.
Eventhouse	Sebuah rumah acara.
Environment	Lingkungan.
KQLDatabase	Database KQL.
KQLQueryset	Set kueri KQL.
KQLDashboard	Dasbor KQL.
DataPipeline	Alur data.
Notebook	Buku catatan.
SparkJobDefinition	Definisi pekerjaan spark.
MLExperiment	Eksperimen pembelajaran mesin.
MLModel	Model pembelajaran mesin.
Warehouse	Sebuah gudang.
Eventstream	Sebuah aliran peristiwa.
SQLEndpoint	Titik akhir SQL.
MirroredWarehouse	Sebuah gudang cermin.
MirroredDatabase	Database cermin.
Reflex	Sebuah Refleks.
GraphQLApi	API untuk item GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Sebuah SQLDatabase.
CopyJob	Pekerjaan Penyalinan.
VariableLibrary	VariabelLibrary.
Dataflow	Aliran Data.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Rekam jepret gudang.
DigitalTwinBuilder	Sebuah DigitalTwinBuilder.
DigitalTwinBuilderFlow	Alur Pembangun Kembar Digital.
MirroredAzureDatabricksCatalog	Katalog azure databricks cermin.
Map	Peta.
AnomalyDetector	Detektor Anomali.
UserDataFunction	Fungsi data pengguna.
GraphModel	Sebuah GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake Database untuk menyimpan tabel Iceberg yang dibuat dari akun Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Database Cosmos DB.
Ontology	Ontologi.
EventSchemaSet	An EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	A MirroredCatalog.
AppBackend	An AppBackend.
OrgApp	Aplikasi Org.
OrgAppAudience	Audiens Aplikasi Org.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	Item penyimpanan yang didukung OneLake untuk Azure Databricks.
Plan	Sebuah rencana.

RelationsEdge

Objek

Tepi relasi antara dua item.

Nama	Jenis	Deskripsi
dependentOnItemId	string (uuid)	Pengidentifikasi item yang bergantung pada item sumber.
itemId	string (uuid)	Pengidentifikasi item sumber.
relationType	RelationType	Jenis hubungan antara dua item. Jenis relasi tambahan dapat ditambahkan dari waktu ke waktu.

RelationsRelatedItem

Objek

Item yang terkait dengan item yang ditentukan. Ini adalah subset dari objek item lengkap, yang hanya berisi properti yang dikembalikan oleh API relasi.

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan item.
id	string (uuid)	ID item.
type	ItemType	Jenis item.
workspaceId	string (uuid)	ID ruang kerja yang berisi item. Gunakan ID ini untuk menemukan ruang kerja dalam `workspaces` daftar.

RelationsResponse

Objek

Respons yang berisi item terkait, tepi relasi, dan ruang kerja yang dirujuk.

Nama	Jenis	Deskripsi
items	RelationsRelatedItem[]	Daftar item terkait.
relations	RelationsEdge[]	Daftar tepi relasi antar item.
workspaces	RelationsWorkspace[]	Daftar ruang kerja yang dirujuk oleh item terkait.

RelationsWorkspace

Objek

Ruang kerja yang dirujuk dalam respons hubungan.

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan ruang kerja.
id	string (uuid)	Pengidentifikasi ruang kerja.

RelationType

Enumerasi

Jenis hubungan antara dua item. Jenis relasi tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
CascadeDelete	Hubungan CascadeDelete menunjukkan bahwa item adalah Induk dependentOnItemId dan menghapus item akan menyebabkan item Dependen juga dihapus.
WeakAssociation	Hubungan WeakAssociation menunjukkan bahwa ada dependensi lunak pada item yang diidentifikasi oleh dependentOnItemId. Jika item Dependen dihapus, hubungan akan dihapus.
Datasource	Hubungan Sumber Data menunjukkan bahwa ada dependensi lunak pada item yang diidentifikasi oleh Sumber Data umum. Jika item Dependen dihapus, hubungan akan dihapus.
PushData	Hubungan PushData menunjukkan bahwa item dependen menulis/mendorong data ke item dependecy (item yang diidentifikasi oleh dependentOnItemId). Jika item Dependen dihapus, hubungan akan dihapus.
Orchestration	Hubungan Orkestrasi menunjukkan bahwa item menjalankan proses manajemen atau orkestrasi item dependensi (item yang diidentifikasi oleh dependentOnItemId). Jika item Dependen dihapus, hubungan akan dihapus.
Shortcut	Hubungan Pintasan menunjukkan bahwa item memiliki pintasan atau tautan ke data atau area data dari item yang diidentifikasi oleh dependentOnItemId. Jika item Dependen dihapus, hubungan akan dihapus.
HiddenInWorkspace	HiddenInWorkspace menunjukkan bahwa item yang memiliki hubungan ini akan disembunyikan di ruang kerja.