文档首页 > > API参考> API(推荐)> 生命周期管理> 修改云服务器

修改云服务器

分享
更新时间: 2019/08/12 20:37

功能介绍

修改云服务器信息,目前支持修改云服务器名称及描述和hostname。

该接口支持企业项目细粒度权限的校验,具体细粒度请参见 ecs:cloudServers:put

URI

PUT /v1/{ project_id }/cloudservers/{server_id}

参数说明如 表1所示。
表1 参数说明

参数

是否必选

描述

project_id

项目ID。

获取方法请参见获取项目ID

server_id

云服务器ID。

请求消息

请求参数如 表2所示。
表2 请求参数

参数

是否必选

参数类型

描述

server

Object

云服务器数据结构。

详情请参见表3

表3 server字段数据结构说明

参数

是否必选

参数类型

描述

name

String

修改后的云服务器名称。

只能由中文字符、英文字母、数字及“_”、“-”、“.”组成,且长度为[1-64]个字符。

description

String

对弹性云服务器的任意描述。

不能包含“<”,“>”,且长度范围为[0-85]个字符。

hostname

String

修改云服务hostname。

命令规范:长度为 [1-64] 个字符,允许使用点号(.)分隔字符成多段,每段允许使用大小写字母、数字或连字符(-),但不能连续使用点号(.)或连字符(-),不能以点号(.)或连字符(-)开头或结尾,不能出现(.-)和(-.)。

响应消息

响应参数请参见 6.2.2 修改云服务器云主机 对返回字段的说明。

请求示例

PUT  https://{endpoint}/v1/2e62dec99940499d93717c2789759015/cloudservers/77616c78-0bc4-4156-b24b-4286586ac350
{
    "server": {
        "name": "new-server-test"
    }
}

响应示例

{
  "server": {
    "tenant_id": "66c860cb130b465fbafcdee43fb09c64",
    "image": "",
    "accessIPv4": "",
    "addresses": {
      "01d7aef8-442b-408e-b82f-13afff51e4e4": [
        {
          "addr": "192.168.26.22",
          "version": 4
        }
      ]
    },
    "metadata": {
      "virtual_env_type": "FusionCompute"
    },
    "accessIPv6": "",
    "created": "2019-04-25T11:52:53Z",
    "hostId": "57d278e7c53d07cd34fad3ba4fdc9f3d779017d0879726d83b45a22a",
    "flavor": {
      "links": [
        {
          "rel": "bookmark",
          "href": "https://None/66c860cb130b465fbafcdee43fb09c64/flavors/s2.large.2"
        }
      ],
      "id": "s2.large.2"
    },
    "OS-DCF:diskConfig": "MANUAL",
    "user_id": "f88581d53be64716a985c66ca28c75f6",
    "name": "new-test-hostname0000",
    "progress": 0,
    "links": [
      {
        "rel": "self",
        "href": "https://None/v2/66c860cb130b465fbafcdee43fb09c64/servers/24930df0-db4c-4a8b-8914-d0bd558564b0"
      },
      {
        "rel": "bookmark",
        "href": "https://None/66c860cb130b465fbafcdee43fb09c64/servers/24930df0-db4c-4a8b-8914-d0bd558564b0"
      }
    ],
    "id": "24930df0-db4c-4a8b-8914-d0bd558564b0",
    "updated": "2019-04-28T08:15:36Z",
    "status": "ACTIVE"
  }
}

返回值

请参考通用请求返回值

错误码

请参考错误码说明

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区