Groups - Update Group
更新指定的工作區。
權限
此 API 呼叫可由服務主體設定檔呼叫。 如需詳細資訊，請參閱： Power BI Embedded 中的服務主體設定檔。
必要範圍
Workspace.ReadWrite.All
局限性
- 對於共用容量，只能更新名稱。
- 針對進階容量，只能更新名稱和 defaultDatasetStorageFormat。
- 名稱在組織內必須是唯一的。
PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
group
|
path | True |
string (uuid) |
工作區識別碼 |
要求本文
| 名稱 | 類型 | Description |
|---|---|---|
| defaultDatasetStorageFormat |
群組中的預設資料集儲存格式 |
|
| name |
string |
群組名稱 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
OK |
範例
Example
範例要求
PATCH https://api.powerbi.com/v1.0/myorg/groups/e2284830-c8dc-416b-b19a-8cdcd2729332{
"name": "Updated Sales Results",
"defaultDatasetStorageFormat": "Large"
}範例回覆
定義
| 名稱 | Description |
|---|---|
|
Default |
群組中的預設資料集儲存格式 |
|
Update |
群組的更新要求 |
DefaultDatasetStorageFormat
群組中的預設資料集儲存格式
| 值 | Description |
|---|---|
| Small |
小型資料集儲存格式 |
| Large |
大型資料集儲存格式 |
UpdateGroupRequest
群組的更新要求
| 名稱 | 類型 | Description |
|---|---|---|
| defaultDatasetStorageFormat |
群組中的預設資料集儲存格式 |
|
| name |
string |
群組名稱 |