Capacities - Patch Workload

服务:

Power BI REST APIs

API 版本:

v1.0

将特定工作负荷的状态更改为 “已启用 ”或 “已禁用”。 启用工作负荷时，指定工作负荷可以使用的最大内存百分比。

工作负荷 API 与 Gen2 容量无关。

所需范围

Capacity.ReadWrite.All

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

URI 参数

名称	在	必需	类型	说明
capacityId	path	True	string (uuid)	容量 ID
workloadName	path	True	string	工作负荷的名称

请求正文

名称	必需	类型	说明
state	True	WorkloadState	容量工作负荷状态
maxMemoryPercentageSetByUser		integer	工作负荷可以使用的最大内存百分比（由用户设置）

响应

名称	类型	说明
200 OK		好的

示例

Example

示例请求

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

请求正文

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

示例响应

状态代码:

200

定义

名称	说明
PatchWorkloadRequest	修补工作负荷设置请求
WorkloadState	容量工作负荷状态

PatchWorkloadRequest

Object

修补工作负荷设置请求

名称	类型	说明
maxMemoryPercentageSetByUser	integer	工作负荷可以使用的最大内存百分比（由用户设置）
state	WorkloadState	容量工作负荷状态

WorkloadState

枚举

容量工作负荷状态

值	说明
Disabled	工作负荷已禁用
Enabled	已启用工作负荷
Unsupported	当前容量 SKU 不支持工作负荷，无法启用。 修补 工作负荷 API 调用中的用户无法设置此值。