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

文档中心

立即注册

导航

云服务器

ModifyVolumeExtraPerformance

最近更新时间：2024.11.01 18:49:26首次发布时间：2023.05.16 09:55:10

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

调试

API Explorer

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

去调试

注意事项

ESSD FlexPL数据盘必须容量大于等于500 GiB时，才能使用ModifyVolumeExtraPerformance接口为云盘配置额外性能。
TSSD_TL0云盘必须容量大于等于100 GiB时，才能使用ModifyVolumeExtraPerformance接口为云盘配置额外性能。

请求参数

名称	类型	是否必填	示例值	描述
Action	String	是	ModifyVolumeExtraPerformance	要执行的操作，取值：ModifyVolumeExtraPerformance。
Version	String	是	2020-04-01	API的版本，取值：2020-04-01。
VolumeId	String	是	vol-cmq1cd6ezvhcitve****	待创建或修改额外性能的所属云盘ID。
ExtraPerformanceTypeId	String	是	IOPS	额外性能的类型，不同的云盘，取值不同，说明如下： ESSD FlexPL数据盘的额外性能取值如下： Balance：均衡型额外性能。 IOPS：IOPS型额外性能。 Throughput：吞吐量型额外性能。说明关于ESSD FlexPL数据盘额外性能的详细介绍，请参见云盘额外性能。 TSSD_TL0云盘仅支持取值`Throughput`，表示为TSSD_TL0云盘配置额外吞吐量，详细介绍，请参见云盘规格-吞吐型SSD云盘
ExtraPerformanceIOPS	Integer	否	100	额外IOPS性能大小，单位为次/秒，各个类型的额外性能取值范围如下： IOPS型额外性能: 0~50000 Balance型额外性能: 0~50000
ExtraPerformanceThroughputMB	Integer	否	100	额外吞吐性能大小，单位为MB/s。说明 ESSD FlexPL数据盘的额外吞吐性能的取值范围为0~650。不同容量的吞吐型SSD云盘，可购买的额外吞吐量不同。您可以调用DescribeMaxExtraPerformanceCanPurchase接口查询当前容量云盘可购买的额外吞吐性能上限，详细介绍，请参见DescribeMaxExtraPerformanceCanPurchase。

返回数据

参数	类型	示例值	说明
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	当前云盘的额外性能功能不可用，请联系管理员。