Admin - WorkspaceInfo GetModifiedWorkspaces

参考

服务:: Power BI REST APIs

API 版本:: v1.0

获取组织中的工作区 ID 列表。

如果可选 modifiedSince 参数设置为日期时间，则仅返回在该日期时间之后更改的工作区的 ID。 modifiedSince如果未使用参数，则返回组织中所有工作区的 ID。参数指定的 modifiedSince 日期时间必须在 30 分钟 (范围内，以便工作区更改在当前时间前 30 天) 生效。

权限

用户必须具有管理员权限 (，例如 Microsoft 365 全局管理员或 Power BI 服务管理员) 或使用服务主体进行身份验证。

在服务主体身份验证下运行时，应用不得在Azure 门户中为其设置任何管理员同意所需的 Power BI 权限。

必需范围

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	上次修改日期 (必须采用符合 ISO 8601 的 UTC 格式)

响应

名称	类型	说明
200 OK	ModifiedWorkspace[]	OK

示例

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	工作区对象 ID

通过