UpdateQuota - 更新资源配额配置

更新时间:
复制 MD 格式

您可以通过UpdateQuota更新一个资源配额信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

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"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。