human: 如何处理七牛云的云主机创建镜像

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

#  创建镜像

最近更新时间: 2021-12-16 14:29:01

# 请求路径

> `POST` /v1/vm/image

# 请求参数

名称 | 类型 | 位置 | 必须 | 描述  
---|---|---|---|---  
region_id | string | body | 是 |  地域 ID。 您可以调用 DescribeRegions 查看最新的七牛云地域列表。  
snapshot_id | string | body | 否 |  根据指定的快照创建自定义镜像  
instance_id | string | body | 否 |  实例 ID InstanceID 与 SnapshotID 必须传入一个  
image_name | string | body | 否 |  镜像名称。 长度为 2~128 个英文或中文字符。必须以大小字母或中文开头，不能以 `http://` 和 `https://` 开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。 默认值：空  
image_version | string | body | 否 |  镜像版本号  
description | string | body | 否 |  镜像的描述信息。长度为 2~256 个英文或中文字符，不能以 `http://` 和 `https://` 开头。 默认值：空  
client_token | string | body | 否 |  保证请求幂等性， 客户端生成的一个唯一值  
cost_charge_type | string | body | 是 | 付费方式, 只支持PostPaid  
cost_charge_mode | string | body | 是 | 计费方式, 只支持PayByDisk  
cost_period_unit | string | body | 是 | 计费单位, 可填Hour, 只有根据主机创建镜像时会产生额外的快照费用  
cost_period | integer | body | 否 | 计费周期  
  
# 返回值

名称 | 类型 | 描述  
---|---|---  
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/td> |  是否支持 Cloud Init  
is_support_io_optimized | boolean/td> |  是否可以在 I/O 优化实例上运行  
is_copied | boolean/td> |  是否是拷贝的镜像  
is_subscribed | boolean/td> |  是否订阅了该镜像的商品码对应的镜像商品的服务条款  
snapshot_id | string |  根据某一快照 ID 创建的自定义镜像  
min_disk_size | string |  镜像要求的最小系统盘盘容量  
  
## 返回值示例

    
    
    {
      "data": {
        "region_id": "cn-beijing",
        "created_at": "2020-12-23T16:19:59.85137226+08:00",
        "updated_at": "2020-12-23T16:19:59.85137226+08:00",
        "image_id": "m-2ze8jm3cz10uvrlwlhlf",
        "description": "",
        "product_code": "",
        "os_type": "",
        "architecture": "",
        "os_name": "",
        "image_owner_alias": "",
        "progress": "",
        "usage": "",
        "image_version": "",
        "status": "Creating",
        "image_name": "dw_89_centos_610_sys_disk_20201223",
        "is_self_shared": "",
        "platform": "",
        "size": 0,
        "is_support_cloudinit": false,
        "is_support_io_optimized": false,
        "is_copied": false,
        "is_subscribed": false,
        "disk_device_mappings": null,
        "snapshot_id": "s-2ze4o6q4kz6aio3mew5x",
        "min_disk_size": "",
        "cost_period_unit": "Hour",
        "cost_period": 0,
        "cost_seconds": 0,
        "instance_id": "",
        "root_image_id": "",
        "instance_name": "",
        "cost_charge_type": "PostPaid",
        "cost_charge_mode": "PayByDisk"
      },
      "request_id": "ScKvEYV6XfOsSlMW"
    }
    

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