對象存儲資源包詢價
更新時間 2025-06-11 14:55:16
最近更新時間: 2025-06-11 14:55:16
分享文章
接口介紹
查詢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 |
| finalPrice | Float | 最終價格,單位:元 | 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,
"storageClass": "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 | 存儲類型不正確 |