Admin - WorkspaceInfo GetModifiedWorkspaces

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 d’espaces de travail modifiés 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. L’heure de date 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) de 30 jours avant l’heure actuelle.

Permissions

L’utilisateur doit être un administrateur Fabric ou s’authentifier à l’aide d’un principal de service.

Lors de l’exécution sous l’authentification du principal de service, une application ne doit pas disposer d’autorisations requises par l’administrateur pour Power BI définie sur celle-ci dans le portail Azure.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Applicable 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 requêtes 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 des espaces de travail inactifs
excludePersonalWorkspaces	query	boolean	Indique s’il faut exclure des espaces de travail personnels
modifiedSince	query	string (date-time)	Date de dernière modification (doit être au format UTC conforme ISO 8601)

Réponses

Nom	Type	Description
200 OK	ModifiedWorkspace[]	Ok

Exemples

Example

Exemple de requête

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince=2020-10-02T05:51:30.0000000Z&excludePersonalWorkspaces=True&excludeInActiveWorkspaces=True

Exemple de réponse

Code d’état:: 200

[
  {
    "id": "3740504d-1f93-42f9-8e9d-c8ba9b787a3b"
  },
  {
    "id": "19cb346c-9839-4e19-81e6-76364d0b836f"
  }
]

Définitions

ModifiedWorkspace

Object

Un espace de travail modifié

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

Partager via