Condividi tramite


Admin - WorkspaceInfo GetModifiedWorkspaces

Ottiene un elenco di ID dell'area di lavoro nell'organizzazione.

Se il parametro facoltativo è impostato su data e ora, vengono restituiti solo gli ID delle aree di lavoro modificate dopo tale data.if the optional modifiedSince parameter is set to a date-time, only the ID of workspaces that changed after that date-time are returned. Se il modifiedSince parametro non viene usato, vengono restituiti gli ID di tutte le aree di lavoro dell'organizzazione. L'ora specificata dal modifiedSince parametro deve essere compreso nell'intervallo di 30 minuti (per consentire l'applicazione delle modifiche dell'area di lavoro) a 30 giorni prima dell'ora corrente.

Autorizzazioni

L'utente deve disporre dei diritti di amministratore (ad esempio Microsoft 365 amministratore globale o amministratore del servizio Power BI) o eseguire l'autenticazione tramite un'entità servizio.

Quando viene eseguita con l'autenticazione dell'entità servizio, un'app non deve avere autorizzazioni necessarie per il consenso amministratore per Power BI impostate nel portale di Azure.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Rilevante solo quando si esegue l'autenticazione tramite un token di accesso amministratore delegato standard. Non deve essere presente quando viene usata l'autenticazione tramite un'entità servizio.

Limitazioni

Numero massimo di 30 richieste all'ora.

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}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
excludeInActiveWorkspaces
query

boolean

Indica se escludere aree di lavoro inattive

excludePersonalWorkspaces
query

boolean

Se escludere le aree di lavoro personali

modifiedSince
query

string

date-time

Data dell'ultima modifica (deve essere in formato UTC conforme a ISO 8601)

Risposte

Nome Tipo Descrizione
200 OK

ModifiedWorkspace[]

OK

Esempio

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

Definizioni

ModifiedWorkspace

Area di lavoro modificata

Nome Tipo Descrizione
id

string

ID oggetto area di lavoro