Sdílet prostřednictvím


Admin - WorkspaceInfo GetModifiedWorkspaces

Získá seznam ID pracovních prostorů v organizaci.

Pokud je volitelný modifiedSince parametr nastavený na datum a čas, vrátí se jenom ID pracovních prostorů, které se po tomto datu a čase změnily. Pokud se modifiedSince parametr nepoužije, vrátí se ID všech pracovních prostorů v organizaci. Datum a čas určený parametrem modifiedSince musí být v rozsahu 30 minut (aby se změny pracovního prostoru projevily) až 30 dní před aktuálním časem.

Oprávnění

Uživatel musí mít oprávnění správce (například globální správce Microsoft 365 nebo správce služby Power BI) nebo ověřování pomocí instančního objektu.

Při spuštění v rámci ověřování instančního objektu nesmí mít aplikace v Azure Portal nastavená oprávnění pro Power BI vyžadovaná souhlasem správce.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního přístupového tokenu delegovaného správce. Nesmí být přítomen, když se používá ověřování prostřednictvím instančního objektu.

Omezení

Maximálně 30 požadavků za hodinu.

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 identifikátoru URI

Name V Vyžadováno Typ Description
excludeInActiveWorkspaces
query

boolean

Jestli se mají vyloučit neaktivní pracovní prostory

excludePersonalWorkspaces
query

boolean

Jestli se mají vyloučit osobní pracovní prostory

modifiedSince
query

string

date-time

Datum poslední změny (musí být ve formátu UTC kompatibilním se standardem ISO 8601)

Odpovědi

Name Typ Description
200 OK

ModifiedWorkspace[]

OK

Příklady

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

Definice

ModifiedWorkspace

Upravený pracovní prostor

Name Typ Description
id

string

ID objektu pracovního prostoru