Admin - WorkspaceInfo GetModifiedWorkspaces

  • Ссылка
Service:
Power BI REST APIs
API Version:
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
With optional parameters: 
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

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