接口功能介绍
云硬盘名称通常用来标识磁盘,云硬盘创建完成后,您可以修改名称。
接口约束
1、名称符合云硬盘名称命名规则:仅允许英文字母、数字及_或者-,长度为2-63字符,不能以特殊字符开头。
2、“创建中”,“镜像上传中”状态的云硬盘不允许修改名称。
3、系统盘不允许修改名称。
URI
POST JSON /v4/ebs/update-attr-ebs
Content-Type
application/json
路径参数
无
Query参数
无
请求头header参数
无
请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
diskName | 是 | String | 磁盘名称。仅允许英文字母、数字及_或者-,长度为2-63字符,不能以特殊字符开头。 | ebs-newspec-test0211v7-change | |
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
{
}
请求体body
{
"regionID":"81f7728662dd11ec810800155d307d5b",
"diskID":"0ae97ef5-6ee2-44af-9d05-1a509b0a1be6",
"diskName":"ebs-newspec-test0211v7-change"
}
响应示例
{
"message": "success",
"description": "成功",
"statusCode": 800
}
状态码
请参考状态码
错误码
请参考错误码