Admin - WorkspaceInfo GetModifiedWorkspaces

Référence

Service:: Power BI REST APIs

Version d'API:: v1.0

Obtient la liste des ID d’espace de travail dans l’organisation.

Si le paramètre facultatif modifiedSince est défini sur une date-heure, seuls les ID des espaces de travail qui ont changé après cette date-heure sont retournés. Si le modifiedSince paramètre n’est pas utilisé, les ID de tous les espaces de travail de l’organisation sont retournés. La date-heure spécifiée par le modifiedSince paramètre doit être comprise entre 30 minutes (pour permettre aux modifications de l’espace de travail de prendre effet) et 30 jours avant l’heure actuelle.

Autorisations

L’utilisateur doit disposer de droits d’administrateur (par exemple, administrateur général Microsoft 365 ou administrateur de service Power BI) ou s’authentifier à l’aide d’un principal de service.

Lors de l’exécution sous l’authentification du principal de service, aucune autorisation d’administrateur requise pour Power BI ne doit être définie sur une application dans le Portail Azure.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Pertinent uniquement lors de l’authentification via un jeton d’accès administrateur délégué standard. Ne doit pas être présent lorsque l’authentification via un principal de service est utilisée.

Limites

Maximum 30 demandes par heure.

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Type	Description
excludeInActiveWorkspaces	query	boolean	Indique s’il faut exclure les espaces de travail inactifs
excludePersonalWorkspaces	query	boolean	Indique s’il faut exclure des espaces de travail personnels
modifiedSince	query	string date-time	Date de la dernière modification (doit être au format UTC conforme à ISO 8601)

Réponses

Nom	Type	Description
200 OK	ModifiedWorkspace[]	OK

Exemples

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

Définitions

ModifiedWorkspace

Un espace de travail modifié

Nom	Type	Description
id	string	ID d’objet de l’espace de travail

Partager via