接口功能介绍
支持修改XSSD类型云硬盘的预配置IOPS。
接口约束
1、仅支持修改XSSD类型云硬盘修改预配置IOPS。
2、最小值固定为1，最大值计算公式为“min(单盘最大IOPS，500*容量) - 基础性能IOPS”。
3、仅“未挂载”、“已挂载”状态的云硬盘支持修改预配置IOPS。
接口是否审批
否
URI
POST /v4/ebs/update-iops-ebs
Content-Type
application/json
路径参数
无
Query参数
无
请求头header参数
无
请求体body参数
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| provisionedIops | 是 | Integer | XSSD类型云硬盘的预配置IOPS值，最小值为1，其他类型的盘不支持设置。具体取值范围如下： ●XSSD-0：（基础IOPS（min{1800+12×容量， 10000}） + 预配置IOPS） ≤ min{500×容量，50000} | 1 | |
| diskID | 是 | String | 云硬盘ID。 | 0ae97ef5-6ee2-44af-9d05-1a509b0a1be6 | |
| regionID | 否 | String | 如本地语境支持保存regionID，那么建议传递。 | 81f7728662dd11ec810800155d307d5b |
响应参数
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为失败)。 | 800 | |
| message | String | 成功或失败时的描述，一般为英文描述。 | region info empty | |
| description | String | 成功或失败时的描述，一般为中文描述。 | 资源池信息为空。 | |
| errorCode | String | 业务细分码，为product.module.code三段式码.参考结果码(#通用结果码)。 | ebs.regionInfo.empty | |
| error | String | 业务细分码，为product.module.code三段式大驼峰码. 请参考结果码(#通用结果码（大驼峰格式）)。 | Ebs.RegionInfo.Empty |
枚举参数
无
请求头header示例
{
}请求url示例
无
请求体body示例
{
""regionID"":""81f7728662dd11ec810800155d307d5b"",
""diskID"":""0ae97ef5-6ee2-44af-9d05-1a509b0a1be6"",
""provisionedIops"":1
}响应示例
{
""message"":""SUCCESS"",
""description"":""成功"",
""statusCode"":800
}状态码
请参考状态码
错误码
请参考错误码
