Admin - WorkspaceInfo GetModifiedWorkspaces

Ссылка

Служба:: Power BI REST APIs

Версия API:: v1.0

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

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

Разрешения

Пользователь должен иметь права администратора (например, Майкрософт 365 глобальный администратор или администратор службы Power BI) или пройти проверку подлинности с помощью субъекта-службы.

При выполнении проверки подлинности субъекта-службы приложение не должно иметь необходимых разрешений с согласием администратора для 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

Sample request

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

Sample response

Status code:: 200

[
  {
    "id": "3740504d-1f93-42f9-8e9d-c8ba9b787a3b"
  },
  {
    "id": "19cb346c-9839-4e19-81e6-76364d0b836f"
  }
]

Определения

ModifiedWorkspace

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

Имя	Тип	Описание
id	string	Идентификатор объекта рабочей области

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