调用CreateResource创建资源组_人工智能平台 PAI(PAI)-阿里云帮助中心

创建一个新的资源组。

接口说明

请确保在使用该接口前，已充分了解 EAS 产品的收费方式和价格。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

eas:CreateResource

create

*Resource

acs:eas:{#regionId}:{#accountId}:resource/*

无

请求语法

POST /api/v2/resources HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求 Body。
EcsInstanceType	string	否	实例机型，对应 ECS 机型。说明当 ResourceType 选择 Dedicated 时，该参数为必填。	ecs.c6.8xlarge
SystemDiskSize	integer	否	系统盘大小，单位为 GiB。取值范围为 200-2000GiB，不配置默认为 200GiB。	200
EcsInstanceCount	integer	否	实例数量。说明当 ResourceType 选择 Dedicated 时，该参数为必填。	5
ChargeType	string	否	付费类型，取值如下： PrePaid：预付费。 PostPaid：后付费。说明当 ResourceType 选择 Dedicated 时，该参数为必填。枚举值： PostPaid : 后付费 PrePaid : 预付费	PostPaid
AutoRenewal	boolean	否	是否自动续费，取值如下： false（默认值）：表示不自动续费。 true：表示自动续费。	false
Zone	string	否	实例所属可用区。	cn-shanghai-f
ResourceType	string	否	资源组类型，取值如下： Dedicated：专属资源组。 SelfManaged：自运维资源组。说明使用自运维资源组时，需要申请添加白名单。枚举值： SelfManaged : SelfManaged Dedicated : Dedicated	Dedicated
SelfManagedResourceOptions	object	否	自运维资源组配置选项。
ExternalClusterId	string	否	自运维集群 Id。	cf0386f250f2545689ca7fdd1cd******
RoleName	string	否	授予云服务 PAI-EAS 相关权限的 RAM 角色名称。	clusterrole
NodeMatchLabels	object	否	节点的标签键值对集合。
	string	否	节点的标签键值对。	"key1": "value1"
NodeTolerations	array	否	节点污点的容忍度列表。
	object	否	节点污点的容忍度。
key	string	否	键名。	key1
value	string	否	键值。	value1
operator	string	否	键名和键值的关系。枚举值： Equal : Equal Exists : Exists	Equal
effect	string	否	效果。枚举值： PreferNoSchedule : PreferNoSchedule NoSchedule : NoSchedule NoExecute : NoExecute	NoSchedule
Labels	object	否	用户定义标签。
	string	否	标签。	{"key":"value"}
ResourceName	string	否	资源组名称。	MyResource

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	40325405-579C-4D82****
ResourceId	string	资源组 ID。	eas-r-h7lcw24dyqztwxxxxxx
ResourceName	string	资源组名称。	MyResource
ClusterId	string	资源组所在集群 ID。	cn-shanghai
OwnerUid	string	资源组的 Owner UID。	14401087478****
InstanceIds	array	机器实例 ID 列表。
	string	机器实例 ID。	eas-i-xxxxx

示例

正常返回示例

JSON格式

{
  "RequestId": "40325405-579C-4D82****",
  "ResourceId": "eas-r-h7lcw24dyqztwxxxxxx",
  "ResourceName": "MyResource",
  "ClusterId": "cn-shanghai",
  "OwnerUid": "14401087478****",
  "InstanceIds": [
    "eas-i-xxxxx"
  ]
}

错误码

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

变更历史

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