全部文档
当前文档
最近更新时间：2025-05-07 17:07:53
创建不同配置的实例
GET
参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
X-Version | String | 是 | 版本号，取值：2020-08-01 |
X-Action | String | 是 | 操作接口名，取值：CreateInstance |
参数名称 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
NamespaceID | String | 是 | default-UID | 命名空间ID |
BillType | String | 否 | 5 | 计费方式，1为预付费，5为后付费，默认为5 |
Duration | String | 否 | 1 | 单位月，预付费云主机必传 |
ProductType | String | 否 | 产品类型，默认虚机可不传；1148为SPOT实例 | |
ImageID | String | 是 | a700fd4e-e6bc-42e9-bdbd-3664d6d921ae | 镜像ID,例如a700fd4e-e6bc-42e9-bdbd-3664d6d921ae 对应centos7.8 |
InstanceSize | String | 是 | 2:8 | 实例配置，CPU:内存，例如1:2，4:8，其中CPU∈(1,2,4,8,16,32,48,64,128)，内存∈(2,4,8,16,32,64,128,256,512) spot实例需要特别注意，每卡配16:64，例如1卡时，该参数值为16:64，2卡时，该参数值为32:128。 |
GpuType | String | 否 | GPU-Ada9 | 可选GPU-Amp6、GPU-Ada9、GPU-Amp9 |
GpuCount | String | 否 | 1 | 可选1、2、4、8 |
SystemVolumeSize | Interger | 否 | 20 | 系统盘，单位GB，默认20GB，最大200GB |
SystemVolumeCategory | String | 否 | local_hdd | 系统盘类型，可选local_hdd、local_ssd |
DataVolume.n.Size | Interger | 否 | 10 | 数据盘，第n个数据盘的容量大小，n的数量[1,8]，容量取值 [10,1000]，步长10GB，目前只支持1块数据盘 |
DataVolume.n.Category | String | 否 | local_hdd | 系统盘类型，可选local_hdd、local_ssd |
Password | String | 否 | Kenc_20200801 | 实例开机密码，最短8字符，最长32字符，必须包含大小写英文字符和数字，支持其他可见字符,且要求包含大写字母、小写字母、数字、特殊字符中的至少三种的组合 |
KeyPairld | String | 否 | kp-9147f8d6bd69d65b43fb | 绑定密钥对。与Password仅支持二选一，即两者只需要选择其一即可，若两者都传，则报错 |
EdgeNodeID | String | 是 | jnun11 | 边缘节点ID |
Quantity | Integer | 是 | 1 | 创建实例数量，正整数，[1,30] |
InstanceName | String | 否 | Instance_Name001 | 实例的名称。命名规则：长度为2~128个英文或中文字符。必须以大小字母或中文开头。可以包含数字、下划线（_）、英文句号（.）或者连字符（-）。如果没有指定该参数，默认值为实例的InstanceId。 |
UniqueSuffix | Boolean | 否 | false | 是否为InstanceName添加有序后缀。有序后缀从001开始递增，最大不能超过999。例如：LocalHost001，LocalHost002和MyInstance001，MyInstance002。默认值：false。 |
VpcId | String | 否 | eb7a729c-984f-47a6-8dbc-9ac4e1bf7aea | 实例所属VPCId |
VSwitchId | String | 否 | eb7a729c-984f-47a6-8dbc-9ac4e1bf7aea | 实例所属交换机Id |
SecurityGroupId | String | 否 | s-xxxxx | 安全组ID |
NetworkOperatorType | String | 否 | bgp | 选择网络线路: 只能选择bgp、或cm, ct, un任意组合 例如：bgp、cm、ct、un、cm,ct、cm,un、ct,un、cm,ct,un |
BandWidthChargeType | String | 否 | 带宽计费方式，"staticBandwidth"--固定带宽，"95BandwidthByMonth"--月95峰计费，"BandwidthByFlow"--按流量计费，"BandwidthByDay"--日峰值计费 | |
PublicIPBandWidthLimit | String | 否 | 500 | 限速值，单位Mbps，[1,2000]，需要更高请联系商务/售前。 |
DefaultNetworkOperatorType | String | 否 | 网络默认线路，DefaultNetworkOperatorType, 如果是单线可以为空，如果是多线必须指定默认运营商类型 |
参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
RequestID | String | 3a87cc31-efe6-487c-b28b-11bec3571e7d | 请求ID |
Code | String | Success | 状态码,有InvalidParameter,Forbidden InternalError,Success四种状态 |
Instances | Array | 实例详情 |
参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
InstanceID | String | i-3422f6efdc3432052421ef67f24b14e1-sxct01 | 实例ID |
curl --location --request GET 'kenc.api.ksyun.com?InstanceSize=1:2&NamespaceID=demo&EdgeNodeID=sxct01&DataVolume.1.Size=10&Password=Centos11&Quantity=1&ImageID=a700fd4e-e6bc-42e9-bdbd-3664d6d921ae' \
--header 'X-Action: CreateInstance' \
--header 'X-Version: 2020-08-01' \
--header 'X-Amz-Date: 20200826T092325Z' \
--header 'Authorization: AWS4-HMAC-SHA256 Credential=AKLTDOTh-1tDQjSosbliA0SRHQ/20200826/beijing-6/kenc/aws4_request, SignedHeaders=host;x-amz-date;x-ksc-account-id, Signature=xxxxxxxxxx'{
"Code": "Success",
"Instances": [
{
"InstanceID": "i-3422f6efdc3432052421ef67f24b14e1-sxct01"
}
],
"RequestId": "3a87cc31-efe6-487c-b28b-11bec3571e7d"
}{
"RequestId": "1312fefe-ca48-4d72-8521-cf5d2cf06b9c",
"Code": "InvalidParameter",
"Message": "Invalid param Password."
}纯净模式