Udostępnij przez


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 i godzinie. 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ć wprowadzanie zmian obszaru roboczego) do 30 dni przed bieżącą godziną.

Permissions

Użytkownik musi być administratorem sieci szkieletowej lub uwierzytelniać 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 witrynie Azure Portal.

Wymagany zakres

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie 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 wykluczać nieaktywne obszary robocze

excludePersonalWorkspaces
query

boolean

Czy wykluczyć osobiste obszary robocze

modifiedSince
query

string (date-time)

Data ostatniej modyfikacji (musi być zgodna z normą ISO 8601 w formacie UTC)

Odpowiedzi

Nazwa Typ Opis
200 OK

ModifiedWorkspace[]

OK

Przykłady

Example

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

ModifiedWorkspace

Zmodyfikowany obszar roboczy

Nazwa Typ Opis
id

string (uuid)

Identyfikator obiektu obszaru roboczego