京东云服务器简介

京东云服务器简介
API接口名称请求方式功能描述associateElasticIpPOST为京东云服务器主网卡下的主内网IP绑定弹性公网IP。
一台京东云服务器只能绑定一个弹性公网IP(主网卡)，若主网卡已存在弹性公网IP，会返回错误。
attachDiskPOST为一台京东云服务器挂载一块数据盘(云硬盘)，京东云服务器和云硬盘没有正在进行中的的任务时才可挂载。
京东云服务器状态必须是running或stopped状态。
本地盘(local类型)做系统盘的京东云服务器可挂载8块数据盘，云硬盘(cloud类型)做系统盘的京东云服务器可挂载7块数据盘。attachNetworkInterfacePOST京东云服务器挂载一块弹性网卡。
京东云服务器状态必须为running或stopped状态，并且没有正在进行中的任务才可操作。
弹性网卡上如果绑定了公网IP，那么公网IP所在az需要与京东云服务器的az保持一致，或者公网IP属于全可用区，才可挂载。
京东云服务器挂载弹性网卡的数量，不能超过京东云服务器规格的限制。可查询DescribeInstanceTypes接口获得指定规格可挂载弹性网卡的数量上限。
弹性网卡与京东云服务器必须在相同vpc下。copyImagesPOST镜像跨区复制，将私有镜像复制到其它地域下，只允许操作的个人私有镜像。
只支持rootDeviceType为cloudDisk的云硬盘系统盘镜像操作。createImagePOST为京东云服务器购买私有镜像。京东云服务器状态必须为stopped。
京东云服务器没有正在进行中的任务才可制作镜像。
制作镜像以备份系统盘为基础，在此之上可选择全部或部分挂载数据盘制作整机镜像（如不做任何更改将默认制作整机镜像），制作镜像过程会为所挂载云硬盘购买快照并与镜像关联。
调用接口后，需要等待镜像状态变为ready后，才能正常使用镜像。createInstancesPOST购买一台或多台指定配置的京东云服务器，购买模式分为三种：1.普通方式、2.使用高可用组、3.使用启动模板。三种方式购买京东云服务器时参数的必传与非必传是不同的，具体请参考参数详细说明
- 购买京东云服务器需要通过实名认证- 京东云服务器规格 - 可查询DescribeInstanceTypes接口获得指定地域或可用区的规格信息。 - 不能使用已下线、或已售馨的规格ID- 镜像 - Windows Server 2012 R2标准版 64位 中文版 SQL Server 2014 标准版 SP2内存需大于1GB； - Windows Server所有镜像CPU不可选超过64核CPU。 - 可查询DescribeImages接口获得指定地域的镜像信息。 - 选择的镜像必须支持选择的京东云服务器规格。可查询DescribeImageConstraints接口获得指定镜像的京东云服务器规格限制信息。
- 网络配置 - 指定主网卡配置信息 - 必须指定subnetId - 可以指定elasticIp规格来约束购买的弹性IP，带宽取值范围[1-100]Mbps，步进1Mbps - 可以指定主网卡的内网主IP(primaryIpAddress)，此时maxCount只能为1 - 安全组securityGroup需与子网Subnet在同一个私有网络VPC内 - 一台京东云服务器购买时必须指定一个安全组，至多指定5个安全组，如果没有指定安全组，默认使用默认安全组 - 主网卡deviceIndex设置为1- 存储 - 系统盘 - 磁盘分类，系统盘支持local或cloud - 磁盘大小 - local：不能指定大小，默认为40GB - cloud：取值范围: 40-500GB，并且不能小于镜像的最小系统盘大小，如果没有指定，默认以镜像中的系统盘大小为准 - 自动删除 - 如果是local，默认自动删除，不能修改此属性 - 如果是cloud类型的按配置计费的云硬盘，可以指定为True - 数据盘 - 磁盘分类，数据盘仅支持cloud - 云硬盘类型可以选择ssd.gp1、ssd.io1或hdd.st1 - 磁盘大小 云硬盘容量范围[20,16000]GB，步长为10G - 自动删除 - 默认自动删除，如果是包年包月的数据盘或共享型数据盘，此参数不生效 - 可以指定SnapshotId购买云硬盘 - 可以从快照购买磁盘 - local类型系统的京东云服务器可以挂载8块云硬盘 - cloud类型系统的京东云服务器可以挂载7块云硬盘- 计费 - 弹性IP的计费模式，如果选择按用量类型可以单独设置，其它计费模式都以主机为准 - 云硬盘的计费模式以主机为准- 其他 - 购买完成后，主机状态为running - 仅Linux系统京东云服务器可以指定密钥 - maxCount为最大努力，不保证一定能达到maxCount - 虚机的az会覆盖磁盘的az属性- 密码 - 参考公共参数规范createKeypairPOST购买ssh密钥对。公钥部分存储在京东云服务器，并返回未加密的 PEM 编码的 PKCS#8 格式私钥，只有一次机会保存的私钥。请妥善保管。
若传入已存在的密钥名称，会返回错误。deleteImageDELETE删除一个私有镜像，只允许操作的个人私有镜像。
若镜像已共享给其他用户，需先取消共享才可删除。deleteInstanceDELETE删除按配置计费、或包年包月已到期的单个京东云服务器。不能删除没有计费信息的京东云服务器。
京东云服务器状态必须为运行running、停止stopped、错误error，同时京东云服务器没有正在进行中的任务才可删除。
包年包月未到期的京东云服务器不能删除。
如果主机中挂载的数据盘为按配置计费的云硬盘，并且不是共享型云硬盘，并且AutoDelete属性为true，那么数据盘会随主机一起删除。敏感操作，可开启MFA操作保护deleteKeypairDELETE删除ssh密钥对。describeImageGET查询镜像详情。describeImageConstraintsGET查询镜像的京东云服务器规格限制。
通过此接口可以查看镜像不支持的京东云服务器规格。只有官方镜像、第三方镜像有京东云服务器规格的限制，个人的私有镜像没有此限制。describeImageConstraintsBatchGET批量查询镜像的京东云服务器规格限制。
通过此接口可以查看镜像不支持的京东云服务器规格。只有官方镜像、第三方镜像有京东云服务器规格的限制，个人的私有镜像没有此限制。describeImageMembersGET查询镜像共享帐户列表，只允许操作的个人私有镜像。describeImagesGET查询镜像信息列表。
通过此接口可以查询到京东云服务器官方镜像、第三方镜像、私有镜像、或其他用户共享给的镜像。
此接口支持分页查询，默认每页20条。describeInstanceGET查询一台京东云服务器的详细信息describeInstancePrivateIpAddressGET批量查询京东云服务器内网IP地址，查询的是主网卡内网主IP地址。describeInstanceStatusGET批量查询京东云服务器状态describeInstanceTypesGET查询京东云服务器规格信息列表describeInstanceVncUrlGET获取京东云服务器vnc，用于连接管理京东云服务器。
vnc地址的有效期为1个小时，调用接口获取vnc地址后如果1个小时内没有使用，vnc地址自动失效，再次使用需要重新获取。describeInstancesGET批量查询京东云服务器的详细信息
此接口支持分页查询，默认每页20条。describeKeypairsGET批量查询密钥对。
此接口支持分页查询，默认每页20条。describeQuotasGET查询配额，支持：京东云服务器、镜像、密钥、模板、镜像共享detachDiskPOST京东云服务器缷载数据盘，京东云服务器和云硬盘没有正在进行中的任务时才可缷载。
detachNetworkInterfacePOST京东云服务器缷载一块弹性网卡。
京东云服务器状态必须为running或stopped状态，并且没有正在进行中的任务才可操作。
不能缷载主网卡。disassociateElasticIpPOST京东云服务器解绑弹性公网IP，解绑的是主网卡、内网主IP对应的弹性公网IP。importKeypairPOST导入由其他工具生成的密钥对的公钥部分。
若传入已存在的密钥名称，会返回错误。modifyImageAttributePOST修改镜像信息，包括名称、描述；只允许操作的个人私有镜像。modifyInstanceAttributePOST修改京东云服务器部分信息，包括名称、描述。modifyInstanceDiskAttributePOST修改京东云服务器挂载的数据盘属性，包括是否随主机删除。modifyInstanceNetworkAttributePOST修改虚机弹性网卡属性，包括是否随京东云服务器一起删除。
不能修改主网卡。modifyInstancePasswordPOST修改京东云服务器密码，主机没有正在进行中的任务时才可操作。
修改密码后，需要重启京东云服务器后生效。rebootInstancePOST重启单个京东云服务器，只能重启running状态的京东云服务器，京东云服务器没有正在进行中的任务才可重启。rebuildInstancePOST京东云服务器使用指定镜像重置京东云服务器系统
京东云服务器的状态必须为stopped状态。
若当前京东云服务器的系统盘类型为local类型，那么更换的镜像必须为localDisk类型的镜像；同理若当前京东云服务器的系统盘为cloud类型，那么更换的镜像必须为cloudDisk类型的镜像。可查询DescribeImages接口获得指定地域的镜像信息。
若不指定镜像ID，默认使用当前主机的原镜像重置系统。
指定的镜像必须能够支持当前主机的京东云服务器规格(instanceType)，否则会返回错误。可查询DescribeImageConstraints接口获得指定镜像支持的系统盘类型信息。resizeInstancePOST京东云服务器变更京东云服务器规格
京东云服务器的状态必须为stopped状态。
16年购买的云硬盘做系统盘的主机，一代与二代京东云服务器规格不允许相互调整。
本地盘(local类型)做系统盘的主机，一代与二代京东云服务器规格不允许相互调整。
使用高可用组(Ag)购买的主机，一代与二代京东云服务器规格不允许相互调整。
云硬盘(cloud类型)做系统盘的主机，一代与二代京东云服务器规格允许相互调整。
如果当前主机中的弹性网卡数量，大于新京东云服务器规格允许的弹性网卡数量，会返回错误。可查询DescribeInstanceTypes接口获得指定地域及可用区下的京东云服务器规格信息。
当前主机所使用的镜像，需要支持要变更的目标京东云服务器规格，否则返回错误。可查询DescribeImageConstraints接口获得指定镜像的京东云服务器规格限制信息。
京东云服务器欠费或到期时，无法更改京东云服务器规格。shareImagePOST共享镜像，只允许操作的个人私有镜像，单个镜像最多可共享给20个京东云服务器帐户。
整机镜像目前不支持共享。startInstancePOST启动单个京东云服务器，只能启动stopped状态的京东云服务器，京东云服务器没有正在进行中的任务才可启动。
只能启动正常计费状态的京东云服务器。stopInstancePOST停止单个京东云服务器，只能停止running状态的京东云服务器，京东云服务器没有正在进行中的任务才可停止unShareImagePOST取消共享镜像，只允许操作的个人私有镜像。