Groups - Get Group

Referência

Service:: Power BI REST APIs

API Version:: 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 de usuário, use a chamada à API Atualizar Permissões de Usuário .

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	OK

Exemplos

Example

Sample Request

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

Sample Response

Status code:: 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

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 do 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

Share via