调用DescribeContainerGroupPrice查询实例的价格。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | DescribeContainerGroupPrice |
系统规定参数。取值:DescribeContainerGroupPrice。 |
Cpu | Float | 是 | 2.0 |
vCPU大小。 |
Memory | Float | 是 | 4.0 |
内存大小。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。 |
InstanceType | String | 否 | ecs.c5.large |
指定的ECS实例规格。 |
SpotStrategy | String | 否 | SpotWithPriceLimit |
实例的抢占策略。取值范围:
默认为:NoSpot。 |
ZoneId | String | 否 | cn-hangzhou-g |
可用区。 |
SpotPriceLimit | Float | 否 | 0.2 |
设置抢占式实例的每小时最高价格,最多精确到小数点后3位。当SpotStrategy取值为SpotWithPriceLimit时,必须设置SpotPriceLimit。 |
EphemeralStorage | Integer | 否 | 20 |
临时存储空间大小。单位为:GiB.。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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 | 7A872585-33C7-4D69-AB8E-412E81EBA387 |
请求ID,唯一标识。 |
示例
请求示例
https://eci.aliyuncs.com/?Action=DescribeContainerGroupPrice
&Cpu=2.0
&Memory=4.0
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<DescribeContainerGroupPriceResponse>
<RequestId>7A872585-33C7-4D69-AB8E-412E81EBA387</RequestId>
<PriceInfo>
<SpotPrices>
<SpotPrice>
<OriginPrice>0.622</OriginPrice>
<SpotPrice>0.056</SpotPrice>
<ZoneId>cn-hangzhou-i</ZoneId>
<InstanceType>ecs.c5.large</InstanceType>
</SpotPrice>
</SpotPrices>
<Rules>
<Rule>
<Description>买满1年,立享官网价格8.5折优惠</Description>
<RuleId>587</RuleId>
</Rule>
</Rules>
<Price>
<OriginalPrice>0.00012252</OriginalPrice>
<Currency>CNY</Currency>
<DiscountPrice>0</DiscountPrice>
<TradePrice>0.00012252</TradePrice>
<DetailInfos>
<DetailInfo>
<OriginalPrice>0.000098</OriginalPrice>
<DiscountPrice>0</DiscountPrice>
<Resource>cpu</Resource>
<TradePrice>0.000098</TradePrice>
<Rules>
<Rule>
<Description>买满1年,立享官网价格8.5折优惠</Description>
<RuleId>587</RuleId>
</Rule>
</Rules>
</DetailInfo>
</DetailInfos>
</Price>
</PriceInfo>
</DescribeContainerGroupPriceResponse>
JSON
格式
{
"RequestId": "7A872585-33C7-4D69-AB8E-412E81EBA387",
"PriceInfo": {
"SpotPrices": {
"SpotPrice": [{
"OriginPrice": "0.622",
"SpotPrice": "0.056",
"ZoneId": "cn-hangzhou-i",
"InstanceType": "ecs.c5.large"
}]
},
"Rules": {
"Rule": [{
"Description": "买满1年,立享官网价格8.5折优惠",
"RuleId": "587"
}]
},
"Price": {
"OriginalPrice": "0.00012252",
"Currency": "CNY",
"DiscountPrice": "0",
"TradePrice": "0.00012252",
"DetailInfos": {
"DetailInfo": [{
"OriginalPrice": "0.000098",
"DiscountPrice": "0",
"Resource": "cpu",
"TradePrice": "0.000098",
"Rules": {
"Rule": [{
"Description": "买满1年,立享官网价格8.5折优惠",
"RuleId": "587"
}]
}
}]
}
}
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParam.CpuOrMemorySpec | The specified specification is invalid. | 指定的规格还未开放售卖,不提供价格查询。 |
400 | TradeBidCommodityNotMatch | The trade ID and the commodity do not match. | 交易的业务ID和商品不匹配。 |
403 | Spot.NotMatched | %s. We recommend that you use the create multi-zone function to avoid insufficient inventory. For more information, see https://help.aliyun.com/document_detail/157290.htm?userCode=wrvvs1rm&zuntopl | %s. 推荐使用多可用区多规格配置来避免库存不足,更多信息见:https://help.aliyun.com/document_detail/157290.htm?userCode=wrvvs1rm&zuntopl |
访问错误中心查看更多错误码。