批量挂载指定共享盘 - BatchAttachSharableVolumes
功能介绍
将指定的共享磁盘一次性挂载到多个弹性云服务器，实现批量挂载。
本接口为异步接口，当前批量挂载指定共享盘请求下发成功后会返回job_id，此时批量挂载指定共享盘并没有立即完成，需要通过调用查询任务的执行状态 - ShowJob查询job状态，当Job状态为 SUCCESS 时代表指定共享盘批量挂载成功。
接口约束
每台弹性云服务器上已挂载的磁盘总量不超过23张。
调试
您可以在API Explorer中调试该接口。
授权信息
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
ecs:cloudServers:attachSharedVolume | write | instance * |
| - | evs:volumes:use |
URI
POST /v1/{project_id}/batchaction/attachvolumes/{volume_id}
请求消息
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
serverinfo | 是 | Array of objects | 参数解释： 共享磁盘需要挂载的弹性云服务器列表。详细请参见表3。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
server_id | 是 | String | 参数解释： 共享磁盘需要挂载的弹性云服务器ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
device | 否 | String | 参数解释： 磁盘挂载点。 约束限制：
取值范围： 不涉及 默认取值： 不涉及 |
响应消息
响应参数如表4所示。
参数 | 参数类型 | 描述 |
|---|---|---|
job_id | String | 参数解释： 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。如何根据job_id来查询Job的执行状态，请参考查询Job状态。 取值范围： 不涉及 |
异常响应请参考响应（任务类），异常响应要素说明。
请求示例
批量挂载共享数据盘到ID为“a26887c6-c47b-4654-abb5-dfadf7d3f803”和“a26887c6-c47b-4654-abb5-dfadf7d3fa05”的云服务器。
POST https://{endpoint}/v1/{project_id}/batchaction/attachvolumes/{volume_id}
{
"serverinfo": [
{
"server_id": "a26887c6-c47b-4654-abb5-dfadf7d3f803",
"device": "/dev/sdb"
},
{
"server_id": "a26887c6-c47b-4654-abb5-dfadf7d3fa05",
"device": "/dev/sda"
}
]
} 响应示例
{
"job_id": "ff80808288d41e1b018990260955686a"
} 返回值
请参考通用请求返回值。
错误码
请参考错误码。
