专有云计算

    • 专有云计算 > API 文档 > 云主机 > 主机管理 > 创建主机

    创建主机

    最近更新时间: 2023-03-15 15:37:14

    请求路径

    POST /api/rio/v1/compute/server

    请求参数

    名称 类型 位置 必须 描述
    x-rio-zone-id string header 是 区域 ID
    image_id string body 是 镜像 ID，启动实例时选择的镜像资源。您可以通过 DescribeImages 查询您可以使用的镜像资源。
    flavor_id string body 是 实例的资源规格ID。
    flavor_name string body 否 实例的资源规格名称。flavor_id 和 flavor_name 两者中必传一个
    security_group_id string body 是 指定新创建实例所属于的安全组 ID。同一个安全组内的实例之间可以互相访问，一个安全组能容纳的实例数量视安全组类型而定，具体请参见使用限制的安全组章节。
    v_switch_id string body 否 虚拟交换机ID。如果您创建的是VPC类型ECS实例，必须指定虚拟交换机ID，且安全组和虚拟交换机在同一个专有网络VPC中。
    server_name string body 否 实例的名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以 http:// 和 https:// 开头。可以包含数字、半角冒号（:）、下划线（_）、英文句号（.）或者连字符（-）。如果没有指定该参数，默认值为实例的ServerId。
    host_name string body 否 云服务器的主机名。
    • 英文句号（.）和短横线（-）不能作为首尾字符，更不能连续使用。
    • Windows实例：字符长度为2~15，不支持英文句号（.），不能全是数字。允许大小写英文字母、数字和短横线（-）。
    • 其他类型实例（Linux等）：字符长度为2~64，支持多个英文句号（.），英文句号之间为一段，每段允许大小写英文字母、数字和短横线（-）。
    description string body 否 实例的描述。长度为 2~256 个英文或中文字符，不能以 http:// 和 https:// 开头。
    password string body 否 实例的密码。长度为 8 至 30 个字符，必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是: ()`~!@#$%^&*-_+=|{}[]:;’<>,.?/ 其中，Windows实例不能以斜线号（/）为密码首字符。注意：如果传入 Password 参数，建议您使用 HTTPS 协议发送请求，避免密码泄露。password和key_pair_name不可以同时为空
    user_data string body 否 实例自定义数据，需要以 Base64 方式编码，原始数据最多为16KB。
    key_pair_name string body 否 密钥对名称。password和key_pair_name不可以同时为空
    • Windows实例，忽略该参数。默认为空。即使填写了该参数，仍旧只执行Password的内容。
    • Linux实例的密码登录方式会被初始化成禁止。为提高实例安全性，强烈建议您使用密钥对的连接方式。
    vpcid string body 是 VPC ID
    system_disk ServerDiskArgs body 是 系统盘
    data_disks []*ServerDiskArgs body 否 数据盘
    eip *IPInfo body 否 EIP 信息
    client_token string body 否 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。

    ServerDiskArgs 磁盘参数

    名称 类型 必须 描述
    size int 是 ServerDiskArgs 创建主机云盘参数磁盘大小单位 Gb
    category string 是 磁盘类别
    • cloud : 普通云盘
    • cloud_ssd : SSD 云盘
    snapshot_id string 否 快照 ID
    disk_name string 否 磁盘名称
    description string 否 磁盘描述
    delete_with_server bool 否 是否和主机一起删除

    返回值

    名称 类型 描述
    request_id string 请求 ID
    data ServerInfo 主机信息

    ServerInfo 主机信息

    名称 类型 描述
    server_id string 主机 ID
    server_name string 主机名
    description string 主机描述
    zone_id string 区域 ID
    status string 主机状态
    hostname string 网络主机域名
    tags []TagInfo 标签
    image ServerImageInfo 主机镜像信息
    flavor ServerFlavorInfo 主机规格信息
    vpc []ServerVPCInfo 主机网络信息
    disks []ServerDiskInfo 主机磁盘信息
    security_groups []ServerSecurityGroupInfo 主机安全组绑定信息
    key_pair_name string 主机密钥对名称
    expired_at int64 主机过期时间
    created_at int64 主机创建时间

    TagInfo 标签参数

    名称 类型 描述
    key string 键名称
    value string 值

    ServerImageInfo 主机镜像信息

    名称 类型 描述
    image_id string 镜像 ID
    image_name string 名称
    os_type string 操作系统类型：
    • linux
    • windows
    os_name string 系统名称

    ServerFlavorInfo 主机规格信息

    名称 类型 描述
    flavor_id string 主机规格 ID
    flavor_name string 主机规格名称
    cpu int64 主机 CPU 核数
    memory int64 主机内存大小 单位 MB
    gpu_spec string 实例规格附带的 GPU 类型。
    gpu_amount int64 实例规格附带的 GPU 数量。

    ServerVPCInfo 专有网络信息

    名称 类型 描述
    private_ip_address string 专有网络 IP 地址
    vpc_id string 专有网络 ID
    vpc_name string 专有网络名称
    v_switch_id string 交换机 ID
    v_switch_name string 交换机名称
    eip_info EIPInfo EIP 信息

    ServerEIPInfo 信息

    名称 类型 描述
    eip_id string EIP ID
    eip_name string 名称
    ip_address string IP 地址
    bandwidth integer 带宽，单位：Mbps

    ServerDiskInfo 主机磁盘信息

    名称 类型 描述
    id string 磁盘 ID
    size int 磁盘大小单位 GB
    is_boot bool 是否是系统盘

    ServerSecurityGroupInfo 主机安全组信息

    名称 类型 描述
    security_group_id string 安全组 ID
    security_group_name string 安全组名称

    IPInfo EIP 信息

    名称 类型 描述
    eip_name string EIP 名称
    bandwidth int 带宽
    mno string IP 运营商: china_mobile china_unicom china_telecom

    请求示例

    POST /api/rio/v1/compute/server

    {
	"image_id": "e7bdbb6c-748f-4d6a-8812-aac7a69a325f",
	"flavor_id": "05b3c54e-6eb7-4cfe-9334-22b6e93e85a6",
	"flavor_name":"2C4G",
	"security_group_id": "default",
	"server_name": "test",
	"password": "123456",
	"vpcid": "b46dfd3a-9ae3-4122-b4de-c1f83d41fb82",
	"system_disk": {
		"size": 40,
		"category": "cloud"
	}

}

    返回值示例

    {
  "request_id": "ioRxAiQr-nhiKs0W",
  "data": {
    "server_id": "d183cbf6-0871-4c00-a0f4-90c901f832b7",
    "server_name": "",
    "description": "",
    "zone_id": "",
    "status": "N/A",
    "hostname": "",
    "tags": [],
    "image": {
      "image_id": "",
      "image_name": "",
      "os_type": "N/A",
      "os_name": ""
    },
    "flavor": {
      "flavor_id": "",
      "flavor_name": "",
      "cpu": 0,
      "memory": 0
    },
    "vpc": [],
    "disks": [],
    "security_groups": [],
    "key_pair_name": "",
    "expired_at": 0,
    "created_at": 0
  }
}
    以上内容是否对您有帮助？
    • Qvm free helper
    Close