文档首页/ 弹性云服务器 ECS/ API参考/ API/ 规格管理/ 查询规格销售策略
更新时间：2025-07-23 GMT+08:00
查看PDF
分享

查询规格销售策略

功能介绍

查询竞价计费模式以及IES场景的规格销售策略列表。

接口约束

本接口仅适用于查询IES和竞价计费型规格的销售策略。

调试

您可以在API Explorer中调试该接口。

URI

GET /v1/{project_id}/cloudservers/flavor-sell-policies

参数说明请参见表1。
表1 路径参数

参数

是否必选

描述

project_id

是

项目ID。

获取方法请参见获取项目ID。
表2 查询参数

参数

是否必选

参数类型

描述

flavor_id

否

String

参数解释：

云服务器的系统规格的ID。

已上线的规格请参见实例类型章节。

约束限制：

该字段支持模糊搜索（前缀匹配）、精确搜索。

取值范围：

不涉及

默认取值：

不涉及

sell_status

否

String

参数解释：

云服务器的系统规格销售状态。

约束限制：

不涉及

取值范围：

  • available：正常售卖
  • sellout：售罄

默认取值：

不涉及

sell_mode

否

String

参数解释：

计费模式。

约束限制：

不涉及

取值范围：

  • postPaid：按需计费实例，暂不支持
  • prePaid：包年/包月计费实例，暂不支持
  • spot：竞价实例
  • ri：预留实例，暂不支持

默认取值：

不涉及

availability_zone_id

否

String

参数解释：

可用区，需要指定可用区（AZ）。

请参考地区和终端节点获取。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

longest_spot_duration_hours_gt

否

Integer

参数解释：

查询竞价实例时长大于设置值的策略。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

largest_spot_duration_count_gt

否

Integer

参数解释：

查询“竞价实例时长”的个数大于设置值的策略。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

longest_spot_duration_hours

否

Integer

参数解释：

查询竞价实例时长等于设置值的策略。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

largest_spot_duration_count

否

Integer

参数解释：

查询“竞价实例时长”的个数等于设置值的策略。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

interruption_policy

否

String

参数解释：

中断策略。

约束限制：

不涉及

取值范围：

  • immediate：立即释放
  • delay：延迟释放

默认取值：

不涉及

limit

否

Integer

参数解释：

单页面可显示的策略条数最大值。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

1000

marker

否

String

参数解释：

以单页最后一条策略的id作为分页标记。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

请求消息

无

响应消息

响应参数如表3所示。
表3 响应参数

参数

参数类型

描述

count

Integer

参数解释：

云服务器规格销售策略数量。

sell_policies

Array of objects

参数解释：

云服务器规格销售策略，请参考表4。
表4 sell_policies字段数据结构说明

参数

参数类型

描述

id

Integer

参数解释：

云服务器规格的索引。

取值范围：

不涉及

flavor_id

String

参数解释：

云服务器规格的ID。

取值范围：

不涉及

sell_status

String

参数解释：

云服务器规格的售卖状态。

取值范围：

  • sellout：售罄
  • available：可用

availability_zone_id

String

参数解释：

云服务器规格的可用区。

取值范围：

不涉及

sell_mode

String

参数解释：

云服务器规格的付费模式。

取值范围：

  • postPaid：按需计费
  • prePaid：包年/包月计费
  • spot：竞价实例
  • ri：预留实例

spot_options

object

参数解释：

云服务器规格竞价实例的销售策略详情。请参考表5。

取值范围：

不涉及
表5 spot_options字段数据结构说明

参数

参数类型

描述

longest_spot_duration_hours

Integer

参数解释：

购买的竞价实例时长。

取值范围：

不涉及

largest_spot_duration_count

Integer

参数解释：

购买的“竞价实例时长”的个数。

取值范围：

不涉及

interruption_policy

String

参数解释：

竞价实例中断策略。

取值范围：

  • immediate：立即释放
  • delay：延迟释放

请求示例

查询云服务器规格“s3.small.1”的销售策略列表。

GET https://{endpoint}/v1/{project_id}/cloudservers/flavor-sell-policies?flavor_id=s3.small.1

响应示例

{
    "count":2,
    "sell_policies":[
        {
            "id":1,
            "flavor_id":"s3.small.1",
            "sell_status":"available",
            "availability_zone_id":"az1",
            "sell_mode":"spot",
            "spot_options":{
                "longest_spot_duration_hours":6,
                "largest_spot_duration_count":1,
                "interruption_policy":"immediate"
            }
        },
        {
            "id":2,
            "flavor_id":"s3.small.1",
            "sell_status":"available",
            "availability_zone_id":"az1",
            "sell_mode":"spot",
            "spot_options":{
                "longest_spot_duration_hours":6,
                "largest_spot_duration_count":1,
                "interruption_policy":"immediate"
            }
        }
    ]
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 规格管理

相关文档