批量修改弹性云服务器
功能介绍
批量修改弹性云服务器信息。
当前仅支持批量修改云服务器名称,一次最多可以修改100台。
请求消息
请求参数如表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。 |
响应消息
响应参数请参见 响应(批量操作类) 所示。
请求示例
批量修改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" } ] }
返回值
请参考通用请求返回值。
错误码
请参考错误码。