文档首页/弹性云服务器 ECS/API参考/API/批量操作/批量修改弹性云服务器 - BatchUpdateServersName
更新时间：2026-03-19 GMT+08:00
查看PDF
分享

批量修改弹性云服务器 - BatchUpdateServersName

功能介绍

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

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

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

ecs:cloudServers:batchUpdateServersName

write

instance *

-

ecs:cloudServers:put

-

URI

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

参数说明请参见表1。

表1 参数说明

参数

是否必选

描述

project_id

是

参数解释：

项目ID。

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

请求消息

请求参数如表2所示。

表2 请求参数

参数

参数类型

是否必选

描述

name

String

是

参数解释：

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

约束限制：

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

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

取值范围：

不涉及

默认取值：

不涉及

dry_run

Boolean

否

参数解释：

是否预检此次请求。配置为预检时，此次请求不会修改云服务器名称。

约束限制：

不涉及

取值范围：

  • true：预检此次请求，检查项包括是否填写了必需参数、请求格式、业务限制。
    • 如果检查不通过，则返回对应错误。
    • 如果检查通过，则返回正常响应信息。

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

  • false：发送正常请求，不对请求体做预检。

默认值：

false

servers

Array of objects

是

参数解释：

待修改的弹性云服务器ID信息，详情请参见 表3。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

表3 servers字段数据结构说明

参数

参数类型

是否必选

描述

id

String

是

参数解释：

弹性云服务器ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应消息

响应参数如表4所示。

表4 响应参数

参数

参数类型

描述

response

Array of objects

参数解释：

提交请求成功后返回的响应列表，详情请参见response数据结构说明。

取值范围：

不涉及

表5 response数据结构说明

名称

参数类型

描述

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

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题：批量操作