Admin - WorkspaceInfo GetModifiedWorkspaces

Usługa:

Power BI REST APIs

Wersja interfejsu API:

v1.0

Pobiera listę identyfikatorów obszarów roboczych w organizacji.

Jeśli opcjonalny modifiedSince parametr jest ustawiony na datę i godzinę, zwracane są tylko identyfikatory obszarów roboczych, które uległy zmianie po tej dacie. modifiedSince Jeśli parametr nie jest używany, zwracane są identyfikatory wszystkich obszarów roboczych w organizacji. Data-godzina określona przez modifiedSince parametr musi należeć do zakresu 30 minut (aby umożliwić wprowadzenie zmian obszaru roboczego) do 30 dni przed bieżącą godziną.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Microsoft 365 lub administrator usługi Power BI) lub uwierzytelnić się przy użyciu jednostki usługi.

W przypadku uruchamiania w ramach uwierzytelniania jednostki usługi aplikacja nie może mieć żadnych uprawnień wymaganych przez administratora dla usługi Power BI ustawionej w Azure Portal.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego tokenu dostępu administratora delegowanego. Nie może być obecny w przypadku użycia uwierzytelniania za pośrednictwem jednostki usługi.

Ograniczenia

Maksymalnie 30 żądań na godzinę.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
excludeInActiveWorkspaces	query		boolean	Czy wykluczyć nieaktywne obszary robocze
excludePersonalWorkspaces	query		boolean	Czy wykluczyć osobiste obszary robocze
modifiedSince	query		string date-time	Data ostatniej modyfikacji (musi być zgodna z formatem UTC ISO 8601)

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ModifiedWorkspace[]	OK

Przykłady

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

Definicje

ModifiedWorkspace

Zmodyfikowany obszar roboczy

Nazwa	Typ	Opis
id	string	Identyfikator obiektu obszaru roboczego