Capacities - Patch Workload

Service:

Power BI REST APIs

API Version:

v1.0

將特定工作負載的狀態變更為 [已啟用 ] 或 [ 已停用]。 啟用工作負載時，請指定工作負載可取用的最大記憶體百分比。

工作負載 API 與 Gen2 容量無關。

必要範圍

Capacity.ReadWrite.All

PATCH https://api.powerbi.com/v1.0/myorg/capacities/{capacityId}/Workloads/{workloadName}

URI 參數

名稱	位於	必要	類型	Description
capacityId	path	True	string uuid	容量識別碼
workloadName	path	True	string	工作負載的名稱

要求本文

名稱	必要	類型	Description
state	True	WorkloadState	容量工作負載狀態
maxMemoryPercentageSetByUser		integer	工作負載可耗用的最大記憶體百分比 (由使用者)

回應

名稱	類型	Description
200 OK		確定

範例

Example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/capacities/0f084df7-c13d-451b-af5f-ed0c466403b2/Workloads/Dataflows

Request Body

{
  "state": "Enabled",
  "maxMemoryPercentageSetByUser": "66"
}

Sample Response

Status code:

200

定義

名稱	Description
PatchWorkloadRequest	修補程式工作負載設定要求
WorkloadState	容量工作負載狀態

PatchWorkloadRequest

修補程式工作負載設定要求

名稱	類型	Description
maxMemoryPercentageSetByUser	integer	工作負載可耗用的最大記憶體百分比 (由使用者)
state	WorkloadState	容量工作負載狀態

WorkloadState

容量工作負載狀態

名稱	類型	Description
Disabled	string	工作負載已停用
Enabled	string	工作負載已啟用
Unsupported	string	目前的容量 SKU 不支援工作負載，因此無法啟用。 修補程式 工作負載 API 呼叫中的使用者無法設定此值。