释放一块按量付费云硬盘
接口功能介绍
释放云硬盘
接口约束
- 当前页面接口为旧版 API,未来根据实际使用情况可能退役,推荐使用新版本接口,新版本接口更加规范,覆盖场景更全。
URI
POST /v4/ecs/volume_delete
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
参数 | 参数类型 | 是否必填 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
resourceID | String | 是 | 资源ID | 4abf5a9e-271c-4b15-bdee-c4187fbe4531 | |
regionID | String | 否 | 资源池ID,您可以调用regionID查看最新的天翼云资源池列表 | 41f64827f25f468595ffa3a5deb5d15d | |
clientToken | String | 否 | 客户端存根,用于保证订单幂等性。要求单个云平台账户内唯一,使用同一个ClientToken值,其他请求参数相同时,则代表为同一个请求。保留时间为24小时 | cbe3840c-bda4-4102-b68f-98c9d7190d69 |
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码(800为成功,900为处理中或失败) | 800 | |
message | String | 失败时的错误描述,一般为英文描述 | Param is null | |
description | String | 失败时的错误描述,一般为中文描述 | 请求为空 | |
returnObj | Object | 返回参数 | returnObj | |
errorCode | String | 业务细分码,为product.module.code三段式码,详见错误码说明 | Ebs.RegionInfo.AccessFailed |
表 returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
masterOrderNO | String | 退订订单号 | 20230720095818973221 | |
regionID | String | 资源池ID | 41f64827f25f468595ffa3a5deb5d15d | |
masterOrderID | String | 退订订单号,可以使用该订单号确认资源的最终退订状态 | 107e901c449611ed8b6a0242ac110002 |
请求示例
{
"resourceID": "4abf5a9e-271c-4b15-bdee-c4187fbe4531",
"regionID": "41f64827f25f468595ffa3a5deb5d15d"
}
响应示例
{
"returnObj": {
"masterOrderNO": "20230720095818973221",
"regionID": "41f64827f25f468595ffa3a5deb5d15d",
"masterOrderID": "107e901c449611ed8b6a0242ac110002"
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
状态码 | 描述 |
---|---|
200 | 表示请求成功。 |
错误码
errorCode | 描述 |
---|---|
Ebs.RegionInfo.AccessFailed | 查询资源池失败 |
Ebs.RegionInfo.Empty | 资源池信息为空 |
Ebs.RegionInfo.DataDamaged | 资源池信息不符预期 |
Ebs.UserPermission.AccessFailed | 查询用户权限失败 |
Ebs.UserPermission.Empty | 用户权限信息为空 |
Ebs.UserPermission.DataDamaged | 用户权限信息不符预期 |
Ebs.UserDetail.AccessFailed | 查询用户详情失败 |
Ebs.UserDetail.Empty | 用户详情信息为空 |
Ebs.UserDetail.DataDamaged | 用户详情信息不符预期 |
Ebs.UserKms.AccessFailed | 查询用户加密密钥信息失败 |
Ebs.UserKms.DataDamaged | 用户加密密钥数据不符预期 |
Ebs.UserQuota.AccessFailed | 查询用户配额失败 |
Ebs.UserQuota.Empty | 用户配额信息为空 |
Ebs.UserQuota.DataDamaged | 用户配额信息不符预期 |
Ebs.ResourceInfo.AccessFailed | 查询资源失败 |
Ebs.ResourceInfo.NotExists | 资源信息不存在 |
Ebs.ResourceInfo.DataDamaged | 资源信息不符预期 |
Ebs.ResourceOrderInfo.AccessFailed | 查询资源订单信息失败 |
Ebs.ResourceOrderInfo.NotExists | 资源订单信息不存在 |
Ebs.ResourceOrderInfo.DataDamaged | 资源订单信息不符预期 |
Ebs.UserConsumption.AccessFailed | 查询用户已用资源量失败 |
Ebs.UserConsumption.Empty | 用户已用资源信息为空 |
Ebs.UserConsumption.DataDamaged | 用户已用资源信息不符预期 |
Ebs.UserResources.AccessFailed | 查询用户资源信息失败 |
Ebs.UserResources.DataDamaged | 用户资源信息不符预期 |
Ebs.UserVisibleRegions.AccessFailed | 查询用户可见资源池失败 |
Ebs.UserVisibleRegions.DataDamaged | 用户可见资源池信息不符预期 |
Ebs.EbsInfo.NotExists | 磁盘不存在 |
Ebs.EbsInfo.AccessFailed | 查询云硬盘信息失败 |
Ebs.EbsInfo.DataDamaged | 云硬盘信息数据不符预期 |
Ebs.SysVolumeInfo.AccessFailed | 查询云硬盘信息失败 |
Ebs.SysVolumeInfo.DataDamaged | 系统盘信息数据不符预期 |
Ebs.VolumeOperate.AccessFailed | 操作网络通讯失败 |
Ebs.VolumeOperate.DataDamaged | 操作结果数据不符预期 |
Ebs.Order.AccessFailed | 订单系统访问失败,可使用clientToken重试订单 |
Ebs.Order.InProgress | 订单处理中,可使用订单ID查询确认或使用原clientToken重试下单 |
Ebs.Order.ProcFailed | 订单处理失败。无需重试。通过errorDetail确认具体失败原因 |
Ebs.Order.OrderChanged | 订单状态变更,比如发生了撤单,取消等。 |
Ebs.Order.Accepted | 订单已成功,资源创建中。可以使用clientToken或者返回的masterOrderID重试订单,以确认订单状态。时不返回masterResourceID及resources |