更新时间:2024-04-16 GMT+08:00

批量修改弹性云服务器

功能介绍

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

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

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

返回值

请参考通用请求返回值

错误码

请参考错误码