调用 DescribeContainerGroupPrice 查询实例的价格。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | DescribeContainerGroupPrice |
系统规定参数。取值:DescribeContainerGroupPrice。 |
Cpu | Float | 是 | 2.0 |
CPU大小。 |
Memory | Float | 是 | 8.0 |
内存大小。 |
RegionId | String | 是 | cn-hangzhou |
所属的地域 ID。 |
InstanceType | String | 否 | ecs.c5.large |
指定的实例规格。 |
SpotStrategy | String | 否 | SpotWithPriceLimit |
实例的抢占策略。 取值范围: NoSpot(默认):正常按量付费实例。 SpotWithPriceLimit:设置上限价格的抢占式实例。 SpotAsPriceGo:系统自动出价,跟随当前市场实际价格。 |
ZoneId | String | 否 | cn-hangzhou-g |
实例可用区。 |
SpotPriceLimit | Float | 否 | 0.250 |
设置实例的每小时最高价格。支持最大 3 位小数,参数 SpotStrategy 取值为 SpotWithPriceLimit 时生效。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
PriceInfo | Struct |
价格信息类型(Price),包括价格和优惠规则。 |
|
Price | Struct |
价格。 |
|
Currency | String | CNY |
货币单位。 |
DetailInfos | Array of DetailInfo |
价格的详细信息。 |
|
DetailInfo | |||
DiscountPrice | Float | 0 |
折扣价。 |
OriginalPrice | Float | 0.000098 |
原价。 |
Resource | String | CPU |
资源名称。 |
Rules | Array of Rule |
定价规则子集。 |
|
Rule | |||
Description | String | 买满1年,立享官网价格8.5折优惠 |
规则描述。 |
RuleId | Long | 587 |
规则ID。 |
TradePrice | Float | 0.000098 |
成交价。 |
DiscountPrice | Float | 0 |
折扣价。 |
OriginalPrice | Float | 0.00012252 |
原价。 |
TradePrice | Float | 0.00012252 |
最终价,为原价减去折扣。 |
Rules | Array of Rule |
活动规则。 |
|
Rule | |||
Description | String | 买满1年,立享官网价格8.5折优惠 |
活动规则描述。 |
RuleId | Long | 587 |
活动ID。 |
SpotPrices | Array of SpotPrice |
抢占式实例价格信息。 |
|
SpotPrice | |||
InstanceType | String | ecs.c5.large |
实例规格。 |
OriginPrice | Float | 0.622 |
原价。 |
SpotPrice | Float | 0.056 |
抢占式的价格。 |
ZoneId | String | cn-hangzhou-i |
可用区。 |
RequestId | String | 114E5305-****-4E87-****-19D4EC67119B |
请求ID,唯一标识。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeContainerGroupPrice
&Cpu=2.0
&Memory=8.0
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>114E5305-****-4E87-****-19D4EC67119B</RequestId>
<PriceInfo>
<Price>
<OriginalPrice>0.00012252</OriginalPrice>
<DiscountPrice>0</DiscountPrice>
<Currency>CNY</Currency>
<DetailInfos>
<DetailInfo>
<OriginalPrice>0.000098</OriginalPrice>
<DiscountPrice>0</DiscountPrice>
<Resource>CPU</Resource>
<TradePrice>0.000098</TradePrice>
</DetailInfo>
<DetailInfo>
<Rules>
<Rule>
<Description>买满1年,立享官网价格8.5折优惠</Description>
<RuleId>587</RuleId>
</Rule>
</Rules>
</DetailInfo>
</DetailInfos>
<TradePrice>0.00012252</TradePrice>
</Price>
<SpotPrices>
<SpotPrice>
<Description>买满1年,立享官网价格8.5折优惠</Description>
<RuleId>587</RuleId>
</SpotPrice>
<SpotPrice>
<SpotPrice>0.25</SpotPrice>
<OriginPrice>0.27</OriginPrice>
<ZoneId>cn-hangzhou-g</ZoneId>
<InstanceType>ecs.c5.large</InstanceType>
</SpotPrice>
</SpotPrices>
<Rules>
<Rule>
<Description>买满1年,立享官网价格8.5折优惠</Description>
<RuleId>587</RuleId>
</Rule>
<Rule>
<SpotPrice>0.25</SpotPrice>
<OriginPrice>0.27</OriginPrice>
<ZoneId>cn-hangzhou-g</ZoneId>
<InstanceType>ecs.c5.large</InstanceType>
</Rule>
</Rules>
</PriceInfo>
JSON
格式
{
"RequestId": "114E5305-****-4E87-****-19D4EC67119B",
"PriceInfo": {
"Price": {
"OriginalPrice": 0.00012252,
"DiscountPrice": 0,
"Currency": "CNY",
"DetailInfos": {
"DetailInfo": [
{
"OriginalPrice": 0.000098,
"DiscountPrice": 0,
"Resource": "CPU",
"TradePrice": 0.000098
},
{
"Rules": {
"Rule": {
"Description": "买满1年,立享官网价格8.5折优惠",
"RuleId": 587
}
}
}
]
},
"TradePrice": 0.00012252
},
"SpotPrices": {
"SpotPrice": [
{
"Description": "买满1年,立享官网价格8.5折优惠",
"RuleId": 587
},
{
"SpotPrice": 0.25,
"OriginPrice": 0.27,
"ZoneId": "cn-hangzhou-g",
"InstanceType": "ecs.c5.large"
}
]
},
"Rules": {
"Rule": [
{
"Description": "买满1年,立享官网价格8.5折优惠",
"RuleId": 587
},
{
"SpotPrice": 0.25,
"OriginPrice": 0.27,
"ZoneId": "cn-hangzhou-g",
"InstanceType": "ecs.c5.large"
}
]
}
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParam.CpuOrMemorySpec | The specified specification is invalid. | 指定的规格还未开放售卖,不提供价格查询。 |
400 | TradeBidCommodityNotMatch | The trade ID and the commodity do not match. | 交易的业务ID和商品不匹配。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交