ModifyVolumeSpec--云服务器-火山引擎

文档中心

导航

云服务器

ModifyVolumeSpec

最近更新时间：2024.11.01 18:49:26首次发布时间：2023.06.05 16:47:00

调用ModifyVolumeSpec接口变更云盘规格。

注意事项

类别	注意事项
变配前限制	仅云盘状态为“已挂载”、“可用”时，才支持执行云盘变配操作。若云盘处于“已挂载”状态，则相应ECS实例不能处于过期或者账号欠费状态，否则无法执行云盘变配操作。
变配中限制	云盘处于“变配中”状态时，不支持以下操作：扩容、挂载、卸载、删除、修改、退订、迁移、回滚云盘按量计费云盘转包年包月分区格式化云盘创建快照为ECS实例更换操作系统，即重置系统盘
操作限制	执行云盘变配操作后，不支持取消。
计费	变更云盘规格后，云盘的计费规则也会发生变化。更多信息，请参见资源变更计费规则说明。
备份	变更云盘规格前，建议您创建快照，备份云盘数据。具体操作，请参见创建快照。

请求参数

名称	类型	是否必填	示例值	描述
Action	String	是	ModifyVolumeSpec	要执行的操作，取值：ModifyVolumeSpec。
Version	String	是	2020-04-01	API的版本，取值：2020-04-01。
VolumeId	String	是	vol-hwnpjm4gl8jww4u0****	云盘ID。
TargetVolumeType	String	是	ESSD_FlexPL	变更后的云盘规格，当前仅支持将ESSD_PL0云盘变更为ESSD_FlexPL云盘，取值为ESSD_FlexPL。

返回数据

名称	类型	是否必选	示例	描述
VolumeId	String	是	vol-hwnpjm4gl8jww4u0****	云盘ID。说明调用ModifyVolumeSpec接口后，在控制台看到云盘的规格升级为目标变更规格，说明变更云盘规格成功。

请求示例

GET /?Action=ModifyVolumeSpec&Version=2020-04-01&VolumeId=vol-hwnpjm4gl8jww4u0****&TargetVolumeType=ESSD_FlexPL HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
ServiceName: storage_ebs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230605142649C564A0B67D83E433****",
        "Action": "ModifyVolumeSpec",
        "Version": "2020-04-01",
        "Service": "storage_ebs",
        "Region": "cn-beijing"
    },
    "Result": {
        "VolumeId": "vol-hwnpjm4gl8jww4u0****"
    }
}

错误码

HttpCode	错误码	错误信息
400	ErrInvalidCurrentVolumeType	当前云盘类型不支持变更。
400	ErrInvalidTargetVolumeType	不支持变更到目标云盘类型。
412	ErrModifiedWithin7Days	7天内变更过云盘类型。
412	ErrInstanceExpired	对应ECS实例已过期。