接口功能介绍

扩容云主机备份存储库。

准备工作 ：

构造请求：在调用前需要了解如何构造请求，详情查看构造请求

认证鉴权：openapi请求需要进行加密调用，详细查看认证鉴权

计费模式：确认云主机备份存储库的计费模式，详细查看计费模式

接口约束

1.使用限制，本接口只支持在拉萨3、上海7、广州6、郴州2、长沙3、北京5、内蒙6、南京3、重庆2、合肥2、成都4、晋中、昆明2、乌鲁木齐27、福州25、衡阳3、长沙37、张家界2、华北2、央企北京1、华东1、上海32、上海33、上海36资源池进行公测

2.仅支持升级云主机备份存储库容量

3.只有可用状态才可以进行扩容操作

URI

POST /v4/ecs/backup-repo/upgrade

路径参数

无

Query参数

无

请求参数

请求头header参数

无

请求体body参数

参数	是否必填	参数类型	说明	示例
regionID	是	String	资源池ID，您可以查看地域和可用区来了解资源池获取：查资源池列表查询	bb9fdb42056f11eda1610242ac110002
repositoryID	是	String	云主机备份存储库ID，您可以查看产品定义-存储库来了解存储库获取：查查询存储库列表创创建存储库	508e06e4-1911-4d93-8d3e-16f050aa3e280
clientToken	是	String	客户端存根，用于保证订单幂等性。要求单个云平台账户内唯一，使用同一个ClientToken值，则代表为同一个请求。保留时间为24小时	4cf2962d-e92c-4c00-9181-cfbb2218636c
size	是	Integer	云主机备份存储库的容量（此容量非增量扩容，是指扩容后存储库大小即最终存储库大小），单位GB，取值范围：[100-1024000]，默认值100	150
payVoucherPrice	否	Double	代金券，满足以下规则：两位小数，不足两位自动补0，超过两位小数无效；不可为负数；字段为0时表示不使用代金券	20.55

响应参数

参数	参数类型	说明	示例	下级对象
statusCode	Integer	返回状态码（800 为成功，900 为失败）。	800
errorCode	String	错误码，为product.module.code三段式码	Openapi.PatternCheck.NotValid
error	String	错误码，为product.module.code三段式码	Openapi.PatternCheck.NotValid
message	String	失败时的错误描述，一般为英文描述	Param is null
description	String	失败时的错误描述，一般为中文描述	请求为空
returnObj	Object	返回参数		returnObj

表 returnObj

参数	参数类型	说明	示例
masterOrderID	String	主订单ID。调用方在拿到masterOrderID之后，可以使用materOrderID进一步确认订单状态及资源状态	0b9002eaa2f911ed817c0242ac110002
masterOrderNO	String	订单号	20230203092331682161
regionID	String	资源池ID	bb9fdb42056f11eda1610242ac110002

请求示例

请求头header

无

请求体body

示例：在华东1资源池将一个云主机备份存储库容量扩大到150GB
{
	"regionID": "bb9fdb42056f11eda1610242ac110002",
	"repositoryID": "508e06e4-1911-4d93-8d3e-16f050aa3e280",
	"size": 150,
	"clientToken": "sdasfsdfsdfdsfwtkk"
}

响应示例

{
	"returnObj": {
		"masterOrderNO": "20230203092331682161",
		"regionID": "bb9fdb42056f11eda1610242ac110002",
		"masterOrderID": "0b9002eaa2f911ed817c0242ac110002"
	},
	"message": "SUCCESS",
	"description": "成功",
	"statusCode": 800
}

状态码

状态码	描述
200	表示请求成功

错误码

错误码	描述
Openapi.PatternCheck.NotValid	请求参数不合法
EcsBackup.RegionInfo.Empty	查询资源池信息为空或资源池不存在，请确认资源池ID是否有效
EcsBackup.UserVisibleRegions.AccessFailed	查询用户可见资源池失败
EcsBackup.RegionInfo.AccessFailed	查询资源池失败
EcsBackup.RepositoryCheck.SizeNotValid	云主机备份存储库容量不合法
EcsBackup.Repository.NotFound	未找到备份库信息
EcsBackup.RepoOrderCheck.OnlySupportUpgrade	仅支持升级云主机备份存储库容量
EcsBackup.RepoOrderCheck.RepoFreeze	云主机备份存储库已冻结
EcsBackup.RepoOrderCheck.RepoExpired	云主机备份存储库已到期
EcsBackup.RepoOrderCheck.NotSupportOnDemand	不支持调整按需存储库
EcsBackup.Order.ProcFailed	订单处理失败