Admin - Dashboards GetDashboardsAsAdmin

Referencia

Service:: Power BI REST APIs

API Version:: v1.0

Devuelve una lista de paneles de la organización.

Permisos

El usuario debe tener derechos de administrador (como Office 365 administrador global o administrador del servicio Power BI) o autenticarse mediante una entidad de servicio.
Se admiten permisos delegados.

Cuando se ejecuta con la autenticación prinicipal del servicio, una aplicación no debe tener ninguna premisión necesaria para el consentimiento del administrador para Power BI establecida en él en el 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

With optional parameters:

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án en línea en la respuesta. admite `tiles`.
$filter	query	string	Filtra los resultados, en función de una condición booleana.
$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	Aceptar

Ejemplos

Example

Sample Request

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

Sample Response

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 Administración API. La API devuelve un subconjunto de la siguiente lista de propiedades del panel. El subconjunto depende de la API llamada, los permisos del autor de la llamada y la disponibilidad de 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	Icono de Power BI devuelto por Administración API.
DashboardUser	Una entrada correcta de acceso de usuario de Power BI para un panel
DashboardUserAccessRight	Derecho de acceso que tiene el usuario para el panel (nivel de permiso)
PrincipalType	El tipo de entidad de seguridad
ServicePrincipalProfile	Un perfil principal de servicio Power BI. Solo es relevante para Power BI Embedded solución multiinquilino.
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

Un panel de Power BI devuelto por Administración API. La API devuelve un subconjunto de la siguiente lista de propiedades del panel. El subconjunto depende de la API llamada, los permisos del autor de la llamada y la disponibilidad de 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	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 suscripciones de informes como Administración.
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 a la API Obtener usuarios del panel como Administración o la llamada API postWorkspaceInfo con el `getArtifactUsers` parámetro .
webUrl	string	Dirección URL web del panel
workspaceId	string	Identificador del área de trabajo (GUID) del panel. Esta propiedad solo se devolverá en GetDashboardsAsAdmin.