Поделиться через

Admin - WorkspaceInfo GetModifiedWorkspaces

Служба:
Power BI REST APIs
Версия API:
v1.0

Возвращает список идентификаторов рабочих областей в организации.

Если необязательный параметр modifiedSince имеет значение даты и времени, возвращаются только идентификаторы рабочих областей, которые изменились после этого даты. Если параметр modifiedSince не используется, возвращаются идентификаторы всех рабочих областей в организации. Время даты, указанное параметром modifiedSince, должно находиться в диапазоне от 30 минут (чтобы изменения рабочей области вступили в силу) до 30 дней до текущего времени.

Разрешения

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

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

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

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

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

Ограничения

Не более 30 запросов в час. 

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified
С использованием необязательных параметров: 
GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

Параметры URI

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

boolean

Исключение неактивных рабочих областей
excludePersonalWorkspaces
 query

boolean

Исключение личных рабочих областей
modifiedSince
 query

string (date-time)

Дата последнего изменения (должна быть в формате UTC, совместимом с ISO 8601)

Ответы

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

ModifiedWorkspace[]

ХОРОШО

Примеры

Example

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

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince=2020-10-02T05:51:30.0000000Z&excludePersonalWorkspaces=True&excludeInActiveWorkspaces=True

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

Код состояния:
200 
[
  {
    "id": "3740504d-1f93-42f9-8e9d-c8ba9b787a3b"
  },
  {
    "id": "19cb346c-9839-4e19-81e6-76364d0b836f"
  }
]

Определения

ModifiedWorkspace

Object

Измененная рабочая область

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

string (uuid)

Идентификатор объекта рабочей области