查询云服务类型资源规格定价-ListResourceSpecsPrice

X-Language

否

参数解释：

语言。

约束限制：

不涉及

取值范围：

• 中文：zh_CN
• 英文：en_US

默认取值：

zh_CN。

cloud_service_type

否

String

参数解释：

云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表-ListServiceTypes接口获取。

约束限制：

此参数不携带或携带值为null时，不作为筛选条件。

取值范围：

[1-64]

默认取值：

不涉及

resource_type

否

String

参数解释：

资源类型编码，例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表-ListResourceTypes接口获取。

约束限制：

此参数不携带或携带值为null时，不作为筛选条件。

取值范围：

[1-64]

默认取值：

不涉及

region_code

是

String

参数解释：

云服务区编码，例如：“ap-southeast-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。

约束限制：

不涉及

取值范围：

[1-64]

默认取值：

不涉及

filters

否

List<Filter>

参数解释：

过滤条件，具体请参见表2 Filter。

约束限制：

此参数不携带或携带值为空列表或携带值为null时，不作为筛选条件。

取值范围：

[0-1]

默认取值：

不涉及

need_attributes

否

boolean

参数解释：

是否返回资源规格属性信息。

约束限制：

不涉及

取值范围：

• true：返回
• false：不返回

默认取值：

false。

need_price

否

boolean

参数解释：

是否返回资源规格官网定价信息。

约束限制：

不涉及

取值范围：

• true：返回
• false：不返回

默认取值：

false。

marker

否

String

参数解释：

翻页信息，从上次API调用返回的分页查询页的信息中获取。

约束限制：

• 首页查询不携带此参数，非首页查询传入上一页响应返回的next_marker。
• 翻页过程中，查询条件不能修改，包括过滤条件、排序条件、limit和语言。

取值范围：

[1-256]

默认取值：

不涉及

limit

否

Integer

参数解释：

每页返回的个数，用于控制分页查询返回的记录数量。

约束限制：

不涉及

取值范围：

[1-50]

默认取值：

50

key

是

String

参数解释：

过滤条件的key值。

约束限制：

不涉及

取值范围：

• RESOURCE_SPEC：资源规格编码。
• CHARGING_MODE：计费模式。

默认取值：

不涉及

value

是

String

参数解释：

过滤条件的value值。不支持模糊查询。

约束限制：

不涉及

取值范围：

[1-256]

默认取值：

不涉及

error_code

String

参数解释：

状态码。

具体请参考状态码。只有失败才返回该字段。

取值范围：

最大长度：20

error_msg

String

参数解释：

错误描述信息。只有失败才返回该字段。

取值范围：

最大长度：1000

page_info

PageInfo Object

参数解释：

分页查询页的信息。具体参见表3 PageInfo。

取值范围：

不涉及

region_code

String

参数解释：

云服务区编码。例如：“ap-southeast-1”。

取值范围：

最大长度：64

resource_spec_infos

List<ResourceSpecInfo>

参数解释：

云服务类型资源规格列表，具体参见表4 ResourceSpecInfo。

取值范围：

不涉及

next_marker

String

参数解释：

向后分页标识符。下一页数据的起始marker，有值代表有下一页，为null代表无下一页。

取值范围：

最大长度：256

cloud_service_type

String

参数解释：

云服务类型的编码。

取值范围：

最大长度：64

cloud_service_type_name

String

参数解释：

云服务类型的名称。

取值范围：

最大长度：200

resource_type

String

参数解释：

资源类型的编码。例如ECS的VM为“hws.resource.type.vm”。

取值范围：

最大长度：64

resource_type_name

String

参数解释：

资源类型的名称。

取值范围：

最大长度：200

resource_spec

String

参数解释：

云服务类型的资源规格编码。

取值范围：

最大长度：200

resource_spec_name

String

参数解释：

云服务类型的资源规格名称。

取值范围：

最大长度：256

attributes

List<Attribute>

参数解释：

云服务类型资源规格属性信息列表。need_attributes为true时，返回属性信息。具体参见表5 Attribute

取值范围：

不涉及

price_lists

List<PriceItem>

参数解释：

云服务类型资源规格定价信息列表。need_price为true时，返回定价信息。具体参见表7 PriceItem

取值范围：

不涉及

code

String

参数解释：

属性编码。

取值范围：

最大长度：128

name

String

参数解释：

属性名称。

取值范围：

最大长度：1024

value

String

参数解释：

属性取值。

取值范围：

最大长度：200

unit

String

参数解释：

属性单位。

取值范围：

最大长度：64

linear_range

Object LinearRange

参数解释：

线性属性范围。具体参见表6 LinearRange

取值范围：

不涉及

min

Integer

参数解释：

线性属性最小值。

取值范围：

不涉及

max

Integer

参数解释：

线性属性最大值。

取值范围：

不涉及

step

Integer

参数解释：

线性属性步长。

取值范围：

不涉及

offering_id

String

参数解释：

商品Id。

取值范围：

最大长度：64

currency

String

参数解释：

币种。

取值范围：

USD：美元。

值为空代表美元。

official_price

String

参数解释：

查询时间生效的官网价。

取值范围：

最大长度：64

charging_mode

String

参数解释：

计费模式。

取值范围：

• PERIOD：包年/包月
• ON_DEMAND：按需
• ONE_TIME：一次性
• ON_DEMAND_PKG：按需套餐包

period_type

Integer

参数解释：

销售周期类型。

取值范围：

• 0：天
• 2：月
• 3：年
• 4：小时

period_nums

List<Integer>

参数解释：

销售周期数。

取值范围：

不涉及

billing_usage_factor

String

参数解释：

计费因子。

取值范围：

最大长度：64

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

400

CBC.0100

参数错误。