Admin - WorkspaceInfo PostWorkspaceInfo

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Memulai panggilan untuk menerima metadata untuk daftar ruang kerja yang diminta.

Penting

Jika Anda mengatur datasetSchema parameter atau datasetExpressions ke true, Anda harus sepenuhnya mengaktifkan pemindaian metadata agar data dikembalikan. Untuk informasi selengkapnya, lihat Mengaktifkan pengaturan penyewa untuk pemindaian metadata.

Izin

Pengguna harus memiliki hak administrator (seperti Microsoft Administrator Global 365 atau Administrator Layanan Power BI) atau mengautentikasi menggunakan perwakilan layanan.

Saat berjalan di bawah autentikasi perwakilan layanan, aplikasi tidak boleh memiliki izin yang diperlukan persetujuan admin untuk Power BI yang diatur di portal Azure.

Cakupan yang Diperlukan

Tenant.Read.All atau Tenant.ReadWrite.All

Hanya relevan saat mengautentikasi melalui token akses admin standar yang didelegasikan. Tidak boleh ada ketika autentikasi melalui perwakilan layanan digunakan.

Batasan

Maksimum 500 permintaan per jam.
Maksimum 16 permintaan simultan.

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo

With optional parameters:

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo?lineage={lineage}&datasourceDetails={datasourceDetails}&datasetSchema={datasetSchema}&datasetExpressions={datasetExpressions}&getArtifactUsers={getArtifactUsers}

Parameter URI

Nama	Dalam	Jenis	Deskripsi
datasetExpressions	query	boolean	Apakah akan mengembalikan ekspresi himpunan data (kueri DAX dan Mashup). Jika Anda mengatur parameter ini ke `true`, Anda harus sepenuhnya mengaktifkan pemindaian metadata agar data dikembalikan. Untuk informasi selengkapnya, lihat Mengaktifkan pengaturan penyewa untuk pemindaian metadata.
datasetSchema	query	boolean	Apakah akan mengembalikan skema himpunan data (tabel, kolom, dan pengukuran). Jika Anda mengatur parameter ini ke `true`, Anda harus sepenuhnya mengaktifkan pemindaian metadata agar data dikembalikan. Untuk informasi selengkapnya, lihat Mengaktifkan pengaturan penyewa untuk pemindaian metadata.
datasourceDetails	query	boolean	Apakah akan mengembalikan detail sumber data
getArtifactUsers	query	boolean	Apakah akan mengembalikan detail pengguna untuk item Power BI (seperti laporan atau dasbor)
lineage	query	boolean	Apakah akan mengembalikan info silsilah data (aliran data upstram, petak peta, ID sumber data)

Isi Permintaan

Nama	Jenis	Deskripsi
workspaces	string[]	ID ruang kerja yang diperlukan untuk dipindai (mendukung 1 hingga 100 ID ruang kerja)

Respons

Nama	Jenis	Deskripsi
202 Accepted	ScanRequest	Diterima

Contoh

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/workspaces/getInfo?lineage=True&datasourceDetails=True&datasetSchema=True&datasetExpressions=True

Request Body

{
  "workspaces": [
    "97d03602-4873-4760-b37e-1563ef5358e3",
    "67b7e93a-3fb3-493c-9e41-2c5051008f24"
  ]
}

Sample Response

Status code:: 202

{
  "id": "e7d03602-4873-4760-b37e-1563ef5358e3",
  "createdDateTime": "2020-06-15T16:46:28.0487687Z",
  "status": "NotStarted"
}

Definisi

Nama	Deskripsi
PowerBIApiErrorResponseDetail	Informasi terperinci tentang respons kesalahan Power BI
RequiredWorkspaces	Permintaan ruang kerja yang diperlukan
ScanRequest	Permintaan pemindaian

PowerBIApiErrorResponseDetail

Informasi terperinci tentang respons kesalahan Power BI

Nama	Jenis	Deskripsi
code	string	Kode kesalahan
message	string	Pesan kesalahan
target	string	Target kesalahan

RequiredWorkspaces

Permintaan ruang kerja yang diperlukan

Nama	Jenis	Deskripsi
workspaces	string[]	ID ruang kerja yang diperlukan untuk dipindai (mendukung 1 hingga 100 ID ruang kerja)

ScanRequest

Permintaan pemindaian

Nama	Jenis	Deskripsi
createdDateTime	string	Tanggal dan waktu pembuatan pemindaian
error	PowerBIApiErrorResponseDetail	Kesalahan pemindaian (jika ada)
id	string	ID pemindaian
status	string	Status pemindaian

Bagikan melalui