接口介绍
将云硬盘挂载至某一云主机，支持非共享云硬盘和共享云硬盘的挂载。
接口约束
1、云主机挂载云硬盘的数目没有超过配额。一台云主机默认可以挂载1块系统盘、8块数据盘（提交工单可提升配额）。
2、非共享云硬盘只能挂载至1个云主机，共享云硬盘最多挂载至16个云主机。
3、只有“未挂载”状态的云硬盘支持挂载操作，其他状态不支持挂载。不允许挂载系统盘。
4、极速型SSD云硬盘仅支持挂载至vCPU数量至少为16且为6代以上的通用计算增强型和内存优化型云主机，并且一台云主机只允许挂载最多3块极速型SSD云硬盘。
5、磁盘模式为FCSAN的云硬盘不支持挂载至云主机。
6、云硬盘只能挂载至同一区域、同一可用区的云主机上。
7、当共享盘状态为“已挂载”状态时，必须确保该共享盘挂载点还未满，才可以挂载给其他云主机。
8、XSSD类型云硬盘仅支持挂载至8代机及以上规格机型。
URI
POST /v4/ebs/attach
请求参数
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| resourceID | 是 | String | 资源ID，订单创建后的返回值。参考云硬盘开通表resources | 参考请求示例 |
| regionID | 否 | String | 如本地语境支持保存regionID，那么建议传递 | 参考请求示例 |
| instanceUUID | 是 | String | 云主机resourceUUID。多可用区资源池下，云主机和云硬盘必须属于同一可用区下才支持挂载 | 参考请求示例 |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Integer | 返回状态码(800为成功，900为失败) | 参考响应示例 | |
| message | 是 | String | 成功或失败时的描述，一般为英文描述 | 参考响应示例 | |
| description | 是 | String | 成功或失败时的描述，一般为中文描述 | 参考响应示例 | |
| returnObj | 是 | Object | 返回结构体 | 参考响应示例 | returnObj |
| errorCode | 是 | String | 业务细分码，为product.module.code三段式码 | 参考响应示例 |
表 returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| jobID | 是 | String | 异步任务ID，可通过公共接口查询/v4/job/info该jobID来查看异步任务最终执行结果 | 参考响应示例 |
请求示例
请求头header
无
请求体body
{
"resourceID": "eff436e3d44040f1b306ab3a14530f02",
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"instanceUUID": "xxxxxxxxx"
}响应示例
{
"returnObj": {
"jobID": "5a054301-cd1f-4a84-9b78-3d439bc2f106"
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}状态码
| 状态码 | 描述 |
|---|---|
| 800 | 表示请求成功 |
错误码
请参考通用结果码。
