Admin - WorkspaceInfo GetModifiedWorkspaces

  • Referenz
Service:
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
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

URI-Parameter

Name In Erforderlich 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