Admin - Apps GetAppsAsAdmin

Serviço:: Power BI REST APIs

Versão da API:: v1.0

Retorna uma lista de aplicativos na organização.

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

Permissões

O usuário deve ser um administrador do Fabric 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 quaisquer pré-remissões necessárias de consentimento do administrador para o Power BI definidas 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}

Com parâmetros opcionais:

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 minimum: 1	O número solicitado de aplicativos.
$skip	query		integer minimum: 1	As entradas de número a serem ignoradas.

Respostas

Nome	Tipo	Description
200 OK	AdminApps	OKEY

Exemplos

Example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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 Administrador

AdminApp

Objeto

Nome	Tipo	Description
description	string	A descrição do aplicativo
id	string (uuid)	A ID do aplicativo
lastUpdate	string (date-time)	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