Udostępnij za pośrednictwem


Admin - WorkspaceInfo GetModifiedWorkspaces

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
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

[
  {
    "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