Partager via

Groups - Create Group

Service:
Power BI REST APIs
Version d'API:
v1.0

Crée un espace de travail.

Autorisations

Étendue requise

Workspace.ReadWrite.All 

POST https://api.powerbi.com/v1.0/myorg/groups
Avec des paramètres facultatifs: 
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 prise en charge 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

D’ACCORD

Exemples

Create a workspace example
Example

Create a workspace example

Exemple de requête

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True
Corps de la demande
{
  "name": "sample workspace"
}

Exemple de réponse

Code d’état:
200 
{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isOnDedicatedCapacity": false,
      "name": "sample workspace"
    }
  ]
}

Example

Exemple de requête

POST https://api.powerbi.com/v1.0/myorg/groups
Corps de la demande
{
  "name": "sample group"
}

Exemple de réponse

Code d’état:
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

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

Object

Un groupe Power BI

Nom Type Description
capacityId

string (uuid)

ID de capacité
dataflowStorageId

string (uuid)

ID du compte de stockage de flux de données Power BI
defaultDatasetStorageFormat

DefaultDatasetStorageFormat

Format de stockage de jeu de données par défaut dans l’espace de travail. Retourné uniquement lorsque isOnDedicatedCapacity est true
id

string (uuid)

Identifiant 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 opération est retournée uniquement lors de la récupération d’un seul groupe.
name

string

Nom du groupe

GroupCreationRequest

Object

Une demande Power BI pour créer un groupe

Nom Type Description
name

string

Nom du groupe nouvellement créé