Groups - Get Group
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 de en Power BI Embedded.
Ámbito requerido
Workspace.Read.All o Workspace.ReadWrite.All
Limitaciones
- Los permisos de usuario para 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 de Actualizar permisos de usuario.
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
group
|
path | True |
string (uuid) |
Identificador del área de trabajo |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
De acuerdo |
Ejemplos
Example
Solicitud de ejemplo
GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48
Respuesta de muestra
{
"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 |
|---|---|
|
Azure |
Una respuesta que detalla un recurso de Azure propiedad del usuario, como un área de trabajo de Log Analytics. |
|
Default |
Formato de almacenamiento del conjunto de datos predeterminado en el grupo |
| Group |
Un grupo de Power BI |
AzureResource
Una respuesta que detalla un recurso de Azure propiedad del usuario, como un área de trabajo de Log Analytics.
| Nombre | Tipo | Description |
|---|---|---|
| id |
string (uuid) |
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 (uuid) |
La suscripción de Azure donde reside el recurso. |
DefaultDatasetStorageFormat
Formato de almacenamiento del conjunto de datos predeterminado en el grupo
| Valor | Description |
|---|---|
| Small |
Formato de almacenamiento de conjunto de datos pequeño |
| Large |
Formato de almacenamiento de conjuntos de datos de gran tamaño |
Group
Un grupo de Power BI
| Nombre | Tipo | Description |
|---|---|---|
| capacityId |
string (uuid) |
El identificador de capacidad |
| dataflowStorageId |
string (uuid) |
El identificador de la cuenta de almacenamiento de flujo de datos de Power BI |
| defaultDatasetStorageFormat |
Formato de almacenamiento del conjunto de datos predeterminado en el área de trabajo. Se devuelve solo cuando se |
|
| id |
string (uuid) |
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 |
Área de trabajo de Log Analytics asignada al grupo. Solo se devuelve cuando se recupera un único grupo. |
|
| name |
string |
Nombre del grupo |