您可以通过UpdateQuota更新一个资源配额信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
PUT /api/v1/quotas/{QuotaId} HTTP/1.1
路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| QuotaId |
string |
否 |
Quota ID。 |
quota-20210126170216-mtl37ge7gkvdz |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求 body。 |
|
| Description |
string |
否 |
资源配额描述。 |
this is a test quota |
| Labels |
array |
否 |
用户定义标签列表。 此处为全量更新。 |
|
| Label |
否 |
用户定义标签。 |
||
| QueueStrategy |
string |
否 |
Quota 上任务的排队策略。 |
PaiStrategyIntelligent |
| QuotaConfig | QuotaConfig |
否 |
资源配额配置 |
|
| QuotaName |
string |
否 |
资源配额名称 |
test |
| PropagateDefaultGPUDriver |
boolean |
否 |
是否将默认 GPU 驱动配置传递给子配额。 |
|
| ClusterSpec |
object |
否 |
配额绑定的计算集群(RNQ Ray 集群)配置,仅 RNQ 类型配额可用,普通配额传入会被拒绝。只在该配额上没有进行中的操作时才允许修改;未传入的子字段沿用当前已生效的配置 |
|
| ClusterType |
string |
否 |
集群类型,当前仅支持 RayCluster |
RayCluster |
| Image |
string |
否 |
Ray 集群使用的容器镜像。显式传入即切换到该镜像;留空且数据源未发生变化时,若 GetQuota 返回 UpgradeAvailable=true,本次更新被视为"升级到平台默认镜像"(想保持当前镜像请显式回传当前值) |
dsw-registry-vpc.ap-southeast-1.cr.aliyuncs.com/pai-common/ray-runtime |
| DataSources |
array |
否 |
集群挂载的数据源列表,整体替换语义:不传表示保持现状,传空数组表示清空。每个元素是一个 JSON 对象字符串,含 DataSourceId 或 Uri(二者必填其一且互斥)以及可选的 MountPath。 |
|
|
string |
否 |
集群规格的数据源配置 |
[] |
|
| EnableGracefulUpgrade |
boolean |
否 |
是否把本次 ClusterSpec 变更以滚动升级的方式执行(逐节点排水、迁移到新集群),而非默认的停止并重建。 |
true |
| GracefulUpgradeConfig |
object |
否 |
迁移过程的调优参数,仅允许在 EnableGracefulUpgrade=true 时传入 |
|
| MaxUnavailable |
string |
否 |
迁移窗口宽度,即老集群同时处于不可用状态(排水中、或已排水待移除)的 worker 数上限,也就是并行迁移的节点数。 |
25% |
| TaskDrainReserveWorkers |
integer |
否 |
等待老集群残余 Ray 任务跑完时,保留为可调度状态的老集群 worker 数。 |
5 |
| DrainTimeoutSeconds |
integer |
否 |
单个节点 Ray 排水的超时上限,超时后该节点仍会被直接缩容,不会导致升级失败。 |
3600 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
96496E6E-00B4-5F55-80F6-1844FA9E92DC |
| QuotaId |
string |
Quota ID。 |
quota-20210126170216-mtl37ge7gkvdz |
示例
正常返回示例
JSON格式
{
"RequestId": "96496E6E-00B4-5F55-80F6-1844FA9E92DC",
"QuotaId": "quota-20210126170216-mtl37ge7gkvdz"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。