重建弹性云服务器

功能介绍

重建弹性云服务器。

在不影响数据盘的情况下，支持使用原镜像或其他镜像重新创建弹性云服务器，也就是说，该接口支持更换操作系统。

该接口为社区原生接口，当前接口为保持defcore测试。

如需重装或切换操作系统，推荐使用ECS接口，详情请参见重装弹性云服务器操作系统（安装Cloud-init）和切换弹性云服务器操作系统（安装Cloud-init）。

接口约束

error状态的弹性云服务器无法重建。
重建弹性云服务器时，不支持设置密码。

URI

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

参数说明如表1所示。

表1 参数说明
参数	是否必选	描述
project_id	是	项目ID。获取方法请参见获取项目ID。
server_id	是	云服务器ID。

请求消息

请求参数如表2所示。

表2 请求参数
参数	是否必选	参数类型	描述
rebuild	是	Object	重建弹性云服务器，参考表3。

表3 rebuild参数信息
参数	是否必选	参数类型	描述
name	否	String	重建后弹性云服务器的名称。长度大于0小于255字节。
metadata	否	Object	重建后弹性云服务器的元数据。
imageRef	是	String	镜像ID或者镜像URL。
adminPass	否	String	重建的弹性云服务器密码，不生效。
OS-DCF:diskConfig	否	String	不支持。
preserve_ephemeral	否	Boolean	是否保留临时磁盘，不支持。

响应消息

响应参数如表4所示。

表4 响应参数
参数	参数类型	描述
status	String	弹性云服务器状态，包括ACTIVE、REBOOT、HARD_REBOOT、REBUILD、MIGRATING、BUILD、SHUTOFF、RESIZE、VERIFY_RESIZE、ERROR、DELETED 弹性云服务器状态说明请参考云服务器状态。
updated	String	弹性云服务器更新时间
hostId	String	弹性云服务器所属host ID
addresses	Array of objects	弹性云服务器的网络属性
links	Array of objects	弹性云服务器自描述信息
image	Object	弹性云服务器镜像信息，对于从卷启动的弹性云服务器，该字段的值为空
flavor	Object	弹性云服务器规格信息
id	String	弹性云服务器ID，UUID格式。
user_id	String	创建弹性云服务器的用户uuid
name	String	弹性云服务器名称
tenant_id	String	弹性云服务器所属租户uuid
OS-DCF:diskConfig	String	扩展属性， diskConfig的类型 MANUAL，镜像空间不会扩展。 AUTO，系统盘镜像空间会自动扩展为与flavor大小一致。
accessIPv4	String	已废弃
accessIPv6	String	已废弃
progress	String	弹性云服务器进度
metadata	Object	弹性云服务器元数据

请求示例

使用镜像“3ed456f5-3d8f-4383-a6c9-312032afcd1a”重建云服务器。

POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/action

{
    "rebuild" : {
        "imageRef" : "3ed456f5-3d8f-4383-a6c9-312032afcd1a",
        "name" : "rebuildName",
       "metadata" : {
            "rebuild" : "rebuild vm"
        }
    }
}

响应示例

{
    "server": {
        "tenant_id": "7459f9935ed2422eb9800fea1d4d9378",
        "image": {
            "links": [
                {
                    "rel": "bookmark",
                    "href": "https://xxx/7459f9935ed2422eb9800fea1d4d9378/images/3ed456f5-3d8f-4383-a6c9-312032afcd1a"
                }
            ],
            "id": "3ed456f5-3d8f-4383-a6c9-312032afcd1a"
        },
        "accessIPv4": "",
        "addresses": {
            "443dd9e3-c165-4764-ad92-b17fcf12a3eb": [
                {
                    "addr": "192.168.0.119",
                    "version": 4
                }
            ]
        },
        "metadata": {
            "name": "rebuildName"
        },
        "accessIPv6": "",
        "created": "2016-09-19T01:13:26Z",
        "hostId": "fd16ebd9c2629e8595875cc1e1400fa67f392431d7937fcc9cf37671",
        "adminPass": "qGVjnEjY3ZoY",
        "flavor": {
            "links": [
                {
                    "rel": "bookmark",
                    "href": "https://xxx/7459f9935ed2422eb9800fea1d4d9378/flavors/s3.xlarge.1"
                }
            ],
            "id": "s3.xlarge.1"
        },
        "OS-DCF:diskConfig": "MANUAL",
        "user_id": "ed2965d80d394be0b41e56f50ac650ca",
        "name": "rebuildName",
        "progress": 0,
        "links": [
            {
                "rel": "self",
                "href": "https://xxx/v2/7459f9935ed2422eb9800fea1d4d9378/servers/ea681a24-9b24-4f49-98ef-8e1f73acf19e"
            },
            {
                "rel": "bookmark",
                "href": "https://xxx/7459f9935ed2422eb9800fea1d4d9378/servers/ea681a24-9b24-4f49-98ef-8e1f73acf19e"
            }
        ],
        "id": "ea681a24-9b24-4f49-98ef-8e1f73acf19e",
        "updated": "2016-09-19T07:22:05Z",
        "status": "REBUILD"
    }
}