调用 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和商品不匹配。

访问错误中心查看更多错误码。