首页 弹性容器实例 开发参考 API参考 API目录 其他接口 DescribeContainerGroupPrice - 查询实例价格

DescribeContainerGroupPrice - 查询实例价格

更新时间: 2023-09-25 15:21:23

调用DescribeContainerGroupPrice查询实例的价格。

接口说明

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring

地域ID。您可以调用DescribeRegions查询最新的地域可用区信息。

cn-hangzhou
Cpufloat

vCPU大小。ECI支持的vCPU和内存规格请参见vCPU和内存规格说明

2.0
Memoryfloat

内存大小。单位为GiB。ECI支持的vCPU和内存规格请参见vCPU和内存规格说明

4.0
InstanceTypestring

指定的ECS实例规格。ECI支持指定的ECS规格请参见ECI支持的ECS规格说明

说明 设置该参数后,将自动忽略传入的vCPU和内存值,仅返回ECS规格的价格信息。
ecs.c5.large
SpotStrategystring

实例的抢占策略。取值范围:

  • NoSpot:正常按量付费实例。
  • SpotWithPriceLimit:设置上限价格的抢占式实例。
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格的抢占式实例。

默认为:NoSpot。

SpotWithPriceLimit
ZoneIdstring

可用区。您可以调用DescribeRegions查询最新的地域可用区信息。

cn-hangzhou-g
SpotPriceLimitfloat

设置抢占式实例的每小时最高价格,最多精确到小数点后3位。当SpotStrategy取值为SpotWithPriceLimit时,必须设置SpotPriceLimit。

0.2
EphemeralStorageinteger

临时存储空间大小。单位为GiB.。

20
SpotDurationinteger

抢占式实例的保护期。单位为小时。默认为1。可设置为0,表示无保护期。

1

返回参数

名称类型描述示例值
object
RequestIdstring

请求ID,唯一标识。

7A872585-33C7-4D69-AB8E-412E81EBA387
PriceInfoobject

价格信息类型(Price),包括价格和优惠规则。

SpotPricesobject []

抢占式实例价格信息。

ZoneIdstring

可用区。

cn-hangzhou-i
SpotPricefloat

抢占式实例的价格。

0.056
InstanceTypestring

实例规格。

ecs.c5.large
OriginPricefloat

原价。

0.622
Priceobject

价格。

DiscountPricefloat

折扣价。

0
TradePricefloat

最终价,为原价减去折扣。

0.00012252
OriginalPricefloat

原价。

0.00012252
DetailInfosobject []

价格的详细信息。

Resourcestring

资源名称。

cpu
DiscountPricefloat

折扣价。

0
TradePricefloat

成交价。

0.000098
OriginalPricefloat

原价。

0.000098
Rulesobject []

定价规则子集。

Descriptionstring

规则描述。

买满1年,立享官网价格8.5折优惠
RuleIdlong

规则ID。

123456
Currencystring

货币单位。可能值:

  • CNY:该值仅适用于中国站。
  • USD:该值仅适用于国际站。
CNY
Rulesobject []

活动规则。

Descriptionstring

活动规则描述。

买满1年,立享官网价格8.5折优惠
RuleIdlong

活动ID。

123456

示例

正常返回示例

JSON格式

{
  "RequestId": "7A872585-33C7-4D69-AB8E-412E81EBA387",
  "PriceInfo": {
    "SpotPrices": {
      "SpotPrice": [
        {
          "ZoneId": "cn-hangzhou-i",
          "SpotPrice": 0.056,
          "InstanceType": "ecs.c5.large",
          "OriginPrice": 0.622
        }
      ]
    },
    "Price": {
      "DiscountPrice": 0,
      "TradePrice": 0.00012252,
      "OriginalPrice": 0.00012252,
      "DetailInfos": {
        "DetailInfo": [
          {
            "Resource": "cpu",
            "DiscountPrice": 0,
            "TradePrice": 0.000098,
            "OriginalPrice": 0.000098,
            "Rules": {
              "Rule": [
                {
                  "Description": "买满1年,立享官网价格8.5折优惠",
                  "RuleId": 123456
                }
              ]
            }
          }
        ]
      },
      "Currency": "CNY"
    },
    "Rules": {
      "Rule": [
        {
          "Description": "买满1年,立享官网价格8.5折优惠",
          "RuleId": 123456
        }
      ]
    }
  }
}

错误码

HTTP status code错误码错误信息描述
400InvalidParam.CpuOrMemorySpecThe specified specification is invalid.指定的规格还未开放售卖,不提供价格查询。
400TradeBidCommodityNotMatchThe trade ID and the commodity do not match.交易的业务ID和商品不匹配。
400InvalidSpotCpuMemorySpecThe specified CPU and memory are not allowed. You must create spot ECI using standard ECS specifications for CPU and memory.必须采用标准的ECS规格来创建ECI spot。
403Spot.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.html-

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

阿里云首页 弹性容器实例 相关技术圈