接口介绍
查询ZOS资源包价格。
接口约束
支持的线上资源池 ：上海7、南京3、南京5、杭州2、合肥2、九江、广州6、武汉4、福州25、厦门3、郴州2、海口2、北京5、雄安2、石家庄20、内蒙6、晋中、辽阳1、西安5、乌鲁木齐4、乌鲁木齐27、中卫5、兰州2、西宁2、拉萨3、昆明2、重庆2、成都4、贵州3、上海33、宁波边缘云、华东1、上海36、南昌5、青岛20、武汉41、长沙42、长沙37、南宁23、北京行业云20、华北2、西南1、上海32。
URI
POST /v4/oss/new-order/query-price
请求参数
请求体 JSON Body 参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| regionID | 是 | String | 区域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| pkgType | 是 | String | 资源包类型 | 可选参数如下：①zosSize（ZOS存储空间包）、②zosMzSize（ZOS多AZ存储空间包）、③zosBytesSend（ZOS流出流量资源包)、④zosRequest（ZOS请求次数包，仅支持自定义规格：即pkgSpecType为defined）、⑤zosRetrievalFlow（ZOS数据取回流量包，仅支持自定义规格：即pkgSpecType为defined，仅支持storageClass为STANDARD_IA（低频存储）和 GLACIER（归档存储）、⑥zosRetrievalFrequency（ZOS数据取回次数包，仅支持自定义规格：即pkgSpecType为defined，仅支持storageClass为STANDARD_IA（低频存储）和 GLACIER（归档存储） |
| pkgSpecType | 是 | String | 资源包规格类型 | 可选参数如下：①fixed（固定规格）②defined（自定义规格） |
| pkgSpec | 是 | Integer | 资源包规格大小，单位：GB。当pkgType选择为请求次数包zosRequest和数据取回次数包zosRetrievalFrequency时，单位为：万次。说明：①当资源包规格为固定包且资源包类型为：ZOS存储空间包 或 ZOS多AZ存储空间包时，可选参数列表如下：[40, 100, 500, 1024, 2048, 5120, 10240, 20480, 51200, 102400, 204800, 307200, 512000, 1048576, 2097152]; ②当资源包规格为固定包且资源包类型为ZOS流出流量资源包时，可选参数列表如下：[50, 100, 300, 500, 1024, 2048, 10240, 30720, 51200, 102400, 307200, 512000, 1048576, 2097152] | 40 |
| cycleCnt | 是 | Integer | 订购周期（最大订购月数：36，最大订购年数：3） | 3 |
| cycleType | 是 | String | 订购周期类型 | 可选参数如下：①month（按月订购）、②year（按年订购） |
| orderNum | 是 | Integer | 订购数量（最大订购数量：50） | 1 |
| storageClass | 是 | String | 存储类型 | 可选参数如下：①STANDARD（标准存储）、②STANDARD_IA（低频存储）、③GLACIER（归档存储） |
响应参数
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回码 取值范围：800 成功 |
800 |
| message | String | 状态描述 | SUCCESS |
| returnObj | Object | 响应对象 | 见下级对象 |
| description | String | 状态描述，一般为中文 | 成功 |
| errorCode | String | 业务细分码，为product.module.code三段式码 | openapi.userPermission.accessFailed |
表returnObj
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| discountPrice | Float | 折后价格 | 28.51 |
| totalPrice | Float | 总价格 | 47.52 |
| subOrderPrices | Array of Objects | 子订单价格信息 | 见下级对象 |
| isSucceed | Boolean | 是否成功 | true |
| finalPrice | Float | 最终价格 | 28.51 |
表subOrderPrices
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| serviceTag | String | 服务类型 | ZOS_PACKAGE |
| totalPrice | Float | 47.52 | 47.52 |
| finalPrice | Float | 28.51 | 28.51 |
| orderItemPrices | Array of Objects | item价格信息 | 见下级对象 |
表orderItemPrices
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| itemId | String | itemId | xxx |
| resourceType | String | 对象存储资源包类型，总共9种类型：①"ZOS_SIZE_DIY": "ZOS自定义存储空间包"②"ZOS_MZ_SIZE_DIY": "ZOS多AZ自定义存储空间包"③"ZOS_BYTES_SEND_DIY": "ZOS自定义流出流量包"④"ZOS_REQUEST_DIY": "ZOS自定义请求次数包"⑤"ZOS_RETRIEVAL_FLOW_DIY": "ZOS自定义数据取回流量包"⑥"ZOS_RETRIEVAL_FREQUENCY_DIY": "ZOS自定义数据取回次数包"⑦"ZOS_MZ_SIZE_P": "ZOS多AZ存储空间资源包"⑧"ZOS_SIZE_P": "ZOS存储空间资源包"⑨"ZOS_BYTES_SEND_P": "ZOS流出流量资源包" | xxx |
| totalPrice | Float | 总价格 | 47.52 |
| finalPrice | Float | 最终价格 | 28.51 |
请求示例
{
"regionID": "332232eb-63aa-465e-9028-52e5123866f0",
"pkgType": "zosBytesSend",
"pkgSpecType": "fixed",
"pkgSpec": 100,
"cycleCnt": 7,
"cycleType": "month",
"orderNum": 1,
"storageType": "standard"
}
响应示例
{
"httpstatus": 200,
"httpresult": {
"returnObj": {
"discountPrice": 28.51,
"totalPrice": 47.52,
"isSucceed": true,
"subOrderPrices": [
{
"serviceTag": "ZOS_PACKAGE",
"totalPrice": 47.52,
"orderItemPrices": [
{
"itemId": "0880eb0f46d411eda5de34800d471016",
"resourceType": "ZOS_SIZE_P",
"totalPrice": 47.52,
"finalPrice": 28.51
}
],
"finalPrice": 28.51
}
],
"finalPrice": 28.51
},
"errorCode": "",
"message": "",
"description": "",
"statusCode": 800
}
}
状态码
| 状态码 | 描述 |
|---|---|
| 800 | 表示请求成功。 |
| 900 | 表示请求失败。 |
错误码
| 错误码 | 描述 |
|---|---|
| Oss.OrderPrice.ResourceTypeError | 资源类型不正确 |
| Oss.OrderPrice.CountNumError | 订购数量不正确 |
| Oss.OrderPrice.CycleCntInvalid | 订购周期不合法 |
| Oss.OrderPrice.CycleTypeError | 订购周期类型错误 |
| Oss.OrderPrice.CycleCntMonthError | 订购周期超过最大月数 |
| Oss.OrderPrice.CycleCntYearError | 订购周期超过最大年数 |
| Oss.OrderPrice.PkgSpecError | 订购规格不正确 |
| Oss.OrderPrice.StorageClassError | 存储类型不正确 |
