Groups - Create Group

Service:

Power BI REST APIs

API Version:

v1.0

Cria um workspace.

Permissões

Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.

Escopo necessário

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 URI

Nome	Em	Obrigatório	Tipo	Description
workspaceV2	query		boolean	(Recurso de visualização) Se deseja criar um workspace. O único valor com suporte é true.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
name	True	string	O nome do grupo recém-criado

Respostas

Nome	Tipo	Description
200 OK	Group	OK

Exemplos

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

Definições

Nome	Description
AzureResource	Uma resposta detalhando um recurso do Azure de propriedade do usuário, como um workspace do Log Analytics.
DefaultDatasetStorageFormat	O formato de armazenamento do conjunto de dados padrão no grupo
Group	Um grupo do Power BI
GroupCreationRequest	Uma solicitação do Power BI para criar um novo grupo

AzureResource

Uma resposta detalhando um recurso do Azure de propriedade do usuário, como um workspace do Log Analytics.

Nome	Tipo	Description
id	string	Um identificador para o recurso no Power BI.
resourceGroup	string	O grupo de recursos dentro da assinatura em que o recurso reside.
resourceName	string	O nome do recurso.
subscriptionId	string	A assinatura do Azure em que o recurso reside.

DefaultDatasetStorageFormat

O formato de armazenamento do conjunto de dados padrão no grupo

Nome	Tipo	Description
Large	string	Formato de armazenamento de conjunto de dados grande
Small	string	Formato de armazenamento de conjunto de dados pequeno

Group

Um grupo do Power BI

Nome	Tipo	Description
capacityId	string	A ID da capacidade
dataflowStorageId	string	A ID da conta de armazenamento de fluxo de dados do Power BI
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	O formato de armazenamento do conjunto de dados padrão no workspace. Retornado somente quando isOnDedicatedCapacity é true
id	string	A ID do workspace
isOnDedicatedCapacity	boolean	Se o grupo é atribuído a uma capacidade dedicada
isReadOnly	boolean	Se o grupo é somente leitura
logAnalyticsWorkspace	AzureResource	O workspace do Log Analytics atribuído ao grupo. Isso é retornado somente ao recuperar um único grupo.
name	string	O nome do grupo

GroupCreationRequest

Uma solicitação do Power BI para criar um novo grupo

Nome	Tipo	Description
name	string	O nome do grupo recém-criado