功能介绍
把磁盘挂载到弹性 云服务器 上。
本接口为异步接口,当前弹性 云服务 器挂载磁盘请求下发成功后会返回job_id,此时弹性云服务器挂载磁盘并没有立即完成,需要通过调用查询任务的执行状态查询job状态,当Job状态为 SUC CES S 时代表弹性云服务器磁盘挂载成功。
调试
您可以在API Explorer中调试该接口。
请求消息
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
volumeAttachment |
是 |
Object |
|
dry_run |
否 |
Boolean |
是否只预检此次请求。
默认值:false |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
volumeId |
是 |
String |
待挂载磁盘的磁盘ID,UUID格式。 |
device |
否 |
String |
磁盘挂载点。 说明:
|
volume_type |
否 |
String |
云硬盘 类型。 该字段于dry_run为true并且volumeId不存在时有效且为必选字段。 |
count |
否 |
Integer |
云硬盘的个数。 该字段于dry_run为true并且volumeId不存在时有效,如果该字段不存在,默认为1。 |
hw:passthrough |
否 |
String |
该字段于dry_run为true并且volumeId不存在时有效且为必选字段。 |
响应消息
请参考响应(任务类)。
请求示例
挂载SCSI类型的云硬盘到云服务器,挂载点为“/dev/sda”。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/attachvolume { "volumeAttachment": { "volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f803", "device": "/dev/sda", "volume_type": "SSD", "count": 5, "hw:passthrough": "true" }, "dry_run": false }
响应示例
{ "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" }
返回值
请参考通用请求返回值。
错误码
请参考错误码。