云主机

  • 云主机服务 > API 文档 > 镜像 >创建镜像

    创建镜像

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

    请求路径

    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 付费方式
    cost_charge_mode string body 计费方式
    cost_period_unit string body 计费单位
    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"
    }
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close