Admin - Apps GetAppsAsAdmin

Возвращает список приложений в организации.

Обязательный параметр запроса $top.

Permissions

  • Пользователь должен быть администратором Fabric или пройти проверку подлинности с помощью субъекта-службы.
  • Поддерживаются делегированные разрешения.

При выполнении при предварительной проверке подлинности службы приложение не должно иметь необходимых разрешений администратора для Power BI, установленных на портале Azure.

Требуемая область

Tenant.Read.All или Tenant.ReadWrite.All

Важно только при проверке подлинности через стандартный делегированный маркер доступа администратора. Не должно присутствовать при использовании проверки подлинности через субъект-службу.

Ограничения

Максимум 200 запросов в час.

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}

Параметры URI

Имя В Обязательно Тип Описание
$top
query True

integer

minimum: 1

Запрошенный номер приложений.

$skip
query

integer

minimum: 1

Число записей, которые необходимо пропустить.

Ответы

Имя Тип Описание
200 OK

AdminApps

ХОРОШО

Примеры

Example

Образец запроса

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

Пример ответа

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

Определения

Имя Описание
AdminApp
AdminApps

Оболочка ответа OData для списка установленных приложений Power BI для API администрирования

AdminApp

Имя Тип Описание
description

string

Описание приложения

id

string (uuid)

Идентификатор приложения

lastUpdate

string (date-time)

Дата и время последнего обновления приложения

name

string

Имя приложения

publishedBy

string

Издатель приложения

workspaceId

string

Связанная рабочая область для приложения

AdminApps

Оболочка ответа OData для списка установленных приложений Power BI для API администрирования

Имя Тип Описание
@odata.context

string

Контекст OData

value

AdminApp[]

Список установленных приложений