Admin - Apps GetAppsAsAdmin

Servicio:: Power BI REST APIs

Versión de la API:: v1.0

Devuelve una lista de aplicaciones de la organización.

Se requiere el parámetro de consulta $top.

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/apps?$top={$top}

Con parámetros opcionales:

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 minimum: 1	Número solicitado de aplicaciones.
$skip	query		integer minimum: 1	Número de entradas que se van a omitir.

Respuestas

Nombre	Tipo	Description
200 OK	AdminApps	OK

Ejemplos

Example

Solicitud de ejemplo

GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top=10

Respuesta de muestra

status code:: 200

{
  "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
AdminApp
AdminApps	Contenedor de respuesta de OData para obtener una lista de aplicaciones instaladas de Power BI para las API de administración

AdminApp

Object

Nombre	Tipo	Description
description	string	Descripción de la aplicación
id	string (uuid)	El identificador de la aplicación
lastUpdate	string (date-time)	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