接口描述
请求路径:https://open.didiyunapi.com/dicloud/i/compute/dc2/assign
请求方法:POST
输入参数
CreateDC2Params:
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
regionId | 是 | string | 地域id |
zoneId | 否 | string | 可用区id,在何可用区创建此DC2,在指定subnetUuid时可不传。不传subnetUuid参数时必传 |
autoContinue | 否 | bool | 是否设置DC2自动续费 |
payPeriod | 否 | int | 购买包月时长,单位为月,不传或传0表示后付费 |
count | 否 | int | 批量购买参数,不传默认购买一台DC2,不能超过20 |
couponId | 否 | string | 本次创建使用的优惠券id |
subnetUuid | 否 | string | 在此指定子网下创建DC2,不传zoneId参数时必传。如果未传,则会在目标地域的默认VPC下对应可用区的默认子网中创建DC2 |
ip | 否 | string | 指定网卡IP(IPv4,且必须同时指定子网(subnetUuid))创建DC2。默认自动分配,当指定时,如果该IP在对应子网内已经被使用,则创建报错;如果是批量创建多台DC2,则第一个DC2分配指定IP,其他DC2依次递增分配 |
dc2Model | 是 | string | 要创建的dc2型号 常用的DC2型号列表 |
imgUuid | 是 | string | 使用何镜像创建DC2,与snapUuid二选一 |
snapUuid | 是 | string | 使用何快照创建DC2,与imgUuid二选一。注意:使用快照创建DC2时,通用型DC2与本地型DC2的快照不可互通。关于DC2型号信息可参阅常用的DC2型号列表 |
pubKeyUuids | 是 | array<string> | 使用公钥Uuid列表进行DC2创建,与password参数二选一。注意:Windows实例不支持公钥创建 |
password | 是 | string | 使用密码进行创建,与pubKeyUuids参数二选一。密码为8位以上字符,需同时包含大写字母、小写字母和数字。传参时需将密码进行16进制编码后传递 |
rootDiskSize | 否 | int | 根盘大小,单位GB,当所选规格族为通用型(e1,g1,g2)时需要传递,需大于等于40,且小于等于500 |
rootDiskType | 否 | string | 根盘类型("SSD"或"HE"),当所选规格族为通用型(e1,g1,g2)时需要传递 |
dc2Tags | 否 | array<string> | DC2标签 |
name | 是 | string | DC2名称,长度为1~255个字节。批量创建时,可以通过设置命名规则进行有序命名,规则形式如:{offset,bits},offset代表序列起始值,bits代表序列字符个数(高位补0),可以同时设定多个规则。例如,取值为dicloud-{1,4}-web-{2,3},则第一台DC2的名称为dicloud-0001-web-002。 |
proSecurityAgentEnabled | 否 | bool | 是否同时安装主机安全Agent专业版 |
monitoringAgentEnabled | 否 | bool | 是否同时安装监控Agent |
sgUuids | 否 | array<string> | 此DC2将要加入的安全组列表 |
eip | 否 | EIPInput | 同时创建的EIP信息 |
ebs | 否 | array<EBSInput> | 同时创建的EBS信息 |
useCimgPassword | 否 | bool | 是否使用镜像预设密码,仅当使用自定义镜像创建时,才可使用镜像预设密码 |
EIPInput:
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
bandwidth | 是 | int | EIP的带宽,为1-100之间的值 |
chargeWithFlow | 否 | bool | 是否要按流量计费 (为按流量计费时,默认为后付费) |
eipTags | 否 | array<string> | EIP标签 |
EBSInput:
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
count | 否 | int | 批量购买参数,不传默认购买一块EBS,不能超过5 |
name | 否 | string | 创建的EBS名称 |
size | 是 | int64 | 创建的EBS大小,单位GB,需大于等于20,并小于等于16384 |
diskType | 是 | string | 创建的EBS类型("HE"或"SSD") |
snapUuid | 否 | string | 通过此快照创建EBS |
mountFileSystem | 否 | string | Linux挂载的数据盘文件系统(initializeAndMount为true时必填,windows不需要传),可选值:ext4,xfs |
initializeAndMount | 否 | bool | 创建数据盘时是否自动初始化并挂载 |
ebsTags | 否 | array<string> | EBS标签 |
常用DC2型号列表(DC2Model)
DC2的型号是创建、管理DC2的必要参数之一,常用的DC2型号如下:
类型/族群 | CPU数量 | 内存大小(GB) | 磁盘大小(GB) | GPU数量 | GPU型号 | 型号 |
---|---|---|---|---|---|---|
本地SSD型(s1) | 1 | 1 | 20 | - | - | dc2.s1.small1.d20 |
1 | 2 | 40 | - | - | dc2.s1.small2.d40 | |
2 | 4 | 40 | - | - | dc2.s1.large4.d40 | |
2 | 4 | 80 | - | - | dc2.s1.large4.d80 | |
4 | 8 | 80 | - | - | dc2.s1.xlarge8.d80 | |
4 | 8 | 160 | - | - | dc2.s1.xlarge8.d160 | |
8 | 16 | 240 | - | - | dc2.s1.2xlarge16.d240 | |
8 | 16 | 320 | - | - | dc2.s1.2xlarge16.d320 | |
16 | 32 | 320 | - | - | dc2.s1.4xlarge32.d320 | |
16 | 32 | 480 | - | - | dc2.s1.4xlarge32.d480 | |
通用型(e1) | 1 | 1 | - | - | - | dc2.e1.small1 |
1 | 2 | - | - | - | dc2.e1.small2 | |
2 | 4 | - | - | - | dc2.e1.large4 | |
4 | 8 | - | - | - | dc2.e1.xlarge8 | |
8 | 16 | - | - | - | dc2.e1.2xlarge16 | |
16 | 32 | - | - | - | dc2.e1.4xlarge32 | |
本地型P4(gn1) | 2 | 4 | 80 | 1 | P4 | dc2.gn1.large4g1.d80 |
4 | 8 | 160 | 1 | P4 | dc2.gn1.xlarge8g1.d160 | |
8 | 16 | 320 | 1 | P4 | dc2.gn1.2xlarge16g1.d320 | |
16 | 32 | 320 | 1 | P4 | dc2.gn1.4xlarge32g1.d480 | |
本地型P40(gn2) | 8 | 48 | 240 | 1 | P40 | dc2.gn2.2xlarge48g1.d240 |
16 | 96 | 480 | 2 | P40 | dc2.gn2.4xlarge96g2.d480 | |
32 | 192 | 960 | 4 | P40 | dc2.gn2.8xlarge192g4.d960 | |
本地型P100(gn3)(联系客服开启内测) | 8 | 48 | 240 | 1 | P100 | dc2.gn3.2xlarge48g1.d240 |
16 | 96 | 480 | 2 | P100 | dc2.gn3.4xlarge96g2.d480 | |
32 | 192 | 960 | 4 | P100 | dc2.gn3.8xlarge192g4.d960 | |
本地型G4(gn4)(联系客服开启内测) | 8 | 16 | 80 | 1 | G4 | dc2.gn4.2xlarge16g1.d80 |
16 | 32 | 160 | 2 | G4 | dc2.gn4.4xlarge32g2.d160 | |
32 | 64 | 320 | 4 | G4 | dc2.gn4.8xlarge64g4.d320 | |
64 | 128 | 640 | 8 | G4 | dc2.gn4.16xlarge128g8.d640 | |
本地型T4(gn5)(联系客服开启内测) | 8 | 16 | 80 | 1 | T4 | dc2.gn5.2xlarge16g1.d80 |
16 | 32 | 160 | 2 | T4 | dc2.gn5.4xlarge32g2.d160 | |
32 | 64 | 320 | 4 | T4 | dc2.gn5.8xlarge64g4.d320 | |
64 | 128 | 640 | 8 | T4 | dc2.gn5.16xlarge128g8.d640 | |
通用型P4(g1) | 2 | 4 | - | 1 | P4 | dc2.g1.large4g1 |
4 | 8 | - | 1 | P4 | dc2.g1.xlarge8g1 | |
8 | 16 | - | 1 | P4 | dc2.g1.2xlarge16g1 | |
16 | 32 | - | 1 | P4 | dc2.g1.4xlarge32g1 | |
通用型P40(g2) | 8 | 48 | - | 1 | P40 | dc2.g2.2xlarge48g1 |
16 | 96 | - | 2 | P40 | dc2.g2.4xlarge96g2 | |
32 | 192 | - | 4 | P40 | dc2.g2.8xlarge192g4 | |
通用型P100(g3)(联系客服开启内测) | 8 | 48 | - | 1 | P100 | dc2.g3.2xlarge48g1 |
16 | 96 | - | 2 | P100 | dc2.g3.4xlarge96g2 | |
32 | 192 | - | 4 | P100 | dc2.g3.8xlarge192g4 | |
通用型G4(g4)(联系客服开启内测) | 8 | 16 | - | 1 | G4 | dc2.g4.2xlarge16g1 |
16 | 32 | - | 2 | G4 | dc2.g4.4xlarge32g2 | |
32 | 64 | - | 4 | G4 | dc2.g4.8xlarge64g4 | |
64 | 128 | - | 8 | G4 | dc2.g4.16xlarge128g8 | |
通用型T4(g5)(联系客服开启内测) | 8 | 16 | - | 1 | T4 | dc2.g5.2xlarge16g1 |
16 | 32 | - | 2 | T4 | dc2.g5.4xlarge32g2 | |
32 | 64 | - | 4 | T4 | dc2.g5.8xlarge64g4 | |
64 | 128 | - | 8 | T4 | dc2.g5.16xlarge128g8 |
输出参数
参数名称 | 类型 | 描述 |
---|---|---|
errno | int | 错误码 |
errmsg | string | 请求错误说明 |
requestId | string | 请求唯一标识 |
data | array<Job> | 请求返回数据 |
错误码
错误码 | 说明 |
---|---|
0 | 请求成功 |
示例
请求:
curl -X POST https://open.didiyunapi.com/dicloud/i/compute/dc2/assign \
-H 'authorization: Bearer 9a609744ad675e8fbfcdbf14511b24e6ddd6b427b4d256969534a81d0773f4d7' \
-H 'content-type: application/json' \
-d '{
"regionId":"gz",
"name":"test",
"imgUuid":"46b447a8b0a146779bbde3ca40e56843",
"dc2Model":"dc2.s1.small1.d20",
"password":"53746d333137303234",
"subnetUuid":"f2513581ccd048dc9d0ccec32114b7cd",
"eip":{
"bandwidth":1,
"tags":["testeip"]
},
"ebs":[{
"size":20,
"diskType":"SSD"
}],
"tags":["testdc2"]
}'
输出:
{
"errno": 0,
"errmsg": "ok",
"data": [
{
"done": false,
"jobUuid": "c572fb9bd52e5e70874bc0b3b0451106",
"progress": 0,
"success": false,
"type": "CreateDC2"
}
],
"requestId": "0a60538a5bc59a824f129a79b71d40b0"
}