# 查询规格销售策略 - ListFlavorSellPolicies #### 功能介绍 查询竞价计费模式以及IES场景的规格销售策略列表。 #### 接口约束 本接口仅适用于查询IES和竞价计费型规格的销售策略。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ECS/doc?api=ListFlavorSellPolicies)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ecs/ecs_06_0000.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | ecs:cloudServerFlavors:get | read | - | - | - | - | #### URI GET /v1/{project_id}/cloudservers/flavor-sell-policies 参数说明请参见[表1]。 表1路径参数 | 参数 | 是否必选 | 描述 | |:---|:---|:---| | project_id | 是 | **参数解释：** 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表2查询参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | flavor_id | 否 | String | **参数解释：** 云服务器的系统规格的ID。 已上线的规格请参见[实例类型](https://support.huaweicloud.com/productdesc-ecs/zh-cn_topic_0035470096.html)章节。 **约束限制：** 该字段支持模糊搜索（前缀匹配）、精确搜索。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | sell_status | 否 | String | **参数解释：** 云服务器的系统规格销售状态。 **约束限制：** 不涉及 **取值范围：** - available：正常售卖 - sellout：售罄 **默认取值：** 不涉及 | | sell_mode | 否 | String | **参数解释：** 计费模式。 **约束限制：** 不涉及 **取值范围：** - postPaid：按需计费实例，暂不支持 - prePaid：包年/包月计费实例，暂不支持 - spot：竞价实例 - ri：预留实例，暂不支持 **默认取值：** 不涉及 | | availability_zone_id | 否 | String | **参数解释：** 可用区，需要指定可用区（AZ）。 请参考[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/ECS)获取。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | 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]。 | 表4sell_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]。 **取值范围：** 不涉及 | 表5spot_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" } } ] } ``` #### 返回值 请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。 #### 错误码 请参考[错误码](https://support.huaweicloud.com/api-ecs/ecs_07_0002.html)。