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

AdminApps

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
AdminApp
AdminApps

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

AdminApp[]

Lista de aplicaciones instaladas