调用CreateQuota创建资源配额-人工智能平台 PAI-阿里云

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

pai:CreateQuota

none

*全部资源

*

无

请求语法

POST /api/v1/quotas HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求体参数。
QuotaName	string	否	Quota 名称。	test-quota
ResourceType	string	否	Quota 资源类型（Lingjun/ECS/ACS），默认值 ECS。	ECS
ParentQuotaId	string	否	父 QuotaId：如果父 QuotaId 为空，表示创建一个根 Quota，从专属资源组中分配机器。如果父 QuotaId 不为空，表示创建一个子 Quota，资源从根 Quota 中绑定的 Nodes 中分配资源。	quota1ci8g793pgm
ResourceGroupIds	array	否	专有资源组列表。约束如下：只有根 Quota 允许从（父 QuotaId 为空）资源组划分机器。指定的资源组列表中的 VPC 配置需要一致。
	string	否	资源组 ID。	rgl593id9qqwkmbr
AllocateStrategy	string	否	Quota 分配策略，目前仅支持 ByNodeSpecs。	ByNodeSpecs
Min	ResourceSpec	否	Min Quota 配置。其中： ResourceAmount：指定 CPU/Memory/GPUDetails。 NodeSpecs：指定机器规格和数量。约束：若该 Quota 从专有资源组划分资源，只允许 NodeSpec 策略。若该 Quota 从父 Quota 划分资源，允许两种划分策略，但所有子 Quota 的只允许同一种划分策略。 Quota 内所有 GPU 规格要求卡型相同。资源类型为 ECS/Lingjun 的资源配额只可以使用 NodeSpecs 方式。
Description	string	否	Quota 描述。	this is a test quota
Labels	array	否	Quota 标签。
	Label	否	标签。
QuotaConfig	QuotaConfig	否	QuotaConfig 配置约束：使用 ECS/Lingjun 资源类型时，该配置不生效。使用 ACS 资源类型时，用户 VPC 信息以及 ACS 配置生效。
QueueStrategy	string	否	共支持 4 种 Quota 上的排队策略。 PaiStrategyIntelligent：智能策略。 PaiStrategyBalance：均衡策略。 PaiStrategyRoundRobin：资源优先策略。 PaiStrategyStrictFIFO：FIFO 策略。	PaiStrategyIntelligent
ClusterSpec	ClusterSpec	否

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	CBF05F13-B24C-5129-9048-4FA684DCD579
QuotaId	string	资源配额 ID。	quotad2kd8ljpsno

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

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