续订云硬盘备份存储库 API 说明

接口功能介绍

续订云硬盘备份存储库，该接口会涉及计费。

接口约束

无

URI

POST /v4/ebs-backup/repo/renew

路径参数

无

Query参数

无

请求参数

请求头header参数

无

请求体body参数

参数	是否必填	参数类型	说明	示例
clientToken	是	String	用于保证订单幂等性。要求单个云平台账户内唯一。使用同一个ClientToken值，其他请求参数相同时，则代表为同一个请求	4cf2962d-e92c-4c00-9181-cfbb2218636c
regionID	是	String	资源池ID	81f7728662dd11ec810800155d307d5b
repositoryID	是	String	云硬盘备份存储库ID	3df0974e-bbf7-43fa-acc1-af2b69cc184d
cycleType	是	String	本参数表示订购周期类型，取值范围： MONTH：按月 YEAR：按年最长订购周期为3年	MONTH
cycleCount	是	Integer	订购时长，与cycleType配合，cycleType为Month时，单位为月，cycleType为YEAR时，单位为年	1

响应参数

参数	是否必填	类型	描述	示例	下级对象
statusCode	是	Integer	返回状态码（800为成功，900为失败）	800
message	是	String	错误信息的英文描述	SUCCESS
description	是	String	错误信息的本地化描述（中文）	成功
errorCode	否	String	业务错误细分码，发生错误时返回	参考错误码
returnObj	否	Object	成功时返回的数据，参见returnObj对象结构		returnObj

表 returnObj

参数	是否必填	参数类型	说明	示例
masterOrderID	是	String	订单ID。调用方在拿到masterOrderID之后，在若干错误情况下，可以使用materOrderID进一步确认订单状态及资源状态	235145e4489811eda8330242ac110002
masterOrderNO	是	String	订单号	20221010142913884246
regionID	是	String	资源所属资源池ID	81f7728662dd11ec810800155d307d5b

请求示例

请求头header

无

请求体body

{
    "clientToken": "4cf2962d-e92c-4c00-9181-cfbb2218636c",
    "regionID": "81f7728662dd11ec810800155d307d5b",
    "repositoryID": "3df0974e-bbf7-43fa-acc1-af2b69cc184d",
    'cycleType': 'YEAR',
    'cycleCount': 1,
}

响应示例

{
    "returnObj": {
        "masterOrderNO": "20230117110917176751",
        "regionID": "81f7728662dd11ec810800155d307d5b",
        "masterOrderID": "538c8f60961411edb50d0242ac110010"
    },
    "message": "SUCCESS",
    "description": "成功",
    "statusCode": 800
}

错误码

errorCode	描述
EbsBackup.RegionInfo.Empty	查询资源池信息为空或资源池不存在，请确认资源池ID是否有效
EbsBackup.RegionInfo.AccessFailed	查询资源池失败，请重试。如果多次尝试失败，请提交工单
EbsBackup.RegionInfo.DataDamaged	查询资源池信息不符预期，请重试。如果多次尝试失败，请提交工单
EbsBackup.RepositoryInfo.NotFound	云硬盘备份存储库未找到
EbsBackup.Parameter.InvalidRepositoryID	请求参数错误：{错误原因}
EbsBackup.Parameter.InvalidRegionID	请求参数错误：{错误原因}
EbsBackup.Parameter.InvalidCycle	请求参数错误：{错误原因}
EbsBackup.Parameter.InvalidCycleCount	请求参数错误：{错误原因}
EbsBackup.Parameter.InvalidCycleType	请求参数错误：{错误原因}
EbsBackup.Parameter.InvalidClientToken	请求参数错误：{错误原因}
EbsBackup.Order.ProcFailed	订单处理失败：{失败原因}

云硬盘备份

续订存储库