查询配置价格
更新时间：2026-06-18
描述
查询 RapidFS 实例规格的实时报价。接口将返回当前地域给定容量的预估套餐价格。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/price?action=DescribePrice HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "currency": "CNY",
7 "managedMode": "FullyManaged",
8 "dataSpec": "Capacity",
9 "capacityTiB": 250
10}请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号。 |
| currency | String | 否 | RequestBody参数 | 货币单位，枚举值： • CNY：人民币，默认； • USD：美元。 |
| managedMode | String | 否 | RequestBody参数 | RapidFS 实例部署模式，枚举值： • FullyManaged：全托管部署模式，适合无闲置存储资源、超大规模或追求高稳定性的业务。该模式下，RapidFS 产品完全管理实例，无需用户运维； • MasterManaged：Master 托管部署模式，适合有闲置存储资源、成本敏感且具备一定运维能力的业务。 |
| metaSpec | String | 否 | RequestBody参数 | 元数据规格，当前仅在 MasterManaged 部署模式下生效，枚举值： • M1：适用于文件数在 10 亿，Cache节点上限 50 个，单个Cache节点可挂载数据盘上限 4 个的场景； • M2：适用于文件数在 50 亿，Cache节点上限 400 个，单个Cache节点可挂载数据盘上限 8 个的场景。 |
| dataSpec | String | 否 | RequestBody参数 | 数据规格，当前仅在 FullyManaged 部署模式下生效，枚举值： • Basic：数据性能基线为 100MB/s/TiB； • Capacity：数据性能基线为 200MB/s/TiB； |
| capacityTiB | Int | 否 | RequestBody参数 | FullyManaged 部署模式下必填，表示购买的缓存容量，单位 TiB。不超过 DescribeSpecs 接口返回的可购买的最大容量。 |
返回状态码
成功返回200，失败返回见错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| priceInfos | List<PriceInfo> | 价格信息，见数据类型 PriceInfo |
请求示例
Master 托管 MasterManaged：
Plain Text
1POST /v2/price?action=DescribePrice HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "managedMode" : "MasterManaged",
6 "metaSpec": "M1"
7}全托管 FullyManaged：
Plain Text
1POST /v2/price?action=DescribePrice HTTP/1.1
2Host: rapidfs.bj.baidubce.com
3Authorization: authorization string
4{
5 "managedMode" : "FullyManaged",
6 "dataSpec": "Capacity",
7 "capacityTiB": 250
8}返回示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
4{
5 "priceInfos": [
6 {
7 "currency": "CNY",
8 "unitPrice": 27.2,
9 "chargeType": "PostPaid",
10 "chargeUnit": "Hour"
11 },
12 {
13 "currency": "CNY",
14 "unitPrice": 0.0002,
15 "chargeType": "PostPaid",
16 "chargeUnit": "GiB_Hour"
17 }
18 ]
19}评价此篇文章