Groups - Create Group

Service:

Power BI REST APIs

API Version:

v1.0

Crea una nueva área de trabajo.

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.

Ámbito requerido

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}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
workspaceV2	query		boolean	(Característica en 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	Aceptar

Ejemplos

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"
    }
  ]
}

Definiciones

Nombre	Description
AzureResource	Respuesta que detalla un recurso de Azure propiedad del usuario, como un área de trabajo de Log Analytics.
DefaultDatasetStorageFormat	El 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

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

Nombre	Tipo	Description
id	string	Identificador del recurso en Power BI.
resourceGroup	string	El grupo de recursos dentro de la suscripción donde reside el recurso.
resourceName	string	Nombre del recurso.
subscriptionId	string	La suscripción de Azure donde reside el recurso.

DefaultDatasetStorageFormat

El formato de almacenamiento del conjunto de datos predeterminado en el grupo

Nombre	Tipo	Description
Large	string	Formato de almacenamiento de conjunto de datos de gran tamaño
Small	string	Formato de almacenamiento de conjunto de datos pequeño

Group

Un grupo de Power BI

Nombre	Tipo	Description
capacityId	string	Identificador de capacidad
dataflowStorageId	string	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. Solo se devuelve cuando isOnDedicatedCapacity es true
id	string	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	El nombre del grupo

GroupCreationRequest

Una solicitud de Power BI para crear un nuevo grupo

Nombre	Tipo	Description
name	string	Nombre del grupo recién creado.