Admin - WorkspaceInfo GetModifiedWorkspaces

  • 参考
Service:
Power BI REST APIs
API Version:
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
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

上次修改日期 (必须采用符合 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