快照创建云主机(工单) - 混合云OpenAPI4.0

请求参数

Body 参数application/json

object | null

可选

clientToken

string

必需

客户端存根，用于保证订单幂等性。要求单个云平台账户内唯一

regionID

string

资源池ID

必需

资源池ID

instanceName

string

云主机名称

必需

Windows：长度为2~15个字符，允许使用大小写字母、数字或连字符（-）。不能以连字符（-）开头或结尾，不能连续使用连字符（-），也不能仅使用数字；
其他操作系统：长度为2-64字符，允许使用点（.）分隔字符成多段，每段允许使用大小写字母、数字或连字符（-），但不能连续使用点号（.）或连字符（-），不能以点号（.）或连字符（-）开头或结尾

displayName

string

云主机显示名称

必需

云主机显示名称，长度为2-63字符

snapshotID

string

快照ID

必需

云主机快照ID

vpcID

string

虚拟私有云ID

必需

networkCardList

array [object {5}]

网卡

必需

subnetID

string

子网ID

必需

非共享网卡时该参数为vpcID对应VPC下的子网ID，共享网卡时该参数为shareVpcID对应VPC下的子网ID

isMaster

boolean

是否主网卡

必需

true：表示主网卡，false：表示扩展网卡

nicName

string

网卡名称

可选

fixedIP

string

内网IPv4地址

可选

shareVpcID

string

共享网卡的虚拟私有云ID

可选

extIP

string

是否使用弹性公网

必需

是否使用弹性公网IP，取值范围:
0：不使用，
1：自动分配，
2：使用已有

secGroupList

array[string]

安全组id列表

可选

ipVersion

string

弹性IP版本

可选

（暂不支持）取值范围:
ipv4：v4地址，
ipv6：v6地址

bandwidth

integer

带宽大小

可选

带宽大小单位为Mbit/s，取值范围:[1~2000]

eipID

string

弹性公网IP的

可选

弹性公网IP的ID（orderCount>1时不可用）

affinityGroupID

string

云主机组ID

可选

keyPairID

string

密钥对ID

可选

暂不支持

userPassword

string

用户密码

可选

（暂不支持）满足以下规则：
长度在8～30个字符;
必须包含大写字母、小写字母、数字以及特殊符号中的三项;
特殊符号可选：()`~!@#$%^&*_-+=｜{}[]:;'<>,.?/\且不能以斜线号 / 开头

userData

string

用户自定义数据

可选

需要以Base64方式编码,Base64编码后的长度限制为1-16384字符

projectID

string

企业项目ID

可选

默认值为"0"

channelInfo

object

渠道侧信息

可选

暂不支持

paasAccoutID

string

paas账号

可选

paas账号，资源的付费账号，通过上送IT用于内部结算

masterOrderID

string

中台主订单ID

可选

中台主订单ID，IaaS记⼊话单，用来关联订单和资源

paasResourceID

string

资源ID

可选

IT侧订单对应资源ID

示例

{
    "regionID": "TestRegionID",
    "clientToken": "spcreatevm01",
    "instanceName": "paas-createvm-07",
    "displayName": "paas-createvm-07",
    "snapshotID": "3a7ddc23-e281-c50b-0bdb-7a1a19a32d5e",
    "vpcID": "vpc-3tbg06hhog",
    "extIP": "1",
    "networkCardList": [
        {
            "subnetID": "subnet-wrkcv0f4np",
            "isMaster": true
        }
    ],
    "secGroupList": [
        "sg-c2tb1ocyq5"
    ],
    "keyPairID": "test-kelong",
    "affinityGroupID": "89a2e8c8-9baf-4bac-9566-2650c87b0f2c"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v4/paas/ecs/snapshot/create-instance' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "clientToken": "spcreatevm01",
    "instanceName": "paas-createvm-07",
    "displayName": "paas-createvm-07",
    "snapshotID": "3a7ddc23-e281-c50b-0bdb-7a1a19a32d5e",
    "vpcID": "vpc-3tbg06hhog",
    "extIP": "1",
    "networkCardList": [
        {
            "subnetID": "subnet-wrkcv0f4np",
            "isMaster": true
        }
    ],
    "secGroupList": [
        "sg-c2tb1ocyq5"
    ],
    "keyPairID": "test-kelong",
    "affinityGroupID": "89a2e8c8-9baf-4bac-9566-2650c87b0f2c"
}'

返回响应

🟢200成功

application/json

Body

statusCode

integer

状态码

可选

800为成功，900为失败

errorCode

string

业务细分码

可选

message

string

失败时的错误描述

可选

失败时的错误描述，一般为英文描述

description

string

可选

失败时的错误描述，一般为中文描述

returnObj

object

成功时返回的数据

可选

jobID

string

任务ID

必需

查看创建云主机的任务状态请使用该参数调用查询任务接口进行查看

示例

{
    "statusCode": 800,
    "errorCode": "SUCCESS",
    "message": null,
    "description": "SUCCESS",
    "returnObj": {
        "jobID": "20240305000062"
    }
}