Admin - Dashboards GetDashboardsAsAdmin

Servicio:: Power BI REST APIs

Versión de la API:: v1.0

Devuelve una lista de paneles de la organización.

Permisos

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 las premisiones necesarias de consentimiento del administrador para Power BI establecidas 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 50 solicitudes por hora o 5 solicitudes por minuto, por inquilino.

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Tipo	Description
$expand	query	string	Acepta una lista separada por comas de tipos de datos, que se expandirá en línea en la respuesta. Admite `tiles`.
$filter	query	string	Devuelve un subconjunto de resultados basado en condición de parámetro de consulta de filtro 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	De acuerdo

Ejemplos

Example

Solicitud de ejemplo

GET https://api.powerbi.com/v1.0/myorg/admin/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",
      "isReadOnly": false,
      "workspaceId": "abfbdc89-2659-43c1-9142-93e8378eac96"
    }
  ]
}

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 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 la información de suscripción de un informe de Power BI mediante el Obtener suscripciones de informe como llamada API de 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 api de api de de administración Obtener usuarios del panel o la llamada API de PostWorkspaceInfo con el 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.