Admin - WorkspaceInfo GetModifiedWorkspaces

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

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

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

Parametri dell'URI

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

Status code:: 200

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

Share via