Partager via

Groups - Create Group

  • Référence
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éé