文档中心 API中心 状态管理 云服务器创建快照
在这篇文章中：

    云服务器创建快照

    功能介绍

    用云服务器创建一个镜像，后续可以使用该快照创建新的云服务器。

    接口约束

    error状态的云服务器无法用于创建快照。

    URI

    POST /v2.1/servers/{server_id}/action

    参数说明

    参数 是否必选 描述
    server_id 是 云服务器ID。

    请求消息

    请求参数

    参数 是否必选 参数类型 描述
    createImage 是 Object 云服务器导出镜像，详情见表1。

    表1 createImage参数信息
    | 参数 | 是否必选 | 参数类型 | 描述 |
    | ——– | ——– | ——– | —————————————- |
    | name | 是 | String | 镜像名称，长度大于0小于243字节 |
    | metadata | 否 | Object | 镜像属性，属性名称的长度大于0小于255字节 |

    响应消息

    无

    请求示例

    1
    POST https://{endpoint}/v2.1/servers/{server_id}/action
    1
    2
    3
    4
    5
    6
    7
    8
    9
    {
       "createImage" : {
            "name" : "new-image-name",
            "metadata": {
                "ImageType": "Gold",
                "ImageVersion": "2.0"
            }
        }
    }

    响应示例

    无

    返回值

    请参考通用请求返回值。