Admin - WorkspaceInfo GetModifiedWorkspaces

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 eine Datums-/Uhrzeit festgelegt ist, werden nur die IDs von Arbeitsbereichen zurückgegeben, die nach dieser Datumszeit geändert wurden. Wenn der parameter modifiedSince nicht verwendet wird, werden die IDs aller Arbeitsbereiche in der Organisation zurückgegeben. Die durch den parameter modifiedSince angegebene Datumszeit muss im Bereich von 30 Minuten liegen (damit Arbeitsbereichsänderungen wirksam werden können) bis zu 30 Tage vor der aktuellen Uhrzeit.

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.

Wenn eine App unter der Dienstprinzipalauthentifizierung ausgeführt wird, darf eine App nicht über erforderliche Administratorberechtigungen für Power BI verfügen, die im Azure-Portal darauf festgelegt sind.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

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

Begrenzungen

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	Gibt an, ob inaktive Arbeitsbereiche ausgeschlossen werden sollen
excludePersonalWorkspaces	query	boolean	Gibt an, ob persönliche Arbeitsbereiche ausgeschlossen werden sollen
modifiedSince	query	string (date-time)	Datum der letzten Änderung (muss im ISO 8601-kompatiblen UTC-Format vorliegen)

Antworten

Name	Typ	Beschreibung
200 OK	ModifiedWorkspace[]	OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 200

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

Definitionen

ModifiedWorkspace

Objekt

Ein geänderter Arbeitsbereich

Name	Typ	Beschreibung
id	string (uuid)	Die Arbeitsbereichsobjekt-ID

Freigeben über