Admin - Apps GetAppsAsAdmin

Referência

Service:: Power BI REST APIs

API Version:: v1.0

Retorna uma lista de aplicativos na organização.

O parâmetro de consulta $top é necessário.

Permissões

O usuário deve ter direitos de administrador (como Office 365 Administrador Global ou Administrador de Serviços do Power BI) ou autenticar usando uma entidade de serviço.
Há suporte para permissões delegadas.

Ao executar em autenticação prinicipal de serviço, um aplicativo não deve ter nenhuma pré-solicitação de consentimento de administrador necessária para o Power BI definida nele no portal do Azure.

Escopo necessário

Tenant.Read.All ou Tenant.ReadWrite.All

Relevante somente ao autenticar por meio de um token de acesso de administrador delegado padrão. Não deve estar presente quando a autenticação por meio de uma entidade de serviço é usada.

Limitações

Máximo de 200 solicitações por hora.

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

With optional parameters:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
$top	query	True	integer	O número solicitado de aplicativos.
$skip	query		integer	As entradas de número a serem ignoradas.

Respostas

Nome	Tipo	Description
200 OK	AdminApps	OK

Exemplos

Example

Sample Request

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

Sample Response

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"
    }
  ]
}

Definições

Nome	Description
AdminApp
AdminApps	O wrapper de resposta OData para uma lista de aplicativos instalados do Power BI para APIs de Administração

AdminApp

Nome	Tipo	Description
description	string	A descrição do aplicativo
id	string	A ID do aplicativo
lastUpdate	string	A data e a hora em que o aplicativo foi atualizado pela última vez
name	string	O nome do aplicativo
publishedBy	string	O editor de aplicativos
workspaceId	string	Workspace associado para o aplicativo

AdminApps

O wrapper de resposta OData para uma lista de aplicativos instalados do Power BI para APIs de Administração

Nome	Tipo	Description
odata.context	string	Contexto OData
value	AdminApp[]	A lista de aplicativos instalados

Share via