Groups - Update Group

更新指定的工作区。

Permissions

此 API 调用可由服务主体配置文件调用。 有关详细信息,请参阅: Power BI Embedded 中的服务主体配置文件。

所需范围

Workspace.ReadWrite.All

局限性

  • 对于共享容量,只能更新名称。
  • 对于高级容量,只能更新名称和 defaultDatasetStorageFormat。
  • 名称在组织内必须是唯一的。

PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}

URI 参数

名称 在 必需 类型 说明
groupId
path True

string (uuid)

工作区 ID

请求正文

名称 类型 说明
defaultDatasetStorageFormat

DefaultDatasetStorageFormat

组中的默认数据集存储格式

name

string

组名称

响应

名称 类型 说明
200 OK

好的

示例

Example

示例请求

PATCH https://api.powerbi.com/v1.0/myorg/groups/e2284830-c8dc-416b-b19a-8cdcd2729332
{
  "name": "Updated Sales Results",
  "defaultDatasetStorageFormat": "Large"
}

示例响应

定义

名称 说明
DefaultDatasetStorageFormat

组中的默认数据集存储格式

UpdateGroupRequest

组的更新请求

DefaultDatasetStorageFormat

组中的默认数据集存储格式

值 说明
Small

小型数据集存储格式

Large

大型数据集存储格式

UpdateGroupRequest

组的更新请求

名称 类型 说明
defaultDatasetStorageFormat

DefaultDatasetStorageFormat

组中的默认数据集存储格式

name

string

组名称