云主机 > 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"
}

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