云主机

  • 创建云主机

    最近更新时间:2018-12-21 15:45:52

    创建一台预付费(包年包月)或者按量付费(还不支持)的云主机实例。创建实例的同时,您需要自行确定实例的操作系统类型、磁盘容量和网络类型等配置。

    镜像

    在创建实例时,必须要选择镜像,确定新创建实例的系统盘配置。基于镜像创建实例后,实例的系统盘即为此镜像的完全克隆。

    • 实例内存为512 MiB时不能使用除Windows Server 1709之外的Windows镜像。
    • 实例内存为4 GiB以上时不能使用32位操作系统的镜像。
    网络配置
    • 专有网络VPC类型实例只能在创建时指定,必须且只能属于一个交换机。
    • 指定 VSwitchId 时,SecurityGroupId 和 VSwitchId 要属于同一个VPC。
    • VSwitchId 和 PrivateIpAddress 同时指定时,PrivateIpAddress 要包含在交换机的CidrBlock之内。
    • PrivateIpAddress 依赖于 VSwitchId,不能单独指定 PrivateIpAddress。
    安全组
    • 安全组需要预先创建。
    • 可以在新创建实例时指定安全组。
    • 在同一个安全组内的实例内网可以相互访问。不同安全组之间默认隔离,不可相互访问,但是可以授权访问。
    • 同一个安全组内的实例数量不能超过1000台。
    存储
    • 不同类型云盘的最大容量不同:
      • 单块高效云盘(cloud_efficiency)容量最大不超过32 TiB(32768 GiB)。
      • 单块SSD云盘(cloud_ssd)容量最大不能超过32 TiB(32768 GiB)。
    • 创建实例时,我们根据您指定的镜像为实例分配一个相应大小的系统盘。系统盘容量必须大于或者等于max{20, ImageSize}。系统盘的种类有高效云盘(cloud_efficiency)、SSD云盘(cloud_ssd)。
    • 一个实例最多添加16块数据盘。数据盘挂载点由系统默认顺序分配,/dev/xvdb开始到/dev/xvdz。

    请求路径

    /v1/instance

    HTTP Method

    POST

    请求参数

    名称 类型 是否必须 描述
    region_id string 实例所属的地域ID。
    image_id string 镜像文件ID,启动实例时选择的镜像资源。
    instance_type string 实例的资源规格。
    vpc_id string 虚拟网络ID。
    vswitch_id string 虚拟交换机ID。
    security_group_id string 指定新创建实例所属于的安全组代码,同一个安全组内的实例之间可以互相访问。
    instance_charge_type string 实例的付费方式。取值范围:
    PrePaid:预付费,包年包月。选择该类付费方式时,您必须确认自己的账号支持余额支付/信用支付,否则将返回 支付失败 的错误提示。
    PostPaid:按量付费。(暂不支持)
    period integer 购买资源的时长,单位为:月。当参数 InstanceChargeType 取值为 PrePaid 时才生效且为必选值。一旦指定了 DedicatedHostId,则取值范围不能超过专有宿主机的订阅时长。取值范围:
    PeriodUnit=Week时,Period取值:{“1”, “2”, “3”, “4”}
    PeriodUnit=Month时,Period取值:{ “1”, “2”, “3”, “4”, “5”, “6”, “7”, “8”, “9”, “12”, “24”, “36”,”48”,”60”}
    period_unit string 购买资源的时长。可选值:Week | Month。

    PeriodUnit 为 Week 时:
    Period 取值 {“1”, “2”, “3”, “4”}
    AutoRenewPeriod 取值 {“1”, “2”, “3”}

    PeriodUnit 为 Month 时:
    Period 取值 { “1”, “2”, “3”, “4”, “5”, “6”, “7”, “8”, “9”, “12”, “24”, “36”,”48”,”60”}
    AutoRenewPeriod 取值 {“1”, “2”, “3”, “6”, “12”}

    默认值:Month
    system_disk object 系统盘配置
    system_disk.category string 系统盘的磁盘种类。取值范围:
    cloud_efficiency:高效云盘
    cloud_ssd:SSD 云盘
    默认值:cloud_efficiency
    system_disk.size integer 系统盘大小,单位为GiB。取值范围:[20, 500]
    该参数的取值必须大于或者等于max{20, ImageSize}。

    默认值:max{40, ImageSize}
    system_disk.name string 系统盘名称。长度为 [2, 128] 个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。
    默认值:空。
    system_disk.description string 系统盘描述。长度为 [2, 256] 个英文或中文字符,不能以 http:// 和 https:// 开头。
    默认值:空。
    zone_id string 实例所属的可用区编号。
    空表示由系统选择,默认值:空。
    instance_name string 实例的名称。长度为 [2, 128] 个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。
    如果没有指定该参数,默认值为实例的InstanceId。
    host_name string 云服务器的主机名。
    点号(.)和短横线(-)不能作为首尾字符,更不能连续使用。
    Windows 实例:字符长度为 [2, 15],不支持点号(.),不能全是数字。允许大小写英文字母、数字和短横线(-)。
    其他类型实例(Linux 等):字符长度为 [2, 64],支持多个点号(.),点之间为一段,每段允许大小写英文字母、数字和短横线(-)。
    password string 实例的密码。长度为 8 至 30 个字符,必须同时包含大小写英文字母、数字和特殊符号。特殊符号可以是()` ~!@#$%^&*-+=|{}[]:;‘<>,.?/。
    其中,Windows 实例不能以斜线号(/)为密码首字符。
    password_inherit boolean 是否使用镜像预设的密码。使用该参数时,Password参数必须为空,同时您需要确保使用的镜像已经设置了密码。
    data_disk object[] 数据盘
    data_disk[n].category string 数据盘n的磁盘种类。取值范围:
    cloud_efficiency:高效云盘
    cloud_ssd:SSD 云盘

    默认值:cloud
    data_disk[n].size integer 第n个数据盘的容量大小,n的取值范围为[1, 16],内存单位为 GiB。取值范围:
    cloud_efficiency:[20, 32768]
    cloud_ssd:[20, 32768]

    该参数的取值必须大于等于参数 SnapshotId 指定的快照的大小。
    data_disk[n].name string 数据盘名称。长度为 [2, 128] 个英文或中文字符。必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含数字、半角冒号(:)、下划线(_)或者连字符(-)。
    默认值:空。
    data_disk[n].description string 数据盘描述。长度为 [2, 256] 个英文或中文字符,不能以 http:// 和 https:// 开头。
    默认值:空。
    data_disk[n].encrypted boolean 数据盘n是否加密。
    默认值:false
    data_disk[n].snapshot_id string 创建数据盘n使用的快照。 指定参数DataDisk.n.SnapshotId后,参数DataDisk.n.Size会被忽略,实际创建的磁盘大小为参数 SnapshotId 的大小。
    data_disk[n].delete_with_instance boolean 表示数据盘是否随实例释放。
    默认值:true
    private_ip_address string 实例私网IP地址。
    该IP地址必须为 VSwitchId 网段的子集网址。
    auto_renew boolean 是否要自动续费。当参数 InstanceChargeType 取值 PrePaid 时才生效。取值范围:
    True:自动续费。
    False(默认):不自动续费。
    auto_renew_period integer 每次自动续费的时长,当参数AutoRenew取值True时为必填。取值范围:1 | 2 | 3 | 6 |12
    client_token string 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。只支持ASCII字符,且不能超过64个字符。
    key_pair_name string 密钥对名称。
    Windows实例,忽略该参数。默认为空。即使填写了该参数,仍旧只执行 Password 的内容。
    Linux实例的密码登录方式会被初始化成禁止。
    eip object 申请弹性公网IP,不需要申请可以不提交此字段
    eip.id string 指定绑定的弹性公网IP的ID,如果不填写已存在的弹性工网IP的ID,则需要填写bandwidth才可以进行申请
    eip.bandwidth integer 带宽。如果不填写带宽,则需要填写弹性工网IP的ID进行IP绑定。
    eip.name string 弹性公网IP名称

    请求参数示例

    {
      "region_id": "cn-beijing",
      "image_id": "centos_7_04_64_20G_alibase_201701015.vhd",
      "instance_type": "ecs.t5-lc2m1.nano",
      "security_group_id": "sg-2zebscni6kr6g9ipepgb",
      "zone_id": "cn-beijing-f",
      "instance_name": "qiniu-instance",
      "host_name": "node1",
      "password": "",
      "password_inherit": false,
      "system_disk": {
        "category": "cloud_efficiency",
        "size":40,
            "name": "systemDisk",
            "description":""
        },
      "data_disk": [
        {
          "category": "cloud_efficiency",
          "size": 100,
          "name": "data1",
          "description": "dataDisk1",
          "encrypted": false,
          "snapshot_id": "",
          "delete_with_instance": true
        },
        {
          "category": "cloud_efficiency",
          "size": 100,
          "name": "data2",
          "description": "dataDisk2",
          "encrypted": true,
          "snapshot_id": "",
          "delete_with_instance": true
        }
      ],
      "vswitch_id": "vsw-2zeg6trfszfjfcco59yby",
      "vpc_id": "vpc-2zeh4jr2v8mqxizorudc0",
      "private_ip_address": "10.0.0.101",
      "instance_charge_type": "PrePaid",
      "period": 1,
      "period_unit": "Month",
      "auto_renew": true,
      "auto_renew_period": 1,
      "client_token": "daf81fdb-1634-4e40-8234-9400b711864f",
      "key_pair_name": "LinkSSH",
      "eip": {
        "id": "",
        "bandwidth": 10,
        "name": "Production"
      }
    }
    

    返回值

    名称 类型 是否必须 描述
    instance_id string 实例ID,是访问实例的唯一标识。

    返回示例

    {
        "instance_id": "i-instanceid1",
        "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
    }
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close