Admin - WorkspaceInfo GetModifiedWorkspaces

Referensi

Layanan:: Power BI REST APIs

Versi API:: v1.0

Mendapatkan daftar ID ruang kerja di organisasi.

Jika parameter opsional modifiedSince diatur ke tanggal-waktu, hanya ID ruang kerja yang berubah setelah tanggal-waktu tersebut yang dikembalikan. modifiedSince Jika parameter tidak digunakan, ID semua ruang kerja dalam organisasi dikembalikan. Tanggal-waktu yang ditentukan oleh modifiedSince parameter harus dalam rentang 30 menit (untuk memungkinkan perubahan ruang kerja berlaku) hingga 30 hari sebelum waktu saat ini.

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 yang didelegasikan standar. Tidak boleh ada saat autentikasi melalui perwakilan layanan digunakan.

Batasan

Maksimum 30 permintaan per jam.

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified

Dengan parameter opsional:

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

Parameter URI

Nama	Dalam	Jenis	Deskripsi
excludeInActiveWorkspaces	query	boolean	Apakah akan mengecualikan ruang kerja yang tidak aktif
excludePersonalWorkspaces	query	boolean	Apakah akan mengecualikan ruang kerja pribadi
modifiedSince	query	string date-time	Tanggal terakhir diubah (harus dalam format UTC yang mematuhi ISO 8601)

Respons

Nama	Jenis	Deskripsi
200 OK	ModifiedWorkspace[]	OK

Contoh

Example

Sample request

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince=2020-10-02T05:51:30.0000000Z&excludePersonalWorkspaces=True&excludeInActiveWorkspaces=True

Sample response

Status code:: 200

[
  {
    "id": "3740504d-1f93-42f9-8e9d-c8ba9b787a3b"
  },
  {
    "id": "19cb346c-9839-4e19-81e6-76364d0b836f"
  }
]

Definisi

ModifiedWorkspace

Ruang kerja yang dimodifikasi

Nama	Jenis	Deskripsi
id	string	ID objek ruang kerja

Bagikan melalui