{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/emnfh84xl","result":{"data":{"markdownRemark":{"html":"

该接口用于查询预留实例券实例规格对应的价格。

\n

请求结构

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /v{version}/reservedInstance/price HTTP/1.1\n2Host: bcc.bj.baidubce.com\n3Authorization: authorization string\n4{\n5    "specId": specId,\n6    "spec": spec,\n7    "scope": scope,\n8    "offeringType": offeringType,\n9    "reservedInstanceTime": reservedInstanceTime,\n10    "zoneName": zoneName,\n11    "reservedInstanceCount": reservedInstanceCount,\n12    "priceTimeUnit": priceTimeUnit\n13}
\n
\n
\n
\n \n

请求头域

\n

除公共头域外，无其它特殊头域。

\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名称类型是否必需参数位置描述
versionString是URL参数API版本号
specIdString是RequestBody参数实例规格族
specString是RequestBody参数实例套餐规格
offeringTypeString是RequestBody参数付费方式，可选值：FullyPrepay：全预付；半预付：PartPrepay；0预付：NoPrepay。
reservedInstanceTimeString是RequestBody参数实例券购买时长，[1,2,3,4,5,6,7,8,9,12,24,36]，单位：月。
scopeString否RequestBody参数实例券的可用范围；默认：AZ可用区级券：AZ地域级券：Region
zoneNameString是RequestBody参数可用区名称
reservedInstanceCountint否RequestBody参数查询在指定实例套餐规格下，任意数量实例的总价格，必须为大于0的整数，可选参数，缺省为1
priceTimeUnitint否RequestBody参数后付费计价时间单位，可选值： month：按月计费； hour：按小时计费，缺省值。
\n

返回头域

\n

除公共头域，无其它特殊头域。

\n

返回参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名称类型描述
requestIdString唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
specString实例券规格。
catagoryPricedouble实例券目录价格。
prePaidSpecPricedouble实例券预付价。
postPaidSpecTimeUnitPricedouble实例券后付价，根据入参 priceTimeUnit 返回按小时计价格或按月计价格。
tradePricedouble实例券最终价，即优惠后订单实付价格。
prePaidTradePricedouble实例券折后预付价。
postPaidTradeTimeUnitPricedouble实例券折后后付价，根据入参 priceTimeUnit 返回按小时计价格或按月计价格。
\n

请求示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /v2/reservedInstance/price HTTP/1.1\n2Host: bcc.bj.baidubce.com\n3ContentType: application/json\n4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de\n5{\n6    "spec": "bcc.g5.c1m4",\n7    "specId": "g5",\n8    "offeringType": "partPrepay",\n9    "scope": "AZ",\n10    "zoneName": "cn-bj-a",\n11    "reservedInstanceCount": 1,\n12    "priceTimeUnit": "hour",\n13    "reservedInstanceTime": 1,\n14    "purchaseNum": 1\n15}
\n
\n
\n
\n \n

返回示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1HTTP/1.1 200 OK\n2x-bce-request-id: 186e6d9b-4c89-47eb-ba4d-b4117bc81cf0\n3Date: Wed, 03 Dec 2014 06:42:19 GMT\n4Content-Type: application/json;charset=UTF-8\n5Server: BWS\n6{\n7  "requestId": "186e6d9b-4c89-47eb-ba4d-b4117bc81cf0",\n8  "spec": "bcc.g5.c1m4",\n9  "categoryPrice": {\n10    "prePayCategoryPrice": 1.00,\n11    "postPayCategoryPrice": 0.1000000000\n12  },\n13  "tradePrice": {\n14    "prePayTradePrice": 1.00,\n15    "postPayTradePrice": 0.1000000000\n16  }\n17}
\n
\n
\n
\n ","fields":{"slug":"emnfh84xl","title":"查询实例券价格","date":"2026-04-02","extractedHeadings":[]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"emnfh84xl","prev":{"id":"vltgwr2la","name":"预留实例券创建自动续费规则","path":"vltgwr2la","filePath":"API参考/预留实例券相关接口/预留实例券创建自动续费规则.md","seo":null,"parentIds":["djwvynrdc","2lhyjh4tz"],"parents":[{"id":"djwvynrdc","documentId":null,"name":"API参考","repoName":"BCC","filePath":"API参考","disabled":false,"path":"djwvynrdc","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null},{"id":"2lhyjh4tz","documentId":"998f5f3f-ac22-400e-8ee6-31b927c4ea95","name":"预留实例券相关接口","repoName":"BCC","filePath":"API参考/预留实例券相关接口","disabled":false,"path":"2lhyjh4tz","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null}]},"next":{"id":"3lvc76e8v","name":"地域及可用区相关接口","path":"3lvc76e8v","filePath":"API参考/地域及可用区相关接口/获取域名列表接口.md","seo":null,"parentIds":["djwvynrdc","ulvc766cp"],"parents":[{"id":"djwvynrdc","documentId":null,"name":"API参考","repoName":"BCC","filePath":"API参考","disabled":false,"path":"djwvynrdc","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null},{"id":"ulvc766cp","documentId":"a064cdbb-1230-4a52-9e0a-236f854e1990","name":"地域及可用区相关接口","repoName":"BCC","filePath":"API参考/地域及可用区相关接口","disabled":false,"path":"ulvc766cp","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null}]},"parents":[{"id":"djwvynrdc","documentId":null,"name":"API参考","repoName":"BCC","filePath":"API参考","disabled":false,"path":"djwvynrdc","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null},{"id":"2lhyjh4tz","documentId":"998f5f3f-ac22-400e-8ee6-31b927c4ea95","name":"预留实例券相关接口","repoName":"BCC","filePath":"API参考/预留实例券相关接口","disabled":false,"path":"2lhyjh4tz","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null}],"specificSeo":null}}}