功能介绍

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

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

调试

您可以在API Explorer中调试该接口。

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	Array of objects	是	待修改的弹性云服务器ID信息，详情请参见 表3。

表3 servers字段数据结构说明

参数	参数类型	是否必选	描述
id	String	是	弹性云服务器ID。

响应消息

响应参数请参见 响应（批量操作类） 所示。

请求示例

批量修改ID为“260a0917-f7df-4b25-93ac-950da6c6b5d6”和“f6d8df1a-e257-48e2-b617-1dd92ced8c20”的云服务器的名称为“new-server-name”。

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" 
               }
              ]
}

响应示例

响应示例请参见 响应（批量操作类）所示。

{      
    "response": [                   
                  {                     
                    "id": "616fb98f-46ca-475e-917e-2563e5a8cd19"                      
                  },                   
                  {                     
                    "id": "516fb98f-46ca-475e-917e-2563e5a8cd12"                      
                  }                
                 ] 
} 

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 批量操作

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家