更新时间：2026-04-03 GMT+08:00
修改弹性云服务器挂载的单个磁盘信息 - UpdateServerBlockDevice
功能介绍
修改云服务器挂载的单个磁盘信息。
当前仅支持修改delete_on_termination字段。
接口约束
- 不支持修改包年/包月计费模式的磁盘。
- 不支持修改共享盘。
- 不支持修改系统盘。
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
| 授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| ecs:cloudServers:updateServerBlockDevice | write | instance * |
| ecs:cloudServers:put | - |
URI
PUT /v1/{project_id}/cloudservers/{server_id}/block_device/{volume_id}
参数说明请参见表1。
| 参数 | 是否必选 | 描述 |
|---|---|---|
| project_id | 是 | 参数解释： 项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| server_id | 是 | 参数解释： 云服务器ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| volume_id | 是 | 参数解释： 磁盘ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
请求消息
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| block_device | 是 | Object | 参数解释： 更新云服务器挂载的单个磁盘信息，参考表3。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
响应消息
无
请求示例
修改云服务器挂载的磁盘属性为“磁盘随实例释放”。
PUT https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/block_device/{volume_id}
{
"block_device": {
"delete_on_termination": true
}
} 响应示例
无
返回值
请参考通用请求返回值。
错误码
请参考错误码。
父主题： 磁盘管理
