查询规格销售策略
功能介绍
查询竞价计费模式以及IES场景的规格销售策略列表。
接口约束
本接口仅适用于查询IES和竞价计费型规格的销售策略。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/cloudservers/flavor-sell-policies?flavor_id={flavor_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
flavor_id |
否 |
String |
云服务器的系统规格的ID。 已上线的规格请参见实例类型章节。
说明：
该字段支持模糊搜索（前缀匹配）、精确搜索。 |
|
sell_status |
否 |
String |
云服务器的系统规格销售状态。 取值范围：
|
|
sell_mode |
否 |
String |
计费模式。 取值范围：
|
|
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 |
中断策略。 取值范围：
|
|
limit |
否 |
Integer |
单页面可显示的策略条数最大值，默认是1000。 |
|
marker |
否 |
String |
以单页最后一条策略的id作为分页标记。 |
请求消息
无
响应消息
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
Integer |
云服务器规格的索引。 |
|
flavor_id |
String |
云服务器规格的ID。 |
|
sell_status |
String |
云服务器规格的售卖状态。
|
|
availability_zone_id |
String |
云服务器规格的可用区。 |
|
sell_mode |
String |
云服务器规格的付费模式。
|
|
spot_options |
object |
云服务器规格竞价实例的销售策略详情。请参考表5。 |
请求示例
查询云服务器规格“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"
}
}
]
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
