更新时间:2025-08-20 GMT+08:00
        
          
          
        
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
  
      
      
      
        
设置云硬盘启动盘标识(废弃)
功能介绍
设置云硬盘启动盘标识。
接口约束
数据盘调用本接口设置bootable后,也不能挂载到云主机作为系统盘使用。
调用方法
请参见如何调用API。
URI
POST /v2/{project_id}/volumes/{volume_id}/action
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| project_id | 是 | String | 项目ID。 获取方法请参见"获取项目ID"。 | 
| volume_id | 是 | String | 云硬盘ID | 
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 | 
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| os-set_bootable | 是 | 标记设置云硬盘启动盘操作。 | 
响应参数
状态码:200
OK
状态码:400
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| error | Error object | 参数解释 出现错误时,返回的错误信息。 取值范围 不涉及。 | 
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| code | String | 参数解释 出现错误时,返回的错误码。 取值范围 错误码和其对应的含义请参考错误码说明。 | 
| message | String | 参数解释 出现错误时,返回的错误消息。 取值范围 不涉及。 | 
请求示例
设置云硬盘为启动盘。
POST https://{endpoint}/v2/{project_id}/volumes/{volume_id}/action
{
  "os-set_bootable" : {
    "bootable" : true
  }
}
  响应示例
状态码:400
Bad Request
{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}
  状态码
| 状态码 | 描述 | 
|---|---|
| 200 | OK | 
| 400 | Bad Request | 
错误码
请参见错误码。
 
    