Groups - Update Group

服务:

Power BI REST APIs

API 版本:

v1.0

更新指定的工作区。

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"
}

示例响应

状态代码:

200

定义

名称	说明
DefaultDatasetStorageFormat	组中的默认数据集存储格式
UpdateGroupRequest	组的更新请求

DefaultDatasetStorageFormat

枚举

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

值	说明
Small	小型数据集存储格式
Large	大型数据集存储格式

UpdateGroupRequest

Object

组的更新请求

名称	类型	说明
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	组中的默认数据集存储格式
name	string	组名称