Admin - WorkspaceInfo GetModifiedWorkspaces

Referenz

Dienst:: Power BI REST APIs

API-Version:: v1.0

Ruft eine Liste der Arbeitsbereichs-IDs in der Organisation ab.

Wenn der optionale modifiedSince Parameter auf ein Datum/Uhrzeit festgelegt ist, werden nur die IDs von Arbeitsbereichen zurückgegeben, die sich nach dieser Datums-/Uhrzeit geändert haben. Wenn der modifiedSince Parameter nicht verwendet wird, werden die IDs aller Arbeitsbereiche in der Organisation zurückgegeben. Das durch den modifiedSince Parameter angegebene Datum/Uhrzeit muss im Bereich von 30 Minuten liegen (damit Änderungen des Arbeitsbereichs wirksam werden) bis 30 Tage vor der aktuellen Uhrzeit liegen.

Berechtigungen

Der Benutzer muss über Administratorrechte (z. B. Microsoft globalen 365-Administrator oder Power BI-Dienstadministrator) verfügen oder sich mit einem Dienstprinzipal authentifizieren.

Bei der Ausführung unter Dienstprinzipalauthentifizierung dürfen für eine App im Azure-Portal keine erforderlichen Administratorberechtigungen für Power BI festgelegt sein.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken relevant. Darf nicht vorhanden sein, wenn die Authentifizierung über einen Dienstprinzipal verwendet wird.

Einschränkungen

Maximal 30 Anforderungen pro Stunde.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Typ	Beschreibung
excludeInActiveWorkspaces	query	boolean	Ob inaktive Arbeitsbereiche ausgeschlossen werden sollen
excludePersonalWorkspaces	query	boolean	Ob persönliche Arbeitsbereiche ausgeschlossen werden sollen
modifiedSince	query	string date-time	Datum der letzten Änderung (muss im ISO 8601-konformen UTC-Format vorliegen)

Antworten

Name	Typ	Beschreibung
200 OK	ModifiedWorkspace[]	OK

Beispiele

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

Definitionen

ModifiedWorkspace

Ein geänderter Arbeitsbereich

Name	Typ	Beschreibung
id	string	Die Objekt-ID des Arbeitsbereichs

Freigeben über