Groups - Update Group

Service:

Power BI REST APIs

API Version:

v1.0

汇报指定的工作区。

权限

此 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		OK

示例

Example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/groups/e2284830-c8dc-416b-b19a-8cdcd2729332

Request Body

{
  "name": "Updated Sales Results",
  "defaultDatasetStorageFormat": "Large"
}

Sample Response

Status code:

200

定义

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

DefaultDatasetStorageFormat

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

名称	类型	说明
Large	string	大型数据集存储格式
Small	string	小型数据集存储格式

UpdateGroupRequest

组的更新请求

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