全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

新建实例

最近更新时间:2024-12-30 21:29:54

接口描述

创建不同配置的实例

请求方式

GET

请求头

参数名称 类型 是否必须 描述
X-Version String 版本号,取值:2020-08-01
X-Action String 操作接口名,取值:CreateInstance

请求参数

参数名称 类型 是否必须 示例值 描述
NamespaceID String default-UID 命名空间ID
ImageID String a700fd4e-e6bc-42e9-bdbd-3664d6d921ae 镜像ID,例如a700fd4e-e6bc-42e9-bdbd-3664d6d921ae 对应centos7.8
InstanceSize String 2:8 实例配置,CPU和内存比例为1:2、1:4,其中CPU∈(1,2,4,8,16,32),内存∈(2,4,8,16,32,64,128)
SystemVolumeSize Interger 20 系统盘,默认20GB,最大200GB
DataVolume.n.Size Interger 10 数据盘,第n个数据盘的容量大小,n的数量[1,8],容量取值 [10,1000],步长10GB,目前只支持1块数据盘
Password String Kenc_20200801 实例开机密码,最短8字符,最长32字符,必须包含大小写英文字符和数字,支持其他可见字符,且要求包含大写字母、小写字母、数字、特殊字符中的至少三种的组合
KeyPairld String kp-9147f8d6bd69d65b43fb 绑定密钥对。与Password仅支持二选一,即两者只需要选择其一即可,若两者都传,则报错
EdgeNodeID String jnun11 边缘节点ID
Quantity Integer [1,20] 单节点可以创建的实例数量和范围
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

返回参数

参数名称 类型 示例值 描述
RequestID String 3a87cc31-efe6-487c-b28b-11bec3571e7d 请求ID
Code String Success 状态码,有InvalidParameter,Forbidden InternalError,Success四种状态
Instances Array 实例详情

Instances数据结构

参数名称 类型 示例值 描述
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."
}
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈