批量修改弹性云服务器 - BatchUpdateServersName
功能介绍
批量修改弹性云服务器信息。
当前仅支持批量修改云服务器名称，一次最多可以修改100台。
调试
您可以在API Explorer中调试该接口。
授权信息
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
|
授权项 |
访问级别 |
资源类型（*为必须） |
条件键 |
别名 |
依赖的授权项 |
|---|---|---|---|---|---|
|
ecs:cloudServers:batchUpdateServersName |
write |
instance * |
- |
ecs:cloudServers:put |
- |
请求消息
请求参数如表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。 |
请求示例
批量修改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"
}
]
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
