Admin - WorkspaceInfo GetModifiedWorkspaces

服务:: Power BI REST APIs

API 版本:: v1.0

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

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

权限

用户必须是 Fabric 管理员或使用服务主体进行身份验证。

在服务主体身份验证下运行时，应用不得在 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[]	还行

示例

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