Compartilhar via


Groups - Create Group

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

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