文档

CreateQuota - 创建资源配额

更新时间:

您可以通过CreateQuota接口创建一个资源配额。

调试

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

授权信息

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

请求语法

POST /api/v1/quotas

请求参数

名称类型必填描述示例值
bodyobject

请求体参数。

QuotaNamestring

Quota 名称。

test-quota
ResourceTypestring

Quota 资源类型(Lingjun/ECS/ACS),默认值 ECS。

ECS
ParentQuotaIdstring

父 QuotaId:

  • 如果父 QuotaId 为空,表示创建一个根 Quota,从专属资源组中分配机器。
  • 如果父 QuotaId 不为空,表示创建一个子 Quota,资源从根 Quota 中绑定的 Nodes 中分配资源。
quota1ci8g793pgm
ResourceGroupIdsarray

专有资源组列表。约束如下:

  • 只有根 Quota 允许从(父 QuotaId 为空)资源组划分机器。
  • 指定的资源组列表中的 VPC 配置需要一致。
string

资源组 ID。

rgl593id9qqwkmbr
AllocateStrategystring

Quota 分配策略,目前仅支持 ByNodeSpecs。

ByNodeSpecs
MinResourceSpec

Min Quota 配置。其中:

  • ResourceAmount:指定 CPU/Memory/GPUDetails。
  • NodeSpecs:指定机器规格和数量。

约束:

  • 若该 Quota 从专有资源组划分资源,只允许 NodeSpec 策略。
  • 若该 Quota 从父 Quota 划分资源,允许两种划分策略,但所有子 Quota 的只允许同一种划分策略。
  • Quota 内所有 GPU 规格要求卡型相同。
  • 资源类型为 ECS/Lingjun 的资源配额只可以使用 NodeSpecs 方式。
Descriptionstring

Quota 描述。

this is a test quota
Labelsarray

Quota 标签。

Label

标签。

QuotaConfigQuotaConfig

QuotaConfig 配置约束:

  • 使用 ECS/Lingjun 资源类型时,该配置不生效。
  • 使用 ACS 资源类型时,用户 VPC 信息以及 ACS 配置生效。
QueueStrategystring

共支持 4 种 Quota 上的排队策略。

  • PaiStrategyIntelligent:智能策略。
  • PaiStrategyBalance:均衡策略。
  • PaiStrategyRoundRobin:资源优先策略。
  • PaiStrategyStrictFIFO:FIFO 策略。
PaiStrategyIntelligent

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

CBF05F13-B24C-5129-9048-4FA684DCD579
QuotaIdstring

资源配额 ID。

quotad2kd8ljpsno

示例

正常返回示例

JSON格式

{
  "RequestId": "CBF05F13-B24C-5129-9048-4FA684DCD579",
  "QuotaId": "quotad2kd8ljpsno"
}

错误码

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

变更历史

变更时间变更内容概要操作
暂无变更历史