Groups - Get Group

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Retorna um workspace especificado.

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.Read.All ou Workspace.ReadWrite.All

Limitações

As permissões de usuário para workspaces levam tempo para serem atualizadas e podem não estar disponíveis imediatamente ao usar chamadas à API. Para atualizar as permissões do usuário, use a chamada Atualizar Permissões de Usuário API.

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
groupId	path	True	string (uuid)	A ID do workspace

Respostas

Nome	Tipo	Description
200 OK	Group	OKEY

Exemplos

Example

Solicitação de exemplo

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48

Resposta de exemplo

Código de status:: 200

{
  "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
  "isReadOnly": false,
  "isOnDedicatedCapacity": true,
  "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
  "defaultDatasetStorageFormat": "Small",
  "name": "Sample Group 1"
}

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

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