Groups - Create Group

  • Referência
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