全栈应用服务器

    • 全栈应用服务器 > API 文档 > 创建自定义镜像

    创建自定义镜像

    最近更新时间: 2025-10-30 10:38:30

    描述

    基于现有正在运行中的全栈应用服务器实例，创建镜像。

    创建镜像的操作是异步的，需要通过查询镜像状态来判断是否创建成功。

    创建镜像过程中，会将实例进行关机操作，对实例的可用性造成影响，影响时长与创建镜像的大小相关。

    要求

    1. 全栈应用服务器实例需要是运行中状态

    请求路径

    POST /v1/images

    请求参数

    参数名称 参数类型 是否必填 描述
    instanceID string 是 源全栈应用服务器实例 ID，实例必须处于运行中状态
    regionID string 是 区域 ID，需要与实例的区域 ID 相同
    clientToken string 否 客户端令牌，用于幂等性控制。如果不设置，则不进行幂等性控制
    name string 否 镜像名称。如果参数为空，会被默认设置为 from-[instanceID]，其中 instanceID 为应用服务器实例 ID；如果不为空，内容格式要求：字符长度范围[2,60]，字符编码需要为：字母（大小写）、数字、英文句号（.）、中划线 (-) 组成
    description string 否 镜像描述。最大长度：100 个 UTF8 字符

    限制要求：同一用户下，创建的镜像名称需要唯一。

    请求示例

    POST /v1/images HTTP/1.1
Host: las-api.qiniu.com
Authorization: Qiniu <AccessToken>
Content-Type: application/json

{
    "instanceID": "i-68d395fa3f5b15f06293ee7a",
    "regionID": "ap-southeast-1",
    "clientToken": "770e8400-e29b-41d4-a716-446655442002",
    "name": "test-image",
    "description": "image for test"
}

    响应示例

    HTTP/1.1 202 Accepted
Content-Type: application/json; charset=utf-8

{
    "imageID": "image-68d3fbbd3f5b15106292ee89"
}

    响应字段

    参数 类型 是否为空 说明
    imageID string 否 创建的镜像 ID
    以上内容是否对您有帮助？