jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的云主机云主机关机

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 实例 >云主机关机

#  云主机关机

最近更新时间: 2020-12-29 14:38:07

# 请求路径

> `POST` /v1/vm/instance/:instance_id/stop

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
instance_id | string | path | 是 | 实例 ID  
region_id | string | body | 是 |  实例所属地域 ID。  
stopped_mode | string | body | 是 |  停止按量付费 ECS 实例后，是否继续计费。取值：

  * `StopCharging`：停止计费。有关 `StopCharging` 生效的条件，请参见按量付费实例停机不收费的停机不收费开启条件章节。
  * `KeepCharging`：继续计费。 默认值：如果您在 ECS 控制台上开启了 VPC 类型实例默认停机不收费（详情请参见开启按量付费实例停机不收费），并符合开启条件，则默认为 `StopCharging`。否则，默认为 `KeepCharging`。

  
force_stop | boolean | body | 否 |  停止实例时的是否强制关机策略。取值范围：

  * `true`：强制关机。
  * `false`（默认）：正常关机流程

  
confirm_stop | boolean | body | 否 |  是否确认关机。仅对 `i1` 型实例规格族生效，且为 `i1` 型的实例规格族的必选参数。默认值：`false`。  
  
# 返回值

关机成功 http 状态码为200

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机更换系统盘

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 实例 >更换系统盘

#  更换系统盘

最近更新时间: 2021-02-26 14:13:16

# 请求路径

> `PUT` /v1/vm/instance/:instance/system_disk

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 |  地域 ID。 您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
instance_id | string | body | 是 |  主机ID  
image_id | string | body | 是 |  镜像 ID，启动实例时选择的镜像资源。您可以通过 DescribeImages 查询您可以使用的镜像资源。  
password | string | body | 否 |  实例的密码。长度为 8 至 30 个字符，必须同时包含大小写英文字母、数字和特殊符号中的三类字符。特殊符号可以是：
    
    
    ()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

其中，Windows 实例不能以斜线号（/）为密码首字符。 @GSE:NOTE: 如果传入 Password 参数，建议您使用 HTTPS
协议发送请求，避免密码泄露。  
password_inherit | boolean | body | 否 |  是否使用镜像预设的密码。使用该参数时，Password 参数必须为空，同时您需要确保使用的镜像已经设置了密码。  
key_pair_name | string | body | 否 |  密钥对名称。

  * Windows 实例，忽略该参数。默认为空。即使填写了该参数，仍旧只执行 Password 的内容。
  * Linux 实例的密码登录方式会被初始化成禁止。为提高实例安全性，强烈建议您使用密钥对的连接方式。

  
system_disk_size | integer | body | 否 |  系统盘大小，单位为 GiB。取值范围：20~500 该参数的取值必须大于或者等于 max{20, ImageSize}。 默认值：max{40, ImageSize}  
client_token | string | body | 否 |  保证请求幂等性， 客户端生成的一个唯一值  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求 ID  
data | Order | 否 | 预付费主机重置系统盘如果需要补差价，则会返回订单信息  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机重置 VNC 密码

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 实例 >重置 VNC 密码

#  重置 VNC 密码

最近更新时间: 2021-02-26 14:51:41

# 请求路径

> `PUT` /v1/vm/instance/:instance_id/vnc_passwd

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
instance_id | string | path | 是 |  云主机实例ID   
region_id | string | body | 是 |  地域 ID。 您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
vnc_password | string | body | 是 |  主机实例 VNC 管理终端连接密码   
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机获取 VNC 登录地址

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 实例 >获取 VNC 登录地址

#  获取 VNC 登录地址

最近更新时间: 2021-02-26 14:54:36

# 请求路径

> `GET` /v1/vm/instance/:instance_id/vnc_url

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
instance_id | string | path | 是 |  云主机实例ID   
region_id | string | body | 是 |  云主机实例所在地域   
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | { vnc_url: string } | VNC 页面地址  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机实例监控信息

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 实例 >实例监控信息

#  实例监控信息

最近更新时间: 2022-10-09 15:12:55

# 请求路径

> `GET` /v1/vm/monitor/instance

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
instance_id | string | query | 是 |  云主机实例ID   
x-qiniu-regionid | string | header | 是 |  云主机实例所在地域   
start_time | int64 | query | 是 |  开始时间，unix 时间戳，单位秒   
end_time | int64 | query | 是 |  结束时间，unix 时间戳，单位秒   
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | { monitor_data: { instance_monitor_data: []ECSMonitorDataItem } } |   
  
### ECSMonitorDataItem

字段 | 类型 | 描述  
---|---|---  
bps_read | int | 实例系统盘读带宽 Byte/s  
bps_write | int | 实例系统盘写带宽 Byte/s  
iops_read | int | 实例系统盘 I/O 读操作 次/s  
iops_write | int | 实例系统盘 I/O 写操作 次/s  
intranet_rx | int | 实例在TimeStamp时刻的Period时间段内，接收的内网数据流量，kbits。  
intranet_tx | int | 实例在TimeStamp时刻的Period时间段内，发送的内网数据流量，kbits。  
intranet_bandwidth | int | 实例的公网带宽，单位时间内的网络流量，kbits/s  
cpu | int | 实例vCPU的使用比例，单位：百分比（%）  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机创建磁盘

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 磁盘 >创建磁盘

#  创建磁盘

最近更新时间: 2020-12-29 15:50:41

# 请求路径

> `POST` /v1/vm/disk

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | query | 是 |  地域 ID。 您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
zone_id | string | body | 是 |  在指定可用区内创建一块按量付费云盘。

  * 如果您不设置 InstanceId，则 ZoneId 为必填参数。
  * 您不能同时指定 ZoneId 和 InstanceId。

  
size | integer | body | 是 |  容量大小，以 GiB 为单位。指定该参数后，其取值必须≥指定快照 ID 的容量大小。取值范围：

  * cloud：5~2000
  * cloud_efficiency：20~32768
  * cloud_ssd：20~32768
  * cloud_essd：20~32768

  
disk_name | string | body | 否 |  云盘名称。长度为 2~128 个英文或中文字符。必须以大小字母或中文开头，不能以 http:// 和 https:// 开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。 默认值：空  
description | string | body | 否 |  云盘描述。长度为 2~256 个英文或中文字符，不能以 http:// 和 https:// 开头。 默认值：空  
encrypted | boolean/td> | body | 否 |  是否加密云盘。默认值：false  
disk_category | string | body | 否 |  数据盘的云盘种类。取值范围：

  * cloud：普通云盘
  * cloud_efficiency：高效云盘
  * cloud_ssd：SSD 云盘
  * cloud_essd：ESSD 云盘 默认值：cloud

  
performance_level | string | body | 否 |  创建一块 ESSD 云盘时，设置云盘的性能等级。取值范围：

  * PL1（默认）：单盘最高随机读写 IOPS 5 万
  * PL2：单盘最高随机读写 IOPS 10 万
  * PL3：单盘最高随机读写 IOPS 100 万 有关如何选择 ESSD 性能等级，请参见 ESSD 云盘。

  
snapshot_id | string | body | 否 |  创建云盘使用的快照。指定该参数后，Size 会被忽略，实际创建的云盘大小为指定快照的大小。2013年7月15日及以前的快照不能用来创建云盘。  
instance_id | string | body | 否 |  创建一块包年包月云盘，并自动挂载到指定的包年包月实例（InstanceId）上。

  * 设置实例 ID 后，会忽略您设置的 ResourceGroupId、Tag.N.Key、Tag.N.Value、ClientToken 和 KMSKeyId 参数。
  * 您不能同时指定 ZoneId 和 InstanceId。 默认值：空，代表创建的是按量付费云盘，云盘所属地由 RegionId 和 ZoneId 确定。

  
client_token | string | body | 否 |  保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。  
cost_charge_type | string | body | 否 | 付费方式  
cost_charge_mode | string | body | 否 | 计费方式  
cost_period_unit | string | body | 否 | 计费单位  
cost_period | integer | body | 否 | 计费周期  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | object{} | 返回数据  
data.disk_id | string | 按量创建返回 ID  
data.order | string | 预付费创建返回订单号  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除磁盘

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 磁盘 >删除磁盘

#  删除磁盘

最近更新时间: 2020-12-29 15:55:44

磁盘列表

# 请求路径

/v1/vm/disk/:disk_id

# HTTP Method

DELETE

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
disk_id | string | path | 是 | 磁盘 ID  
region_id | string | query | 是 | 实例所属的地域 ID  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机挂载磁盘

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 磁盘 >挂载磁盘

#  挂载磁盘

最近更新时间: 2020-12-29 15:58:46

# 请求路径

> `POST` /v1/vm/disk/:disk_id/attach

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 |  地域 ID。 您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
disk_id | string | body | 是 |  磁盘 ID  
instance_id | string | body | 是 |  目标 ECS 实例的 ID。  
delete_with_instance | boolean | body | 否 |  释放实例时，该云盘是否随实例一起释放。

  * true：释放。
  * false：不释放。云盘会转换成按量付费数据盘而被保留下来。 默认值：false

说明：将 delete_with_instance 置为 false 后，一旦 ECS 实例被安全控制，即 operation_locks 中标记了
"lock_peason" : "security"，释放 ECS 实例时会忽略云盘的该属性，被同时释放。  
bootable | boolean | body | 否 |  是否作为系统盘挂载。 默认值：false 说明 设置为 `Bootable=true` 时，目标 ECS 实例必须处于无系统盘状态。  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机卸载磁盘

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 磁盘 >卸载磁盘

#  卸载磁盘

最近更新时间: 2020-12-29 16:00:55

# 请求路径

> `DELETE` /v1/vm/disk/:disk_id/attach

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
disk_id | string | path | 是 | 磁盘 ID  
region_id | string | body | 是 | 实例所属的地域 ID  
instance_id | string | body | 是 | 目标ECS实例的ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机磁盘扩容

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 磁盘 >磁盘扩容

#  磁盘扩容

最近更新时间: 2021-01-12 15:49:39

# 请求路径

> `POST` /v1/vm/disk/:disk_id/resize

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 |  地域 ID。 您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
disk_id | string | path | 是 |  磁盘 ID  
instance_id | string | body | 否 |  目标 ECS 实例的 ID。  
new_size | int64 | body | 是 |  指定的新云盘容量必须比原云盘容量大。  
type | string | body | 否 |  扩容云盘的方式。取值范围：

  * offline：默认，离线扩容，扩容后您必须重启实例以生效。
  * online：在线扩容，无需重启实例即可完成扩容。云盘类型支持高效云盘、SSD云盘和ESSD云盘。

  
client_token | string | body | 否 |  保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。  
  
# 返回值

名称 | 类型 | 是否必须 | 描述  
---|---|---|---  
request_id | string | 是 | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机快照

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 快照

#  快照

最近更新时间: 2021-02-26 11:28:32

请看子页接口文档

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机快照列表

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[快照](https://developer.qiniu.com/qvm/api/7777/snapshot) > 快照列表

#  快照列表

最近更新时间: 2021-02-26 11:45:42

# 请求路径

> `GET` /v1/vm/snapshot

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
page | integer | query | 否 |  页码。默认：1  
size | integer | query | 否 |  分页大小，最大 100。默认 20  
region_id | string | query | 否 |  地域 ID。 您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
snapshot_id | string | query | 否 |  快照 ID。  
snapshot_name | string | query | 否 |  快照名称。  
source_disk_id | string | query | 否 |  源磁盘 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
total | integer | 总数  
page | integer | 页码  
size | integer | 分页大小  
request_id | string | 请求 ID  
data | []Snapshot | 快照列表  
  
### Snapshot

名称 | 类型 | 描述  
---|---|---  
cost_charge_type | string |  付费方式  
cost_charge_mode | string |  计费方式  
region_id | string |  地域 ID  
created_at | string |  创建时间  
updated_at | string |  更新时间  
snapshot_id | string |  快照 ID  
snapshot_name | string |  快照名称  
description | string |  描述  
status | string |  状态

  * progressing: 创建中 
  * accomplished: 创建成功 
  * failed: 创建失败 

  
progress | string |  创建进度  
source_disk_id | string |  源磁盘ID   
source_disk_name | string |  源磁盘名称   
source_disk_type | string |  源磁盘类型,`data` 数据盘 `system` 系统盘   
  
## 返回值示例

    
    
    {
      "data": [
        {
          "_id": "5fca940543c29c4c46b79229",
          "uid": 123,
          "region_id": "cn-shanghai",
          "snapshot_id": "s-uf67**",
          "snapshot_name": "Created from i-uf6**",
          "description": "Created from i-uf6**",
          "status": "accomplished",
          "progress": "100%",
          "source_disk_id": "d-uf62**",
          "source_disk_name": "ox2**",
          "source_disk_type": "system",
          "source_disk_size": 40,
          "created_at": "2020-12-05T03:54:45.826+08:00",
          "updated_at": "2020-12-05T03:54:49.232+08:00"
        }
      ],
      "page": 1,
      "size": 10,
      "total": 18,
      "request_id": "N8cGF3EvRnQOSFMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机快照详情

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[快照](https://developer.qiniu.com/qvm/api/7777/snapshot) > 快照详情

#  快照详情

最近更新时间: 2021-02-26 11:56:01

# 请求路径

> `GET` /v1/vm/snapshot/:snapshot_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
snapshot_id | string | path | 是 | 快照 ID  
region_id | string | query | 是 | 所属地域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | Snapshot | 镜像详情  
  
### Snapshot

名称 | 类型 | 描述  
---|---|---  
cost_charge_type | string |  付费方式  
cost_charge_mode | string |  计费方式  
region_id | string |  地域 ID  
created_at | string |  创建时间  
updated_at | string |  更新时间  
snapshot_id | string |  快照 ID  
snapshot_name | string |  快照名称  
description | string |  描述  
status | string |  状态

  * progressing: 创建中 
  * accomplished: 创建成功 
  * failed: 创建失败 

  
progress | string |  创建进度  
source_disk_id | string |  源磁盘ID   
source_disk_name | string |  源磁盘名称   
source_disk_type | string |  源磁盘类型,`data` 数据盘 `system` 系统盘   
  
## 返回值示例

    
    
    {
      "data": {
        "_id": "5fca940543c29c4c46b79229",
        "uid": 123,
        "region_id": "cn-shanghai",
        "snapshot_id": "s-uf67**",
        "snapshot_name": "Created from i-uf6**",
        "description": "Created from i-uf6**",
        "status": "accomplished",
        "progress": "100%",
        "source_disk_id": "d-uf62**",
        "source_disk_name": "ox2**",
        "source_disk_type": "system",
        "source_disk_size": 40,
        "created_at": "2020-12-05T03:54:45.826+08:00",
        "updated_at": "2020-12-05T03:54:49.232+08:00"
      },
      "request_id": "N8cGF3EvRnQOSFMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机创建快照

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[快照](https://developer.qiniu.com/qvm/api/7777/snapshot) > 创建快照

#  创建快照

最近更新时间: 2021-02-26 11:56:48

# 请求路径

> `POST` /v1/vm/snapshot

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 |  地域 ID。 您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
disk_id | string | body | 是 |  根据指定的磁盘创建快照。  
snapshot_name | string | body | 否 |  快照名称。 长度为 2~128 个英文或中文字符。必须以大小字母或中文开头，不能以 `http://` 和 `https://` 开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。 默认值：空  
description | string | body | 否 |  镜像的描述信息。长度为 2~256 个英文或中文字符，不能以 `http://` 和 `https://` 开头。 默认值：空  
client_token | string | body | 否 |  保证请求幂等性， 客户端生成的一个唯一值  
cost_charge_type | string | body | 否 | 付费方式，目前仅支持 PostPaid  
cost_charge_mode | string | body | 否 | 计费方式，固定为 PayBySnapshot  
cost_period_unit | string | body | 否 | 计费单位  
cost_period | integer | body | 否 | 计费周期  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | Snapshot | 快照  
  
### Snapshot

名称 | 类型 | 描述  
---|---|---  
cost_charge_type | string |  付费方式  
cost_charge_mode | string |  计费方式  
region_id | string |  地域 ID  
created_at | string |  创建时间  
updated_at | string |  更新时间  
snapshot_id | string |  快照 ID  
snapshot_name | string |  快照名称  
description | string |  描述  
status | string |  状态

  * progressing: 创建中 
  * accomplished: 创建成功 
  * failed: 创建失败 

  
progress | string |  创建进度  
source_disk_id | string |  源磁盘ID   
source_disk_name | string |  源磁盘名称   
source_disk_type | string |  源磁盘类型,`data` 数据盘 `system` 系统盘   
  
## 返回值示例

    
    
    {
      "data": {
        "_id": "5fca940543c29c4c46b79229",
        "uid": 123,
        "region_id": "cn-shanghai",
        "snapshot_id": "s-uf67**",
        "snapshot_name": "Created from i-uf6**",
        "description": "Created from i-uf6**",
        "status": "accomplished",
        "progress": "100%",
        "source_disk_id": "d-uf62**",
        "source_disk_name": "ox2**",
        "source_disk_type": "system",
        "source_disk_size": 40,
        "created_at": "2020-12-05T03:54:45.826+08:00",
        "updated_at": "2020-12-05T03:54:49.232+08:00"
      },
      "request_id": "N8cGF3EvRnQOSFMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除快照

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 >
[快照](https://developer.qiniu.com/qvm/api/7777/snapshot) > 删除快照

#  删除快照

最近更新时间: 2021-02-26 11:58:15

# 请求路径

> `DELETE` /v1/vm/snapshot/:snapshot_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
snapshot_id | string | path | 是 | 快照 ID  
region_id | string | query | body | 是 | 实例所属的地域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机镜像详情

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 镜像 >镜像详情

#  镜像详情

最近更新时间: 2020-12-29 16:13:46

# 请求路径

> `GET` /v1/vm/image/:image_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
image_id | string | path | 是 | 镜像 ID  
region_id | string | query | 是 | 实例所属的地域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | Image | 镜像详情  
  
### Image

名称 | 类型 | 描述  
---|---|---  
cost_charge_type | string |  付费方式  
cost_charge_mode | string |  计费方式  
region_id | string |  实例所属的地域 ID。  
created_at | string |  创建时间  
updated_at | string |  更新时间  
instance_id | string |  实例 ID  
instance_name | string |  实例名称  
image_id | string |  镜像 ID  
image_name | string |  镜像的名称  
description | string |  镜像描述  
os_type | string |  操作系统类型。可能值：windows, linux  
os_name | string |  操作系统的中文显示名称。  
architecture | string |  镜像的体系架构。取值范围：`i386`, `x86_64`  
image_owner_alias | string |  镜像来源。取值范围：

  * `system` ：七牛云提供的公共镜像。
  * `self` ：您创建的自定义镜像。
  * `others` ：其他七牛云用户共享给您的镜像。
  * `marketplace` ：镜像市场提供的镜像。您查询到的云市场镜像可以直接使用，无需提前订阅。您需要自行留意云市场镜像的收费详情。

  
progress | string | 镜像完成的进度，单位为百分比。  
usage | string |  镜像是否已经运行在 ECS 实例中。取值范围：

  * instance：镜像处于运行状态，有 ECS 实例使用。
  * none：镜像处于闲置状态，暂无 ECS 实例使用。

  
image_version | string |  镜像版本  
status | string |  镜像的状态。可能值：

  * UnAvailable：不可用
  * Available：可用
  * Creating：创建中
  * CreateFailed：创建失败

  
is_self_shared | string |  是否共享过该自定义镜像给其他用户  
platform | string |  操作系统平台  
size | integer |  镜像大小，单位 GiB  
is_support_cloudinit | boolean |  是否支持 Cloud Init  
is_support_io_optimized | boolean |  是否可以在 I/O 优化实例上运行  
is_copied | boolean |  是否是拷贝的镜像  
is_subscribed | boolean |  是否订阅了该镜像的商品码对应的镜像商品的服务条款  
snapshot_id | string |  根据某一快照 ID 创建的自定义镜像  
min_disk_size | string |  镜像要求的最小系统盘盘容量  
  
## 返回值示例

    
    
    {
      "data": {
        "region_id": "grand-cn-southwest-2",
        "created_at": "2020-12-14T18:14:17.248+08:00",
        "updated_at": "2020-12-14T18:14:47.078+08:00",
        "image_id": "0ab29702-015d-404e-b51f-026c0b5f3518",
        "description": "",
        "product_code": "",
        "os_type": "linux",
        "architecture": "",
        "os_name": "M-lGBib",
        "image_owner_alias": "self",
        "progress": "100%",
        "usage": "",
        "image_version": "CentOS 8.0 64bit",
        "status": "Available",
        "image_name": "M-lGBib",
        "is_self_shared": "False",
        "platform": "CentOS",
        "size": 2,
        "is_support_cloudinit": false,
        "is_support_io_optimized": false,
        "is_copied": true,
        "is_subscribed": false,
        "disk_device_mappings": null,
        "snapshot_id": "3df4161c-656f-4636-8695-704437d4fd3d",
        "min_disk_size": "",
        "instance_id": "d29c254c-def9-4af0-8541-200616f5c06c",
        "instance_name": "test_hw_guizhou",
        "cost_charge_type": "PostPaid",
        "cost_charge_mode": "PayByDisk"
      },
      "request_id": "N8cGF3EvRnQOSFMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除镜像

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 镜像 >删除镜像

#  删除镜像

最近更新时间: 2020-12-29 16:15:52

# 请求路径

> `DELETE` /v1/vm/image/:image_id

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
image_id | string | path | 是 | 镜像 ID  
region_id | string | query | body | 是 | 实例所属的地域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机密钥对列表

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 秘钥对 >密钥对列表

#  密钥对列表

最近更新时间: 2020-12-29 16:21:47

# 请求路径

> `GET` /v1/vm/keypair

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | query | 是 | 地域 ID。  
key_pair_name | string | query | 否 | 密钥对名称  
key_pair_finger_print | string | query | 否 | 密钥对的指纹  
page | integer | query | 否 | 页码。默认：1  
size | integer | query | 否 | 分页大小，最大100。默认20  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
page | integer | 页码  
size | integer | 分页大小  
total | integer | 密钥对总量  
data | []Keypair | 密钥对列表  
  
### Keypair

名称 | 类型 | 描述  
---|---|---  
id | string | 钥匙对 ID  
key_pair_name | string | 密钥对的名称  
key_pair_finger_print | string | 密钥对的指纹  
private_key_body | string | 密钥对内容  
public_key_body | string | 公钥内容  
created_at | string | 创建时间  
  
## 返回值示例

    
    
    {
      "data": [
        {
          "id": "5fe2c17743c29c0987654321",
          "key_pair_name": "qiuABCDEF",
          "key_pair_finger_print": "177d3456e2263b990987d4601907ee7f",
          "public_key_body": "ssh-rsa AAAAB3NzaC1yc2EBC+in6JUHGUl...pro.local",
          "private_key_body": "",
          "created_at": "2020-12-23T12:03:03.461+08:00"
        },
        {
          "id": "5f2d07033322c20987654321",
          "key_pair_name": "K-PABCDEF",
          "key_pair_finger_print": "2d3c34563a65d7a409879c2b5e3377b2",
          "public_key_body": "ssh-rsa AAAAB3NzaC1yc2aCUYs8Gl7A...kSk2VC+Mi5BbRLCW/Z\n",
          "private_key_body": "",
          "created_at": "2020-08-07T15:47:15.005+08:00"
        }
      ],
      "page": 1,
      "size": 10,
      "total": 2,
      "request_id": "N8cGF7HdV22hUVMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机密钥对详情

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 秘钥对 >密钥对详情

#  密钥对详情

最近更新时间: 2020-12-29 16:25:00

# 请求路径

> `GET` /v1/vm/keypair/:name

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
name | string | path | 是 | 密钥对名称  
region_id | string | query | 是 | 地域 ID。  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
data | Keypair | 密钥对详情  
  
### Keypair

名称 | 类型 | 描述  
---|---|---  
id | string | 钥匙对 ID  
key_pair_name | string | 密钥对的名称  
key_pair_finger_print | string | 密钥对的指纹  
private_key_body | string | 密钥对内容  
public_key_body | string | 公钥内容  
created_at | string | 创建时间  
  
## 返回值示例

    
    
    {
      "data": {
        "id": "5fe2c17743c29c0987654321",
        "key_pair_name": "qiuABCDEF",
        "key_pair_finger_print": "177d3456e2263b990987d4601907ee7f",
        "public_key_body": "ssh-rsa AAAAB3NzaC1yc2EBC+in6JUHGUl...pro.local",
        "private_key_body": "",
        "created_at": "2020-12-23T12:03:03.461+08:00"
      },
      "request_id": "N8cGF7HdV22hUVMW"
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的云主机密钥对导入

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 秘钥对 >密钥对导入

#  密钥对导入

最近更新时间: 2020-12-29 16:27:14

# 请求路径

> `POST` /v1/vm/keypair

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID。  
key_pair_name | string | body | 是 | 密钥对名称  
public_key_body | string | body | 是 | 为空时代表创建，否则是导入  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机删除密钥对

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 秘钥对 >删除密钥对

#  删除密钥对

最近更新时间: 2020-12-29 16:30:51

# 请求路径

> `DELETE` /v1/vm/keypair

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 | 地域 ID。  
key_pair_names | []string | body | 是 | 密钥对名称数组  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机绑定密钥对

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 秘钥对 >绑定密钥对

#  绑定密钥对

最近更新时间: 2020-12-29 16:33:14

# 请求路径

> `POST` /v1/vm/keypair/:name/attach

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
name | string | path | 是 | 密钥对名称  
region_id | string | body | 是 | 地域 ID。  
instances | []object{} | body | 是 | 实例  
instances[n].instance_id | string | body | 是 | 实例 ID  
instances[n].region_id | string | body | 是 | 区域 ID  
password | string | body | 是 | 资源池 2 主机运行状态下绑定密钥需要输入密码  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机解绑密钥对

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 秘钥对 >解绑密钥对

#  解绑密钥对

最近更新时间: 2020-12-29 16:35:06

# 请求路径

> `DELETE` /v1/vm/keypair/:name/attach

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
name | string | path | 是 | 密钥对名称  
region_id | string | body | 是 | 地域 ID  
instances | []object{} | body | 是 | 实例  
instances[n].instance_id | string | body | 是 | 实例 ID  
instances[n].region_id | string | body | 是 | 区域 ID  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的云主机创建安全组

gpt: [云主机](https://developer.qiniu.com/qvm) > API 文档 > 安全组 >创建安全组

#  创建安全组

最近更新时间: 2020-12-29 16:43:21

# 请求路径

> `POST` /v1/vm/sgr

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 |  安全组所属地域 ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
security_group_name | string | body | 否 |  安全组名称。 长度为 2~128 个英文或中文字符。必须以大小字母或中文开头，不能以 http://和 https://开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。 默认值：空。  
description | string | body | 否 |  安全组描述信息。长度为 2~256 个英文或中文字符，不能以 http://和 https://开头。默认值：空。  
vpc_id | string | body | 否 |  安全组所属 VPC ID  
client_token | string | body | 否 |  保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
request_id | string | 请求 ID  
  
以上内容是否对您有帮助？