Groups - Get Group

Service:: Power BI REST APIs

Version d'API:: v1.0

Retourne un espace de travail spécifié.

Autorisations

Cet appel d’API peut être appelé par un profil de principal de service. Pour plus d’informations, consultez : profils de principal de service dans Power BI Embedded.

Étendue requise

Workspace.Read.All ou Workspace.ReadWrite.All

Limites

Les autorisations utilisateur pour les espaces de travail prennent du temps pour être mis à jour et peuvent ne pas être immédiatement disponibles lors de l’utilisation d’appels d’API. Pour actualiser les autorisations utilisateur, utilisez l'Actualiser les autorisations utilisateur appel d’API.

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
groupId	path	True	string (uuid)	Identifiant de l’espace de travail

Réponses

Nom	Type	Description
200 OK	Group	D’ACCORD

Exemples

Example

Exemple de requête

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48

Exemple de réponse

Code d’état:: 200

{
  "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
  "isReadOnly": false,
  "isOnDedicatedCapacity": true,
  "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
  "defaultDatasetStorageFormat": "Small",
  "name": "Sample Group 1"
}

Définitions

Nom	Description
AzureResource	Réponse détaillant une ressource Azure appartenant à l’utilisateur, telle qu’un espace de travail Log Analytics.
DefaultDatasetStorageFormat	Format de stockage du jeu de données par défaut dans le groupe
Group	Un groupe Power BI

AzureResource

Object

Réponse détaillant une ressource Azure appartenant à l’utilisateur, telle qu’un espace de travail Log Analytics.

Nom	Type	Description
id	string (uuid)	Identificateur de la ressource dans Power BI.
resourceGroup	string	Groupe de ressources dans l’abonnement où réside la ressource.
resourceName	string	Nom de la ressource.
subscriptionId	string (uuid)	Abonnement Azure où réside la ressource.

DefaultDatasetStorageFormat

Énumération

Format de stockage du jeu de données par défaut dans le groupe

Valeur	Description
Small	Format de stockage de petits jeux de données
Large	Format de stockage de jeux de données volumineux

Group