Groups - Create Group

Service:

Power BI REST APIs

API Version:

v1.0

Crée un espace de travail.

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.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups

With optional parameters:

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2={workspaceV2}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
workspaceV2	query		boolean	(Fonctionnalité en préversion) Indique s’il faut créer un espace de travail. La seule valeur possible est true.

Corps de la demande

Nom	Obligatoire	Type	Description
name	True	string	Nom du groupe nouvellement créé

Réponses

Nom	Type	Description
200 OK	Group	OK

Exemples

Create a workspace example

Example

Create a workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True

Request Body

{
  "name": "sample workspace"
}

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isOnDedicatedCapacity": false,
      "name": "sample workspace"
    }
  ]
}

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups

Request Body

{
  "name": "sample group"
}

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "sample group"
    }
  ]
}

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
GroupCreationRequest	Une demande Power BI pour créer un groupe

AzureResource

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

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

DefaultDatasetStorageFormat

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

Nom	Type	Description
Large	string	Format de stockage des grands jeux de données
Small	string	Format de stockage de petits jeux de données

Group

Un groupe Power BI

Nom	Type	Description
capacityId	string	ID de capacité
dataflowStorageId	string	ID de compte de stockage de flux de données Power BI
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Format de stockage du jeu de données par défaut dans l’espace de travail. Retourné uniquement lorsque isOnDedicatedCapacity est true
id	string	L’ID de l’espace de travail
isOnDedicatedCapacity	boolean	Indique si le groupe est affecté à une capacité dédiée
isReadOnly	boolean	Indique si le groupe est en lecture seule
logAnalyticsWorkspace	AzureResource	Espace de travail Log Analytics affecté au groupe. Cette valeur est retournée uniquement lors de la récupération d’un seul groupe.
name	string	Nom du groupe

GroupCreationRequest

Une demande Power BI pour créer un groupe

Nom	Type	Description
name	string	Nom du groupe nouvellement créé