调用DescribeContainerGroupPrice查询实例的价格。
接口说明
- 本接口不支持资源组鉴权。
- ECI实例支持指定vCPU和内存,或者指定ECS规格创建。调用本接口查询价格时,请传入ECI支持指定的规格。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 地域ID。您可以调用DescribeRegions查询最新的地域可用区信息。 | cn-hangzhou |
Cpu | float | 是 | vCPU大小。ECI支持的vCPU和内存规格请参见vCPU和内存规格说明。 | 2.0 |
Memory | float | 是 | 内存大小。单位为GiB。ECI支持的vCPU和内存规格请参见vCPU和内存规格说明。 | 4.0 |
InstanceType | string | 否 | 指定的ECS实例规格。ECI支持指定的ECS规格请参见ECI支持的ECS规格说明。 说明
设置该参数后,将自动忽略传入的vCPU和内存值,仅返回ECS规格的价格信息。
| ecs.c5.large |
SpotStrategy | string | 否 | 实例的抢占策略。取值范围:
默认为:NoSpot。 | SpotWithPriceLimit |
ZoneId | string | 否 | 可用区。您可以调用DescribeRegions查询最新的地域可用区信息。 | cn-hangzhou-g |
SpotPriceLimit | float | 否 | 设置抢占式实例的每小时最高价格,最多精确到小数点后3位。当SpotStrategy取值为SpotWithPriceLimit时,必须设置SpotPriceLimit。 | 0.2 |
EphemeralStorage | integer | 否 | 临时存储空间大小。单位为GiB.。 | 20 |
SpotDuration | integer | 否 | 抢占式实例的保护期。单位为小时。默认为1。可设置为0,表示无保护期。 | 1 |
返回参数
示例
正常返回示例
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 | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParam.CpuOrMemorySpec | The specified specification is invalid. | 指定的规格还未开放售卖,不提供价格查询。 |
400 | TradeBidCommodityNotMatch | The trade ID and the commodity do not match. | 交易的业务ID和商品不匹配。 |
400 | InvalidSpotCpuMemorySpec | The specified CPU and memory are not allowed. You must create spot ECI using standard ECS specifications for CPU and memory. | 必须采用标准的ECS规格来创建ECI spot。 |
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.html | - |
访问错误中心查看更多错误码。