Admin - Apps GetAppsAsAdmin
Devuelve una lista de aplicaciones de la organización.
Se requiere el parámetro de consulta $top.
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 200 solicitudes por hora.
GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top={$top}
GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top={$top}&$skip={$skip}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
$top
|
query | True |
integer |
Número solicitado de aplicaciones. |
$skip
|
query |
integer |
Entradas numéricas que se van a omitir. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
Ejemplos
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top=10
Sample Response
{
"value": [
{
"id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
"description": "The finance app",
"name": "Finance",
"publishedBy": "Bill",
"lastUpdate": "2019-01-13T09:46:53.094+02:00"
},
{
"id": "3d9b93c6-7b6d-4801-a491-1738910904fd",
"description": "The marketing app",
"name": "Marketing",
"publishedBy": "Ben",
"lastUpdate": "2018-11-13T09:46:53.094+02:00"
}
]
}
Definiciones
Nombre | Description |
---|---|
Admin |
|
Admin |
Contenedor de respuesta de OData para obtener una lista de aplicaciones instaladas de Power BI para Administración API |
AdminApp
Nombre | Tipo | Description |
---|---|---|
description |
string |
Descripción de la aplicación |
id |
string |
El identificador de la aplicación |
lastUpdate |
string |
Fecha y hora en que se actualizó la aplicación por última vez |
name |
string |
El nombre de la aplicación |
publishedBy |
string |
Publicador de la aplicación |
workspaceId |
string |
Área de trabajo asociada para la aplicación |
AdminApps
Contenedor de respuesta de OData para obtener una lista de aplicaciones instaladas de Power BI para Administración API
Nombre | Tipo | Description |
---|---|---|
odata.context |
string |
Contexto de OData |
value |
Admin |
Lista de aplicaciones instaladas |