Compartir a través de

Groups - Create Group

Servicio:
Power BI REST APIs
Versión de la API:
v1.0

Crea una nueva área de trabajo.

Permisos

Ámbito requerido

Workspace.ReadWrite.All 

POST https://api.powerbi.com/v1.0/myorg/groups
Con parámetros opcionales: 
POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2={workspaceV2}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
workspaceV2
 query

boolean

(Característica de versión preliminar) Si se va a crear un área de trabajo. El único valor admitido es true.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
name True

string

Nombre del grupo recién creado

Respuestas

Nombre Tipo Description
200 OK

Group

De acuerdo

Ejemplos

Create a workspace example
Example

Create a workspace example

Solicitud de ejemplo

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

Respuesta de muestra

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

Example

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
AzureResource

Una respuesta que detalla un recurso de Azure propiedad del usuario, como un área de trabajo de Log Analytics.
DefaultDatasetStorageFormat

Formato de almacenamiento del conjunto de datos predeterminado en el grupo
Group

Un grupo de Power BI
GroupCreationRequest

Una solicitud de Power BI para crear un nuevo grupo

AzureResource

Object

Una respuesta que detalla un recurso de Azure propiedad del usuario, como un área de trabajo de Log Analytics.

Nombre Tipo Description
id

string (uuid)

Identificador del recurso en Power BI.
resourceGroup

string

Grupo de recursos dentro de la suscripción donde reside el recurso.
resourceName

string

Nombre del recurso.
subscriptionId

string (uuid)

La suscripción de Azure donde reside el recurso.

DefaultDatasetStorageFormat

Enumeración

Formato de almacenamiento del conjunto de datos predeterminado en el grupo

Valor Description
Small

Formato de almacenamiento de conjunto de datos pequeño
Large

Formato de almacenamiento de conjuntos de datos de gran tamaño

Group

Object

Un grupo de Power BI

Nombre Tipo Description
capacityId

string (uuid)

El identificador de capacidad
dataflowStorageId

string (uuid)

El identificador de la cuenta de almacenamiento de flujo de datos de Power BI
defaultDatasetStorageFormat

DefaultDatasetStorageFormat

Formato de almacenamiento del conjunto de datos predeterminado en el área de trabajo. Se devuelve solo cuando se isOnDedicatedCapacitytrue
id

string (uuid)

Identificador del área de trabajo
isOnDedicatedCapacity

boolean

Si el grupo está asignado a una capacidad dedicada
isReadOnly

boolean

Si el grupo es de solo lectura
logAnalyticsWorkspace

AzureResource

Área de trabajo de Log Analytics asignada al grupo. Solo se devuelve cuando se recupera un único grupo.
name

string

Nombre del grupo

GroupCreationRequest

Object

Una solicitud de Power BI para crear un nuevo grupo

Nombre Tipo Description
name

string

Nombre del grupo recién creado