通过

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