Partilhar via

Groups - Create Group

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Cria um novo workspace.

Permissões

Escopo necessário

Workspace.ReadWrite.All 

POST https://api.powerbi.com/v1.0/myorg/groups
Com parâmetros opcionais: 
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 você deve 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

OKEY

Exemplos

Create a workspace example
Example

Create a workspace example

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True
Corpo da solicitação
{
  "name": "sample workspace"
}

Resposta de exemplo

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

Example

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/groups
Corpo da solicitação
{
  "name": "sample group"
}

Resposta de exemplo

Código de status:
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

Objeto

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

Nome Tipo Description
id

string (uuid)

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 (uuid)

A assinatura do Azure na qual o recurso reside.

DefaultDatasetStorageFormat

Enumeração

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

Valor Description
Small

Formato de armazenamento de conjunto de dados pequeno
Large

Formato de armazenamento de conjunto de dados grande

Group

Objeto

Um grupo do Power BI

Nome Tipo Description
capacityId

string (uuid)

A ID da capacidade
dataflowStorageId

string (uuid)

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 (uuid)

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

Objeto

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

Nome Tipo Description
name

string

O nome do grupo recém-criado