0913

最近更新时间:2018-08-03 18:07:16

Actions

RunInstances(创建实例)

从有访问权限的镜像(image)启动指定数量的实例。 在启动实例时,实例属于“创建中”(pending)状态,在实例准备好时,会进入“运行中(running)”状态。

Request Parameters(请求参数)

ImageId

镜像ID 类型: #### Request Parameters(请求参数) 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否

InstanceType

实例套餐类型,如果调用时未指定实例套餐类型,默认值为I1.1A 类型: String 有效值: IO优化型:1.1A | I1.1B| I1.1C| I1.2A| I1.2B| I1.2C| I1.4A| I1.4B| I1.4C| I1.8A| I1.8B| I1.8C| I1.16A| I1.16B| I1.16C| I1.24A| I1.24C| I1.24B| I1.24D| I1.32A| I1.32B; 通用型:N1.1A | N1.1B | N1.1C | N1.2A | N1.2B | N1.2C | N1.4A | N1.4B | N1.4C | N1.8A | N1.8B | N1.8C | N1.16A | N1.16B | N1.26C | N1.32A | N1.32B 具体套餐信息参考实例套餐类型定义 是否可缺省: 是

DataDiskGb

数据卷容量,单位GB,容量限制依据实例套餐类型定义变化,如果调用时未指定,则为相应实例套餐类型最小值。InstanceType为通用型主机。此参数不生效。 类型: Integer 是否可缺省: 是

MaxCount

最大实例数,如果指定的实例数大于金山云在本region所能创建的最大实例数,则会创建大于MinCount数量的最大允许实例数。 类型: Integer 有效值: 最小值1,最大值为MIN(当前用户实例剩余配额,30),即用户剩余配额和100比较的小者 是否可缺省: 否

MinCount

最小实例数,如果指定的实例数大于金山云在本region所能创建的最大实例数,则不会创建任何实例。 类型: Integer 有效值: 最小值1,最大值为MIN(当前用户实例剩余配额,30),即用户剩余配额和100比较的小者 是否可缺省: 否 SubnetId

VPC环境下的子网ID,绑定到主网卡 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否

InstancePassword

实例开机密码 类型: String 有效值:最短8字符,最长32字符,必须包含大小写英文字符和数字,支持其他可见字符 是否可缺省: 否

ChargeType

计费类型,调用时需要明确指定,无默认值 类型: String 有效值:Monthly(包年包月) 、按日月结Daily 是否可缺省: 否

PurchaseTime

购买时长,单位月 类型: Integer 有效值:当计费类型为Monthly(包年包月)时,有效值1-36;其他计费类型时,强制要求参数值为0 是否可缺省: 否

SecurityGroupId

实例绑定的安全组,目前仅支持绑定一个安全组 类型: String列表 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否

PrivateIpAddress

私有IP地址,指定子网IP地址范围内的任意有效值,代表实例的主IP地址,只能选择一个,绑定到主网卡;如果未指定该参数,系统自动从有效地址池中随机选取一个 类型: String 有效值:标准IP地址格式 是否可缺省: 是

InstanceName

实例名称,如果未指定,则自动生成,形如KSC-IN-[A-Z0-9]{10} 类型: String 有效值:最短2字符,最长64字符,支持中英文 是否可缺省: 是

InstanceNameSuffix

实例名称后缀,InstanceName参数如果缺省,此参数不生效;当大于1台的批量创建主机,后缀编号自动+1,例如后缀输入5,主机名输入”host”,批量3台,则生成的三台主机名分别为:”host-5”、”host-6”、”host-7”; 类型: String 默认值:空 有效值:0到9999 是否可缺省: 是

SriovNetSupport

开启增强联网,只支持IO优化型8核、16核套餐,只支持- CentOS操作系统6.5、6.6、6.7、7.0、7.1,Ubuntu 14.04操作系统。 默认值:false 类型:Boolean 是否可缺省:是

Response Elements(返回值) RequestId

请求ID 类型: String 是否可缺省: 否

InstancesSet 实例集合 类型: 实例(Instance) 列表 是否可缺省: 否 Examples(例子)

在默认region,创建一个实例,实例套餐类型C1.1A,数据盘大小50GB,计费类型包年包月,购买时长一个月,实例名称test_2

Sample Request(请求)

http://kec.api.ksyun.com/?Action=RunInstances&Version=2016-03-04 &MaxCount=1 &MinCount=1 &ImageId=314bbaa0-6ea3-4042-ae58-4d499a0a607b &SubnetId=d91f7510-2b59-4600-bc26-9c34c1b38493 &InstancePassword=1qaz2wsx!Q &SecurityGroupId=c032ce42-b457-4f36-a557-297994f172ac &DataDiskGb=50 &ChargeType=Monthly &InstanceType=C1.1A &PurchaseTime=1 &InstanceName=test_2 &AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<RunInstancesResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <RequestId>d13fbf44-f6ac-4030-96a6-4f5b38e8ca86</RequestId>
    <InstancesSet>
        <Item>
            <InstanceName>test_2</InstanceName>
            <InstanceId>d7d3e0b3-eeb1-40a3-89f3-a6100f14522b</InstanceId>
        </Item>
    </InstancesSet>
</RunInstancesResponse>

TerminateInstances(销毁实例)

销毁一个或者多个实例。 约束条件1:在销毁实例时,需要先解绑实例已挂则的EBS数据盘、SLB、EIP资源。

Request Parameters(请求参数)

InstanceId.N

待销毁实例ID列表 类型: String 列表 是否可缺省: 否

Response Elements(返回值)

RequestId

请求ID 类型: String 是否可缺省: 否

InstancesSet

销毁实例集合 类型: 实例状态改变(InstanceStateChange) 列表 是否可缺省: 否

Examples(例子)

在默认region,销毁两个实例

Sample Request(请求)

http://kec.api.ksyun.com/?Action=TerminateInstances&Version=2016-03-04
&InstanceId.1=e1d996e9-d182-4510-a9c7-82b74b6d1b81
&InstanceId.2=b6a77e1a-c560-4c10-a087-84871616f067
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<TerminateInstancesResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <InstancesSet>
        <Item>
            <InstanceId>b6a77e1a-c560-4c10-a087-84871616f067</InstanceId>
            <Return>true</Return>
        </Item>
        <Item>
            <InstanceId>e1d996e9-d182-4510-a9c7-82b74b6d1b81</InstanceId>
            <Return>true</Return>
        </Item>
    </InstancesSet>
    <RequestId>be000708-ceb5-4313-af1c-1e88c30db865</RequestId>
</TerminateInstancesResponse>

StartInstances(启动实例) 启动一个或者多个处于“停止状态(stopped)”的实例。 Request Parameters(请求参数) InstanceId.N 待启动实例ID列表 类型: String 列表 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 InstancesSet 启动实例集合 类型: 实例状态改变(InstanceStateChange) 列表 是否可缺省: 否 Examples(例子) 在默认region,启动一个实例(没有成功启动) Sample Request(请求)

http://kec.api.ksyun.com/?Action=StartInstances&Version=2016-03-04
&InstanceId.1=d7d3e0b3-eeb1-40a3-89f3-a6100f14522b
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<StartInstancesResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <InstancesSet>
        <Item>
            <InstanceId>d7d3e0b3-eeb1-40a3-89f3-a6100f14522b</InstanceId>
            <Return>false</Return>
        </Item>
    </InstancesSet>
    <RequestId>93eb7041-659f-43f6-a10c-abdf0a48a051</RequestId>
</StartInstancesResponse>

StopInstances(关闭实例) 关闭一个或者多个处于“活动状态(active)”的实例, Request Parameters(请求参数) InstanceId.N 待关闭实例ID列表 类型: String 列表 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 InstancesSet 关闭实例集合 类型: 实例状态改变(InstanceStateChange) 列表 是否可缺省: 否 Examples(例子) 在默认region,关闭一个实例(成功关闭)

Sample Request(请求)
http://kec.api.ksyun.com/?Action=StopInstances&Version=2016-03-04
&InstanceId.1=e007579f-bea2-483e-bfcb-fec760c58167
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<StopInstancesResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <InstancesSet>
        <Item>
            <InstanceId>e007579f-bea2-483e-bfcb-fec760c58167</InstanceId>
            <Return>true</Return>
        </Item>
    </InstancesSet>
    <RequestId>77492bfb-3567-4b9b-8f23-bbcc2ab5404c</RequestId>
</StopInstancesResponse>

RebootInstances(重启实例) 重启一个或者多个处于“活动状态(active)”的实例, Request Parameters(请求参数) InstanceId.N 待重启实例ID列表 类型: String 列表 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 InstancesSet 重启实例集合 类型: 实例状态改变(InstanceStateChange) 列表 是否可缺省: 否 Examples(例子) 在默认region,重启一个实例 Sample Request(请求)

http://kec.api.ksyun.com/?Action=RebootInstances&Version=2016-03-04
&InstanceId.1=e007579f-bea2-483e-bfcb-fec760c58167
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<RebootInstancesResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <InstancesSet>
        <Item>
            <InstanceId>e007579f-bea2-483e-bfcb-fec760c58167</InstanceId>
            <Return>true</Return>
        </Item>
    </InstancesSet>
    <RequestId>09bbe322-a83b-4fc4-8178-39062c7a6c10</RequestId>
</RebootInstancesResponse>

MonitorInstances(启动实例监控) 启动对一个或者多个实例的监控 Request Parameters(请求参数) InstanceId.N 待启动监控的实例ID列表 类型: String 列表 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 InstancesSet 实例监控信息集合 类型: 实例监控状态(InstanceMonitoring) 列表 是否可缺省: 否 Examples(例子) 在默认region,启动对一个实例的监控 Sample Request(请求)

http://kec.api.ksyun.com/?Action=MonitorInstances&Version=2016-03-04
&InstanceId.1=e007579f-bea2-483e-bfcb-fec760c58167
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<MonitorInstancesResponse>
    <InstancesSet>
        <Item>
            <InstanceId>e007579f-bea2-483e-bfcb-fec760c58167</InstanceId>
            <Monitoring>
                <State>enabled</State>
            </Monitoring>
        </Item>
    </InstancesSet>
    <RequestId>42825742-becb-4837-a0bf-88522db3b6fd</RequestId>
</MonitorInstancesResponse>

UnmonitorInstances(取消实例监控) 取消对一个或者多个实例的监控 Request Parameters(请求参数) InstanceId.N 待取消监控的实例ID列表 类型: String 列表 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 InstancesSet 实例监控信息集合 类型: 实例监控状态(InstanceMonitoring) 列表 是否可缺省: 否 Examples(例子) 在默认region,取消对一个实例的监控 Sample Request(请求)

http://kec.api.ksyun.com/?Action=UnmonitorInstances&Version=2016-03-04
&InstanceId.1=e007579f-bea2-483e-bfcb-fec760c58167
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<UnmonitorInstancesResponse>
    <InstancesSet>
        <Item>
            <InstanceId>e007579f-bea2-483e-bfcb-fec760c58167</InstanceId>
            <Monitoring>
                <State>disabled</State>
            </Monitoring>
        </Item>
    </InstancesSet>
    <RequestId>2995fd12-3193-412f-a31e-52983b6c6bf7</RequestId>
</UnmonitorInstancesResponse>

ModifyInstanceType(升级实例套餐类型) 升级实例的套餐类型,即配置信息(VCPU个数和内存大小),金山云只支持从低级别套餐升级为高级别套餐 升级配置暂不支持存储优化型和通用型主机 Request Parameters(请求参数) InstanceId 待升级套餐类型的实例ID 类型: String 是否可缺省: 否 InstanceType 实例套餐类型 类型: String 有效值: IO优化型:1.1A | I1.1B| I1.1C| I1.2A| I1.2B| I1.2C| I1.4A| I1.4B| I1.4C| I1.8A| I1.8B| I1.8C| I1.16A| I1.16B| I1.16C| I1.24A| I1.24C| I1.24B| I1.24D| I1.32A| I1.32B; 计算优化型:C1.1A | C1.1B | C1.1C | C1.2A | C1.2B | C1.2C | C1.4A | C1.4B | C1.4C | C1.8A | C1.8B | C1.8C | C1.16A | C1.16B | C1.16C| C1.24A | C1.24B | C1.24C | C1.24D | C1.32A | C1.32B ; 具体套餐信息参考实例套餐类型定义 是否可缺省: 否 DataDiskGb 数据卷容量,单位GB,数据卷只能扩容或者保持不变,且不能低于实例套餐类型定义的最小值 类型: Integer 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 Return 升级实例套餐类型成功与否 类型: String 有效值:true(成功)| false(失败) 是否可缺省: 否 Examples(例子) 在默认region,将一个实例升级到更高套餐级别,数据盘大小维持不变 Sample Request(请求)

http://kec.api.ksyun.com/?Action=ModifyInstanceType&Version=2016-03-04
&InstanceType=C1.1B
&DataDiskGb=1
&InstanceId=e007579f-bea2-483e-bfcb-fec760c58167
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<ModifyInstanceTypeResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <Return>true</Return>
    <RequestId>09bbe322-a83b-4fc4-8178-39062c7a6c10</RequestId>
</ModifyInstanceTypeResponse>

ModifyInstanceImage(更换或者重新安装实例操作系统) 重新安装/更换实例的操作系统; 约束条件1: 联网增强主机重装系统,只能安装联网增强型的标准系统镜像,暂不支持自定义镜像安装; Request Parameters(请求参数) InstanceId 待更换或者重新安装操作系统的实例ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 ImageId 待更换的镜像ID;如果缺省,表明无需改变镜像,只需重新安装实例的操作系统。 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 是 InstancePassword 实例开机密码 类型: String 有效值:最短8字符,最长32字符,必须包含大小写英文字符和数字,支持其他可见字符 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 Return 更换或者重装实例操作系统成功与否 类型: String 有效值:true(成功)| false(失败) 是否可缺省: 否 Examples(例子) 在默认region,为一个实例更换操作系统 Sample Request(请求)

http://kec.api.ksyun.com/?Action=ModifyInstanceImage&Version=2016-03-04
&InstanceId=efa35216-2fde-4e38-9b7e-2d0646f33d0f
&ImageId=8f12ad9e-ae9a-44b9-95f3-c4e65ce582e2
&InstancePassword=1qaQ!abc
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<ModifyInstanceImageResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <Return>true</Return>
    <RequestId>09bbe322-a83b-4fc4-8178-39062c7a6c10</RequestId>
</ModifyInstanceImageResponse>

ModifyInstanceAttribute(修改实例属性信息) 修改指定实例的实例名称或者开机密码;一次调用只能修改一个实例属性;修改实例密码必须关机操作,且后台为异步操作,需要等待时间较长(大约7秒)。 Request Parameters(请求参数) InstanceId 待修改属性的实例ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 InstanceName 实例名称,修改实例名称不需要关闭实例 类型: String 有效值:最短2字符,最长64字符,支持中英文 是否可缺省: 是 InstancePassword 实例开机密码,修改实例开机密码需要关闭实例 类型: String 有效值:最短8字符,最长32字符,必须包含大小写英文字符和数字,支持其他可见字符 是否可缺省: 是 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 Return 修改实例属性信息成功与否 类型: String 有效值:true(成功)| false(失败) 是否可缺省: 否 Examples(例子) 在默认region,为一个实例修改实例名称 Sample Request(请求)

http://kec.api.ksyun.com/?Action=ModifyInstanceAttribute&Version=2016-03-04
&InstanceId=e007579f-bea2-483e-bfcb-fec760c58167
&InstanceName=testmodifyname
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<ModifyInstanceAttributeResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <RequestId>91c2d855-df39-457d-9e62-dd01e8e5fc62</RequestId>
    <Return>true</Return>
</ModifyInstanceAttributeResponse>

DescribeInstanceVnc(获取VNC信息) 获取指定实例的VNC信息 Request Parameters(请求参数) InstanceId 要获取实例VNC信息的实例ID 类型: String 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 vncUrl VNC的URL 类型: String 是否可缺省: 否 Examples(例子) 获取实例的VNC信息 Sample Request(请求)

https://kec.api.ksyun.com/?Action= DescribeInstanceVnc&Version=2016-03-04
&AUTHPARAMS
&InstanceId=efa35216-2fde-4e38-9b7e-2d0646f33d0f

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<DescribeInstanceVncResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <requestId>123</requestId>
    <vncUrl>http://192.168.16.97:6080/vnc_auto.html?token=f331aca5-c6ed-4ab2-a35e-4fef5b173ddc</vncUrl>
</DescribeInstanceVncResponse>

DescribeInstances(描述实例信息) 主网卡信息直接在返回值中体现; NetworkInterfaceSet体现所有网卡的信息; Request Parameters(请求参数) MaxResults 单次调用所返回的最大实例数目,取值为5~1000,超过1000记为1000 类型: Integer 缺省: 10 是否可缺省: 是 Marker 分页标识,单次调用未返回全部实例时,标记下次调用的返回值的起点,默认值是0 类型: Integer 是否可缺省: 是 InstanceId.N 待返回描述信息的实例ID列表 类型: String 列表 缺省: 返回全部实例描述信息 是否可缺省: 是 Filter.N 一个或者多个过滤器 类型: 过滤器(Filter)列表 有效值:支持如下过滤器名称 instance-id 实例ID subnet-id 子网ID vpc-id vpc ID network-interface.subnet-id 网络接口关联的子网ID network-interface.network-interface-id 网络接口的ID network-interface.group-id 网络接口关联的安全组ID instance-state.name-实例状态 是否可缺省: 是 Sort: 筛选器 类型: 过滤器(Sort)列表 有效值:支持如下筛选器名称 InstanceName –主机名称 CreationDate –创建时间 PrivateIpAddress - 主机内网IP(主网卡) 是否可缺省:是 Search: 搜索条件,模糊匹配,可搜索字段如下: 类型:string 支持字段:实例名(InstanceName)、主网卡私有IP地址(PrivateIpAddress) 是否可缺省:是 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 Marker 分页标识,如果调用未返回全部实例,标记下次调用的返回值的起点,如果已返回全部实例,则其值为0 类型: Integer 是否可缺省: 否 InstanceCount 实例总数 类型: Integer 是否可缺省: 否 InstancesSet 实例集合 类型: 实例(Instance) 列表 是否可缺省: 否 Examples(例子) 描述某个region的全部实例信息 Sample Request(请求)

https://kec.api.ksyun.com/?Action=DescribeInstances&Version=2016-03-04
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<DescribeInstancesResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <Marker>0</Marker>
    <InstanceCount>35</InstanceCount>
    <RequestId>95085c36-35fd-4d48-a3b4-6e22b6133373</RequestId>
    <InstancesSet>
        <Item>
            <ImageId>1b071046-d0ba-44de-a167-7cf7f6544364</ImageId>
            <InstanceConfigure>
                <DataDiskType>SSD</DataDiskType>
                <DataDiskGb>20</DataDiskGb>
                <MemoryGb>1</MemoryGb>
                <VCPU>1</VCPU>
            </InstanceConfigure>
            <InstanceId>6e75f4cc-a450-4a89-b56a-66980d500ab1</InstanceId>
            <InstanceName>testvm2</InstanceName>
            <InstanceState>
                <Name>active</Name>
            </InstanceState>
            <Monitoring>
                <State>disabled</State>
            </Monitoring>
            <NetworkInterfaceSet>
                <Item>
                    <SecurityGroupSet>
                        <Item>
                            <SecurityGroupGroupId>d92f3801-2cb3-4809-897e-8ba95f491e78</SecurityGroupGroupId>
                        </Item>
                    </SecurityGroupSet>
                    <MacAddress>fa:16:3e:3f:68:8a</MacAddress>
                    <NetworkInterfaceId>ef0277e9-4569-4e49-9a3c-ff56b5083b35</NetworkInterfaceId>
                    <PrivateIpAddress>192.168.0.219</PrivateIpAddress>
                    <SubnetId>0666c7b3-dd12-4854-a390-2e31eb0368b5</SubnetId>
                </Item>
            </NetworkInterfaceSet>
            <SubnetId>0666c7b3-dd12-4854-a390-2e31eb0368b5</SubnetId>
        </Item>
    </InstancesSet>
</DescribeInstancesResponse>

ModifyNetworkInterfaceAttribute(修改网络接口属性信息) 修改指定网络接口的属性,当前支持修改安全组、子网或者DNS信息。 接口调用可修改一个或多个属性(安全组、子网、DNS、IP)。 特殊场景:如果跨VPC修改子网,SubnetID和SecurityGroupId必须在同一个VPC下 约束条件1:在更换主网卡SubnetId、PrivateIpAddress时,如果网络接口已经绑定EIP、属于SLB的真实服务器或绑定Portforword时,则不允许更改,需要先解绑相应配置。 约束条件2:修改副网卡网络信息时,DNS1和DNS2必须缺省,DNS与主网卡保持一致。 约束条件3:当SubnetId与接口调用前一致,PrivateIpAddress缺省代表与接口调用前相同,当SubnetId与接口调用前不一致,PrivateIpAddress缺省代表在新的子网Ip范围内自动分配。 Request Parameters(请求参数) InstanceId 待修改属性的实例ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 NetworkInterfaceId 待修改属性的网络接口ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 SecurityGroupId(SecurityGroupId.N只识别第一个数组成员) 实例绑定的安全组 类型: String列表 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 SubnetId 新的子网ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 PrivateIpAddress 私有IP地址,子网IP地址范围内的任意有效值 类型: String 有效值:标准IP地址格式 是否可缺省: 是 DNS1 DNS 1的值,当通过该接口进行修改网络配置时不填写此参数,保持与之前不变。 类型: String 有效值: 标准IP地址 是否可缺省: 是 DNS2 DNS 2的值,当通过该接口进行修改网络配置时不填写此参数,保持与之前不变。 类型: String 有效值: 标准IP地址 是否可缺省: 是 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 Return 修改网络接口属性信息成功与否 类型: String 有效值:true(成功)| false(失败) 是否可缺省: 否 Examples(例子) 在默认region,为一个网络接口修改子网信息 Sample Request(请求)

http://kec.api.ksyun.com/?Action=ModifyNetworkInterfaceAttribute&Version=2016-03-04
&InstanceId=e007579f-bea2-483e-bfcb-fec760c58167
&NetworkInterfaceId=2f93aaba-6368-4cec-b50f-9f199138023f
&SubnetId=c6839580-6ce4-453a-8533-b4fd659eff36
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<ModifyNetworkInterfaceAttributeResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <RequestId>f2d20e49-63d9-4e6c-b598-050d2fc2631a</RequestId>
    <Return>true</Return>
</ModifyNetworkInterfaceAttributeResponse>

AttachNetworkInterface(为主机添加网卡) 为一个主机实例添加辅网卡 约束条件1:每个主机实例默认拥有主网卡,只能用该接口添加一个辅网卡。 Request Parameters(请求参数) InstanceId 待添加网卡的实例ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 SecurityGroupId.N 实例绑定的安全组集合(只识别第一个数组成员) 类型: String列表 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 SubnetId 新的子网ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 PrivateIpAddress 私有IP地址,新的子网IP地址范围内的任意有效值,只有在更改子网时可同步设置此参数,如果在更改子网时未指定该参数,系统自动从新的子网有效地址池中随机选取一个 类型: String 有效值:标准IP地址格式 是否可缺省: 是 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 Return 返回状态 类型: Bool 是否可缺省: 否 Examples(例子) Sample Request(请求)

http://kec.api.ksyun.com/?Action=AttachNetworkInterface&Version=2016-03-04
&InstanceId=98284100-f6d1-4bbf-886a-1b0765024738
&SubnetId=4d68d87b-5cbb-4b1a-b761-562ecaf143d6
&SecurityGroupId.1=d386fa74-4bcc-4bf9-bb67-3f0e7cb3d50b
&PrivateIpAddress=10.0.0.1

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<AttachNetworkInterface Response xmlns="http://vm.ksyun.com/doc/2016-3-09/">
   <RequestId>be000708-ceb5-4313-af1c-1e88c30db865</RequestId>
   <Return>true</Return>
</AttachNetworkInterface Response>

DetachNetworkInterface(删除主机网络接口) 删除主机的辅网卡 约束条件1:只能删除主机的辅网卡。 Request Parameters(请求参数) InstanceId 待删除网卡的实例ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 NetworkInterfaceId 待删除的网络接口ID 类型: String 是否可缺省: 否 Return 返回状态 类型: Bool 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 Examples(例子) 在默认region,销毁两个实例 Sample Request(请求)

http://kec.api.ksyun.com/?Action=DetachNetworkInterface&Version=2016-03-04
&InstanceId=98284100-f6d1-4bbf-886a-1b0765024738
&NetworkInterfaceId=0015b5da-e1f6-43f6-9fe4-fecdc0640626

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<DetachNetworkInterfaceResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
   <RequestId>be000708-ceb5-4313-af1c-1e88c30db865</RequestId>
   <Return>true</Return>
</DetachNetworkInterfaceResponse>

CreateImage(创建镜像) 支持实例在开机状态下,从实例根设备(系统卷)创建私有镜像 Request Parameters(请求参数) InstanceId 待创建镜像的实例ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 Name 新镜像的名称 类型: String 有效值:2-64个字符,支持中文、字母、数字以及-_@#.字符 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 ImageId 新创建的镜像ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 Examples(例子) 在默认region,为一个实例创建新镜像 Sample Request(请求)

http://kec.api.ksyun.com/?Action=CreateImage&Version=2016-03-04
&InstanceId=e007579f-bea2-483e-bfcb-fec760c58167
&Name=newimage
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<CreateImageResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <RequestId>27fb86b1-2c8e-4156-8845-f41faff65a3b</RequestId>
    <ImageId>15754278-6194-4b29-a3cd-677182c69b77</ImageId>
</CreateImageResponse>

DescribeImages(描述镜像信息) 描述当前可使用的镜像信息,包括私有镜像和公共镜像 Request Parameters(请求参数) ImageId 镜像ID 类型: String 是否可缺省: 是 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 ImagesSet 镜像集合 类型: 镜像(Image) 列表 是否可缺省: 否 Examples(例子) 在默认region,描述全部可用镜像 Sample Request(请求)

http://kec.api.ksyun.com/?Action=DescribeImages&Version=2016-03-04
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<DescribeImagesResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <RequestId>5bec3a7e-8b58-4b48-a947-45cf85ed75c3</RequestId>
    <ImagesSet>
        <Item>
            <CreationDate>2016-04-30T16:29:00Z</CreationDate>
            <IsPublic>false</IsPublic>
            <Name>newimage</Name>
            <Platform>centos-6.5</Platform>
            <ImageState>ACTIVE</ImageState>
            <ImageId>15754278-6194-4b29-a3cd-677182c69b77</ImageId>
        </Item>
        ...
        <Item>
            <CreationDate>2016-04-11T18:28:21Z</CreationDate>
            <IsPublic>true</IsPublic>
            <Name>Centos-6.5-x86_64</Name>
            <Platform>centos-6.5</Platform>
            <ImageState>ACTIVE</ImageState>
            <ImageId>667e731a-1c9a-4c44-9613-94a713b9ef94</ImageId>
        </Item>
    </ImagesSet>
</DescribeImagesResponse>

RemoveImages(删除镜像) 删除私有镜像,一次调用只能删除一个镜像(后续迭代增加批量) Request Parameters(请求参数) ImageId 待删除的镜像ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 ReturnSet 镜像删除结果集合 类型: 镜像删除结果(ImageDeletion) 列表 是否可缺省: 否 Examples(例子) 在默认region,删除一个私有镜像 Sample Request(请求)

http://kec.api.ksyun.com/?Action=RemoveImages&Version=2016-03-04
&ImageId.1=15754278-6194-4b29-a3cd-677182c69b77
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<RemoveImageResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <ReturnSet>
        <item>
            <ImageId>15754278-6194-4b29-a3cd-677182c69b77</ImageId>
            <Return>true</Return>
        </item>
    </ReturnSet>
    <RequestId>b3ded367-781f-4c9e-aa05-b34a5a666610</RequestId>
</RemoveImageResponse>

ModifyImageAttribute(修改镜像属性信息) 修改私有镜像属性,当前只支持修改私有镜像名称,不能够修改公共镜像属性 Request Parameters(请求参数) ImageId 待修改属性的镜像ID 类型: String 列表 是否可缺省: 否 Name 新镜像的名称 类型: String 有效值:2-64个字符,支持中文、字母、数字以及-_@#.字符 是否可缺省: 否 Response Elements(返回值) RequestId 请求ID 类型: String 是否可缺省: 否 Return 修改实例属性成功与否 类型: String 有效值:true(成功)| false(失败) 是否可缺省: 否 Examples(例子) 在默认region,修改一个私有镜像的名称 Sample Request(请求)

http://kec.api.ksyun.com/?Action=ModifyImageAttribute&Version=2016-03-04
&ImageId=16f55e1d-8ab3-4026-ba4d-5ae9e6f083db
&Name=test1234
&AUTHPARAMS

Sample Response(返回)

<?xml version="1.0" encoding="UTF-8"?>
<ModifyImageAttributeResponse xmlns="http://vm.ksyun.com/doc/2016-3-09/">
    <Return>true</Return>
    <RequestId>b3ded367-781f-4c9e-aa05-b34a5a666610</RequestId>
</ModifyImageAttributeResponse>

Data Types

Instance(实例类型) Contents(内容) InstanceId 实例ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 InstanceName 实例名称 类型: String 是否可缺省: 否 InstanceConfigure 实例配置,“创建实例”时不返回该信息,“描述实例”时返回该信息 类型: 实例配置( InstanceConfigure) 类型 是否可缺省: 是 ImageId 镜像ID,“创建实例”时不返回该信息,“描述实例”时返回该信息 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 是 InstanceType 实例套餐类型,“创建实例”时不返回该信息,“描述实例”时返回该信息 类型: String 有效值: I1.1A | I1.1B| I1.1C| I1.2A| I1.2B| I1.2C| I1.4A| I1.4B| I1.4C| I1.8A| I1.8B| I1.8C| I1.16A| I1.16B| I1.16C| I1.24A| I1.24C| I1.24B| I1.24D| I1.32A| I1.32B; C1.1A | C1.1B | C1.1C | C1.2A | C1.2B | C1.2C | C1.4A | C1.4B | C1.4C | C1.8A | C1.8B | C1.8C | C1.16A | C1.16B | C1.16C| C1.24A | C1.24B | C1.24C | C1.24D | C1.32A | C1.32B ;S1.4A | S1.8A | S1.16A | S1.32A | I0. | N0. 具体套餐信息参考实例套餐类型定义 是否可缺省: 是 InstanceState 实例状态,“创建实例”时不返回该信息,“描述实例”时返回该信息 类型: 实例状态(InstanceState) 类型 是否可缺省: 是 SubnetId 主网卡子网ID,“创建实例”时不返回该信息,“描述实例”时返回该信息 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 是 VpcId 主网卡VPCID,“创建实例”时不返回该信息,“描述实例”时返回该信息 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 是 PrivateIpAddress 主网卡私有IP地址 类型: String 有效值:标准IP地址格式 是否可缺省: 是 Monitoring 监控状态,“创建实例”时不返回该信息,“描述实例”时返回该信息 类型: 监控状态 (Monitoring) 类型 是否可缺省: 是 SriovNetSupport 开启增强联网 类型:Boolean 是否可缺省:是 CreationDate 创建时间,“创建实例”时不返回该信息,“描述实例”时返回该信息 类型: String 有效值:按照ISO8601标准,使用UTC时间,格式为”YYYY-MM-DDThh:mm:ssZ”例如,2014-05-26T12:00:00Z (为北京时间2014年5月26日20点0分0秒) 是否可缺省: 否 NetworkInterfaceSet 网络接口集合,“创建实例”时不返回该信息,“描述实例”时返回该信息 类型: 网络接口(NetworkInterface) 列表 是否可缺省: 是 InstanceConfigure(实例配置类型) Contents(内容) VCPU 实例VCPU的个数 类型: Integer 是否可缺省: 否 MemoryGb 实例内存的大小,单位GB 类型: Integer 是否可缺省: 否 DataDiskType 数据磁盘类型 类型: String 有效值: SSD | SATA 是否可缺省: 否 DataDiskGb 数据磁盘大小,单位GB 类型: Integer 是否可缺省: 否 Monitoring(监控状态类型) Contents(内容) State 监控状态 类型: String 有效值: disabled | enabled 是否可缺省: 否 InstanceState(实例状态类型) Contents(内容) Name 实例状态 类型: String 有效值: active | building | paused | suspended | stopped | rescued | resized | soft-delete | deleted | deleting | error | scheduling | block_device_mapping | networking | spawning | image_snapshot | image_backup | updating_password | resize_prep | resize_migrating | resize_migrated | resize_finish | resize_finish | resize_reverting | resize_confirming | migrating | rebooting | rebooting_hard | pausing | unpausing | suspending | resuming | stopping | starting | powering-off | powering-on | rescuing | unrescuing | rebuilding | rebuild_block_device_mapping | rebuild_spawning | deleting 主机状态注释 是否可缺省: 否 NetworkInterface(网络接口类型) Contents(内容) NetworkInterfaceId 网络接口ID 类型: String 是否可缺省: 否 NetworkInterfaceType 网卡的类型 有效值:primary|extension 类型:String 是否可缺省: 否 MacAddress 网卡的MAC地址 类型:String 是否可缺省: 否 SubnetId 子网ID 类型: String 是否可缺省: 否 MacAddress Mac地址 类型: String 是否可缺省: 否 PrivateIpAddress 私有IP地址 类型: String 是否可缺省: 否 SecurityGroupSet 实例绑定的安全组集合 类型: 安全组标识(GroupIdentifier) 列表 是否可缺省: 否 DNS1 网卡的DNS1 类型:String 是否可缺省: 否 DNS2 网卡的DNS2 类型:String 是否可缺省: 否 GroupIdentifier(安全组标识类型) Contents(内容) SecurityGroupId(兼容GroupId) 安全组ID 类型: String 是否可缺省: 否 InstanceStateChange(实例状态改变类型) Contents(内容) InstanceId 实例ID 类型: String 是否可缺省: 否 Return 实例状态改变成功与否 类型: String 有效值:true(成功)| false(失败) 是否可缺省: 否 InstanceMonitoring(实例监控状态类型) Contents(内容) InstanceId 实例ID 类型: String 是否可缺省: 否 Monitoring 监控状态 类型: 监控状态 (Monitoring) 类型 是否可缺省: 否 Filter(过滤器类型) Contents(内容) Name 过滤器名称,大小写敏感 类型: String 是否可缺省: 否 Value 一个或者多个过滤器值 类型: String 列表 是否可缺省: 否 Sort(筛选类型) Contents(内容) Name 筛选名称,大小写敏感 类型: String 是否可缺省: 否 Value 筛选值 类型: String 列表 有效值:ACS(正序排列) | DESC(倒序排列) 是否可缺省: 否 Image(镜像类型) Contents(内容) Name 镜像名称 类型: String 是否可缺省: 否 ImageId 镜像ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 CreationDate 创建时间 类型: String 有效值:按照ISO8601标准,使用UTC时间,格式为”YYYY-MM-DDThh:mm:ssZ”例如,2014-05-26T12:00:00Z (为北京时间2014年5月26日20点0分0秒) 是否可缺省: 否 IsPublic 是否为公共镜像 类型: String 有效值: true(公共镜像)| false(私有镜像) 是否可缺省: 否 Platform 镜像操作系统平台 类型: String 是否可缺省: 否 ImageState 镜像状态 类型: String 有效值: queued | saving | active | deactived | killed | deleted | pending_delete 是否可缺省: 否 InstanceId 关联实例ID 类型: String 是否可缺省: 否 BlockDeviceMapping(块存储映射信息) Contents(内容) DeviceName EBS信息,从/dev/vda 开始到 /dev/vdz ,/dev/vda 则为系统盘,一台云服务器只有一个系统盘。如果主机类型不为通用型、超级云主机,则不可为/dev/vda。 类型: String 默认值:/dev/vda 是否可缺省: 是 Ebs EBS属性 类型: EbsBlockDevice 是否可缺省: 否 EbsBlockDevice(EBS块设备) Description(描述) 块设备描述。 Contents(内容) VolumeName EBS名字,2-40字符 类型: string 默认值:ksc-ebs+创建日期 是否可缺省: 是 VolumeDescription EBS描述,2-40字符 类型: string 默认值:空 是否可缺省: 是 DeleteOnTermination 主机实例删除时是否同时删除。 类型: Boolean 默认值:当为系统盘无论是否输入false该参数均为true,数据盘默认为false。 是否可缺省: 是 VolumeSize 硬盘大小,单位GB 类型: Integer 有效值:系统盘,最小值为40,以10G为步进,最大500GB;数据盘,最小10GB,以10G为步进,最大16T(16384G)。 是否可缺省: 否 VolumeType EBS类型 类型: String 默认值:SSD 有效值:SSD 是否可缺省: 是 SnapshotId 用来创建EBS数据盘的快照ID,系统盘不支持该参数。 类型:String 是否可缺省:是 ImageDeletion(镜像删除结果类型) Contents(内容) ImageId 镜像ID 类型: String 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 是否可缺省: 否 Return 镜像删除操作成功与否 类型: String 有效值:true(成功)| false(失败) 是否可缺省: 否

金山云,开启您的云计算之旅

立即注册