华为云服务器查询规格销售策略_云淘科技
功能介绍
查询竞价计费模式以及IES场景的规格销售策略列表。
接口约束
本接口仅适用于查询IES和竞价计费型规格的销售策略。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/cloudservers/flavor-sell-policies?flavor_id={flavor_id}
参数说明请参见表1。
|
参数 |
是否必选 |
描述 |
|---|---|---|
|
project_id |
是 |
项目ID。 获取方法请参见获取项目ID。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
flavor_id |
否 |
String |
云服务器的系统规格的ID。 已上线的规格请参见实例类型章节。 说明： 该字段支持模糊搜索（前缀匹配）、精确搜索。 |
|
sell_status |
否 |
String |
云服务器的系统规格销售状态。 取值范围： available：正常售卖 |
|
sell_mode |
否 |
String |
计费模式。 取值范围： postPaid：按需计费实例，暂不支持 |
|
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：立即释放 |
|
limit |
否 |
Integer |
单页面可显示的策略条数最大值，默认是1000。 |
|
marker |
否 |
String |
以单页最后一条策略的id作为分页标记。 |
请求消息
无
响应消息
响应参数如表3所示。
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
count |
Integer |
云服务器规格销售策略数量。 |
|
sell_policies |
Array of objects |
云服务器规格销售策略，请参考表4。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
Integer |
云服务器规格的索引。 |
|
flavor_id |
String |
云服务器规格的ID。 |
|
sell_status |
String |
云服务器规格的售卖状态。 sellout：售罄 |
|
availability_zone_id |
String |
云服务器规格的可用区。 |
|
sell_mode |
String |
云服务器规格的付费模式。 postPaid：按需计费 |
|
spot_options |
object |
云服务器规格竞价实例的销售策略详情。请参考表5。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
longest_spot_duration_hours |
Integer |
购买的竞价实例时长。 |
|
largest_spot_duration_count |
Integer |
购买的“竞价实例时长”的个数。 |
|
interruption_policy |
String |
竞价实例中断策略。 immediate：立即释放 |
请求示例
查询云服务器规格“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"
}
}
]
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
父主题： 规格管理
内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家
