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

批量修改弹性云服务器

功能介绍

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

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

调试

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

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：发送检查请求，不会修改云服务器名称。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回正常响应信息。

响应结构请参见 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"                      
                  }                
                 ] 
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 批量操作

相关文档