文档首页 > > API参考> API(推荐)> 批量操作> 批量修改弹性云服务器

批量修改弹性云服务器

分享
更新时间: 2019/11/21 GMT+08:00

功能介绍

批量修改弹性云服务器信息。

当前仅支持批量修改云服务器名称,一次最多可以修改1000台。

URI

PUT /v1/{project_id}/cloudservers/server-name

参数说明请参见表1

表1 参数说明

参数

是否必选

描述

project_id

项目ID。

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

请求消息

请求参数如表2所示。

表2 请求参数

参数

参数类型

是否必选

描述

name

String

弹性云服务器修改后的名称。

规则如下:

只能允许包含中文汉字、大小写字母、数字及 "-" 、 "_" 、"." 等特殊字符,长度限制在64个字符以内。

批量修改弹性云服务器名称时,名不会自动按序增加数字尾缀。例如: 三个ECS的名称为test_0001,test_0002,test_0003,批量修改云服务器名称为develop,则修改后3个云服务器名称为develop,develop,develop。

dry_run

Boolean

是否只预检此次请求。

true:发送检查请求,不会修改云服务器名称。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过,则返回对应错误。如果检查通过,则返回正常响应信息。

响应结构请参见 7.5.1 响应 所示。

false:发送正常请求,通过检查后并且执行修改云服务器名称的请求。

默认值:false

servers

列表数据结构

待修改的弹性云服务器ID信息。

表3 servers字段数据结构说明

参数

参数类型

是否必选

描述

id

String

弹性云服务器ID。

响应消息

响应参数请参见 7.5.1 响应 所示。

请求示例

PUT https://{endpoint}/v1/{project_id}/cloudservers/server-name
{
   "name": "new-server-name",
   "dry_run": false,
   "servers": [
               {
                 "id":"260a0917-f7df-4b25-93ac-950da6c6b5d6"  
               },
               {
                 "id":"f6d8df1a-e257-48e2-b617-1dd92ced8c20" 
               }
              ]
}

响应示例

响应示例请参见 7.5.1 响应所示。

返回值

请参考通用请求返回值

错误码

请参考错误码说明

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区