Partager via


Groups - Create Group

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
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
{
  "name": "sample workspace"
}

Sample Response

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

Example

Sample Request

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

Sample Response

{
  "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éé