Groups - Update Group

Service:

Power BI REST APIs

API Version:

v1.0

更新指定的工作區。

權限

此 API 呼叫可由服務主體設定檔呼叫。 如需詳細資訊，請參閱：Power BI Embedded中的服務主體設定檔。

必要範圍

Workspace.ReadWrite.All

限制

• 對於共用容量，只能更新名稱。
• 針對 Premium 容量，只能更新 name 和 defaultDatasetStorageFormat。
• 名稱在組織內必須是唯一的。
  
  

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

URI 參數

名稱	位於	必要	類型	Description
groupId	path	True	string uuid	工作區識別碼

要求本文

名稱	類型	Description
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	群組中的預設資料集儲存格式
name	string	組名

回應

名稱	類型	Description
200 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

定義

名稱	Description
DefaultDatasetStorageFormat	群組中的預設資料集儲存格式
UpdateGroupRequest	群組的更新要求

DefaultDatasetStorageFormat

群組中的預設資料集儲存格式

名稱	類型	Description
Large	string	大型資料集儲存格式
Small	string	小型資料集儲存體格式

UpdateGroupRequest

群組的更新要求

名稱	類型	Description
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	群組中的預設資料集儲存格式
name	string	組名