接口介绍
云硬盘名称通常用来标识磁盘,云硬盘创建完成后,您可以修改名称。
接口约束
1、名称符合云硬盘名称命名规则:仅允许英文字母、数字及_或者-,长度为2-63字符,不能以特殊字符开头。
2、“创建中”,“镜像上传中”状态的云硬盘不允许修改名称。
3、系统盘不允许修改名称。
URI
POST /v4/ebs/update-attr
请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
name | 是 | String | 磁盘名称 | 参考请求示例 |
resourceID | 是 | String | 资源ID,订单创建后的返回值。参考云硬盘开通表resources | 参考请求示例 |
regionID | 否 | String | 如本地语境支持保存regionID,那么建议传递0 | 参考请求示例 |
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
statusCode | 是 | Integer | 返回状态码(800为成功,900为失败) | 参考响应示例 |
message | 是 | String | 成功或失败时的描述,一般为英文描述 | 参考响应示例 |
description | 是 | String | 成功或失败时的描述,一般为中文描述 | 参考响应示例 |
errorCode | 是 | String | 业务细分码,为product.module.code三段式码 | 参考响应示例 |
请求示例
请求头header
无
请求体body
{
"resourceID": "eff436e3d44040f1b306ab3a14530f02",
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"name": "mydisk-0002"
}
响应示例
{
"message": "success",
"description": "成功",
"statusCode": 800
}
状态码
状态码 | 描述 |
---|---|
800 | 表示请求成功 |
错误码
请参考通用结果码。