Groups - Get Group

Servicio:

Power BI REST APIs

Versión de la API:

v1.0

Devuelve un área de trabajo especificada.

Permisos

Un perfil de entidad de servicio puede llamar a esta llamada API. Para obtener más información, consulte: Perfiles de entidad de servicio en Power BI Embedded.

Ámbito requerido

Workspace.Read.All o Workspace.ReadWrite.All

Limitaciones

• Los permisos de usuario de las áreas de trabajo tardan tiempo en actualizarse y es posible que no estén disponibles inmediatamente al usar llamadas API. Para actualizar los permisos de usuario, use la llamada API Actualizar permisos de usuario .
  
  

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
groupId	path	True	string uuid	Identificador del área de trabajo

Respuestas

Nombre	Tipo	Description
200 OK	Group	Aceptar

Ejemplos

Example

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre	Description
AzureResource	Respuesta que detalla un recurso de Azure propiedad del usuario, como un área de trabajo de Log Analytics.
DefaultDatasetStorageFormat	Formato de almacenamiento del conjunto de datos predeterminado en el grupo
Group	Un grupo de Power BI

AzureResource

Respuesta que detalla un recurso de Azure propiedad del usuario, como un área de trabajo de Log Analytics.

Nombre	Tipo	Description
id	string	Identificador del recurso en Power BI.
resourceGroup	string	Grupo de recursos dentro de la suscripción donde reside el recurso.
resourceName	string	Nombre del recurso.
subscriptionId	string	La suscripción de Azure donde reside el recurso.

DefaultDatasetStorageFormat

Formato de almacenamiento del conjunto de datos predeterminado en el grupo

Nombre	Tipo	Description
Large	string	Formato de almacenamiento de conjunto de datos de gran tamaño
Small	string	Formato de almacenamiento de conjunto de datos pequeño

Group

Un grupo de Power BI

Nombre	Tipo	Description
capacityId	string	El identificador de capacidad
dataflowStorageId	string	Identificador de la cuenta de almacenamiento de flujo de datos de Power BI
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Formato de almacenamiento del conjunto de datos predeterminado en el área de trabajo. Solo se devuelve cuando isOnDedicatedCapacity es true
id	string	Identificador del área de trabajo
isOnDedicatedCapacity	boolean	Si el grupo está asignado a una capacidad dedicada
isReadOnly	boolean	Si el grupo es de solo lectura
logAnalyticsWorkspace	AzureResource	Área de trabajo de Log Analytics asignada al grupo. Solo se devuelve cuando se recupera un único grupo.
name	string	Nombre del grupo