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

文档中心

立即注册

导航

云服务器

ModifyVolumeExtraPerformance

最近更新时间：2024.07.22 10:32:33首次发布时间：2023.05.16 09:55:10

调用ModifyVolumeExtraPerformance接口为云盘配置额外性能或修改额外性能属性。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

注意事项

仅使用ESSD FlexPL数据盘，且容量大于等于500 GiB时，才能使用ModifyVolumeExtraPerformance接口为云盘配置额外性能或修改额外性能属性。

请求参数

名称	类型	是否必填	示例值	描述
Action	String	是	ModifyVolumeExtraPerformance	要执行的操作，取值：ModifyVolumeExtraPerformance。
VolumeId	String	是	vol-cmq1cd6ezvhcitve****	待创建或修改额外性能的所属云盘ID。
ExtraPerformanceTypeId	String	是	IOPS	额外性能的类型，取值如下： Balance：均衡型额外性能。 IOPS：IOPS型额外性能。 Throughput：吞吐量型额外性能。说明关于额外性能规格详细介绍，请参见云盘额外性能。
ExtraPerformanceIOPS	Integer	否	100	额外IOPS性能大小，单位为次/秒，各个类型的额外性能取值范围如下： IOPS型额外性能: 0~50000 Balance型额外性能: 0~50000
ExtraPerformanceThroughputMB	Integer	否	100	额外吞吐性能大小，单位为MB/s，取值范围为0~650。

返回数据

参数	类型	示例值	说明
OrderNumber	String	Order722545967890640****	订单号。说明返回订单号，说明创建或修改额外性能正在处理中。您可以使用DescribeVolumes查看创建或修改性能是否成功。

请求示例

GET /?Action=ModifyVolumeExtraPerformance&Version=2020-04-01&VolumeId=vol-cmq1cd6ezvhcitve****&ExtraPerformanceTypeId=IOPS&ExtraPerformanceIOPS=10 HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
ServiceName: storage_ebs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20210702183508010225243153072A****",
        "Action": "ModifyVolumeExtraPerformance",
        "Version": "2020-04-01",
        "Service": "storage_ebs",
        "Region": "cn-beijing"
    },
    "Result": {
        "OrderNumber": "Order722545967890640****"
    }
}

错误码

HttpCode	错误码	错误信息
400	InvalidExtraPerformanceType	错误的额外性能类型。
400	InvalidExtraPerformanceValue	错误的额外IOPS或者吞吐量的值。
400	InvalidVolumeTypeForExtraPerformance	该云盘类型不支持创建额外性能。
400	InvalidVolumeKindForExtraPerformance	系统盘不支持创建额外性能。
400	InvalidVolumeSizeForExtraPerformance	该云盘容量不支持创建额外性能。
400	InvalidVolumeStatusForExtraPerformance	该云盘状态不支持创建额外性能。
400	ExtraPerformanceNotAvailableForVolume	当前云盘的额外性能功能不可用，请联系管理员。