Admin - Dashboards GetDashboardsInGroupAsAdmin

Servicio:: Power BI REST APIs

Versión de la API:: v1.0

Devuelve una lista de paneles del área de trabajo especificada.

Permissions

El usuario debe ser un administrador de Fabric o autenticarse mediante una entidad de servicio.
Se admiten permisos delegados.

Cuando se ejecuta en la autenticación prinicipal del servicio, una aplicación no debe tener ninguna premisión necesaria de consentimiento del administrador para Power BI establecida en él en Azure Portal.

Ámbito requerido

Tenant.Read.All o Tenant.ReadWrite.All

Solo es relevante al autenticarse a través de un token de acceso de administrador delegado estándar. No debe estar presente cuando se usa la autenticación a través de una entidad de servicio.

Limitaciones

Máximo de 200 solicitudes por hora.

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

Con parámetros opcionales:

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/dashboards?$filter={$filter}&$top={$top}&$skip={$skip}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
groupId	path	True	string (uuid)	Identificador del área de trabajo
$filter	query		string	Devuelve un subconjunto de resultados basado en la condición de parámetro de consulta de filtro de Odata .
$skip	query		integer (int32)	Omite los primeros n resultados
$top	query		integer (int32)	Devuelve solo los primeros n resultados.

Respuestas

Nombre	Tipo	Description
200 OK	AdminDashboards	OK

Ejemplos

Example

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "displayName": "SalesMarketing",
      "embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false
    }
  ]
}

Definiciones

Nombre	Description
AdminDashboard	Un panel de Power BI devuelto por las API de administración. La API devuelve un subconjunto de la siguiente lista de propiedades del panel. El subconjunto depende de la API denominada, los permisos del autor de la llamada y la disponibilidad de los datos en la base de datos de Power BI.
AdminDashboards	Contenedor de respuesta de OData para una colección de paneles de Power BI
AdminTile	Un icono de Power BI devuelto por las API de administración.
DashboardUser	Una entrada adecuada de acceso de usuario de Power BI para un panel
DashboardUserAccessRight	Derecho de acceso que el usuario tiene para el panel (nivel de permiso)
PrincipalType	El tipo de entidad de seguridad
ServicePrincipalProfile	Un perfil de entidad de servicio de Power BI. Solo es relevante para la solución multiinquilino de Power BI Embedded.
Subscription	Una suscripción de correo electrónico para un elemento de Power BI (por ejemplo, un informe o un panel)
SubscriptionUser	Un usuario de suscripción de correo electrónico de Power BI

AdminDashboard

Object

Un panel de Power BI devuelto por las API de administración. La API devuelve un subconjunto de la siguiente lista de propiedades del panel. El subconjunto depende de la API denominada, los permisos del autor de la llamada y la disponibilidad de los datos en la base de datos de Power BI.

Nombre	Tipo	Description
appId	string	El identificador de la aplicación, devuelto solo si el panel pertenece a una aplicación
displayName	string	Nombre para mostrar del panel
embedUrl	string	Dirección URL de inserción del panel
id	string (uuid)	Identificador del panel
isReadOnly	boolean	Si el panel es de solo lectura
subscriptions	Subscription[]	(Valor vacío) Los detalles de la suscripción de un elemento de Power BI (por ejemplo, un informe o un panel). Esta propiedad se quitará de la respuesta de carga en una próxima versión. Puede recuperar información de suscripción para un informe de Power BI mediante la llamada a la API obtener informes como administrador .
tiles	AdminTile[]	Iconos que pertenecen al panel
users	DashboardUser[]	(Valor vacío) Detalles de acceso del usuario del panel. Esta propiedad se quitará de la respuesta de carga en una próxima versión. Puede recuperar información de usuario en un panel de Power BI mediante la llamada Get Dashboard Users as Admin API o postWorkspaceInfo API con el `getArtifactUsers` parámetro .
webUrl	string	Dirección URL web del panel
workspaceId	string (uuid)	Identificador del área de trabajo (GUID) del panel. Esta propiedad solo se devolverá en GetDashboardsAsAdmin.