human: 如何处理七牛云的专有云计算创建主机

gpt: [专有云计算](https://developer.qiniu.com/qec) > API 文档 >
[云主机](https://developer.qiniu.com/qec/api/10639/compute) >
[主机管理](https://developer.qiniu.com/qec/api/10686/the-server) > 创建主机

#  创建主机

最近更新时间: 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
      }
    }
    

以上内容是否对您有帮助？