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 |
|---|---|---|---|---|
|
exclude
|
query |
boolean |
Czy wykluczać nieaktywne obszary robocze |
|
|
exclude
|
query |
boolean |
Czy wykluczyć osobiste obszary robocze |
|
|
modified
|
query |
string (date-time) |
Data ostatniej modyfikacji (musi być zgodna z normą ISO 8601 w formacie UTC) |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
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 |