接口描述

请求路径：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
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"
}