# 查询云服务类型资源规格-ListResourceSpecs #### 功能介绍 客户在伙伴销售平台查询云服务类型资源规格。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 该接口仅返回华为云在售商品的云服务类型资源规格。 - 分页查询使用的参数为marker、limit。marker和limit一起使用时才会生效，单独使用无效。 #### 接口约束 该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=ListResourceSpecs)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 伙伴操作员账号调用当前API无需授权。 #### URI POST /v2/products/resource-specs-query 表1Header参数 | 参数 | 是否必选 | 描述 | |:---|:---|:---| | X-Language | 否 | **参数解释：** 语言。 **约束限制**： 不涉及 **取值范围：** - 中文：zh_CN - 英文：en_US **默认取值：** zh_CN。 | #### 请求消息 **请求参数** | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | cloud_service_type | 是 | String | **参数解释：** 云服务类型编码，例如OBS的云服务类型编码为"hws.service.type.obs"。您可以调用[查询云服务类型列表-ListServiceTypes](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0000001256679455.html)接口获取。 **约束限制**： 不涉及 **取值范围：** \[1-64\] **默认取值：** 不涉及 | | resource_type | 是 | String | **参数解释：** 资源类型编码，例如ECS的VM为"hws.resource.type.vm"。您可以调用[查询资源类型列表-ListResourceTypes](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0000001256519451.html)接口获取。 **约束限制**： 不涉及 **取值范围：** \[1-64\] **默认取值：** 不涉及 | | region_code | 是 | String | **参数解释：** 云服务区编码，例如："cn-north-1"。具体请参见[地区和终端节点](https://developer.huaweicloud.com/endpoint)对应云服务的"区域"列的值。 **约束限制**： 不涉及 **取值范围：** \[1-64\] **默认取值：** 不涉及 | | charge_mode | 是 | String | **参数解释：** 计费模式。 **约束限制**： 不涉及 **取值范围：** - 1：包年/包月 - 3：按需 **默认取值：** 不涉及 | | filters | 否 | List\ | **参数解释：** 过滤条件，具体请参见[表2]。 **约束限制**： 此参数不携带或携带值为空列表或携带值为null时，不作为筛选条件。 **取值范围：** \[0-1\] **默认取值：** 不涉及 | | marker | 否 | String | **参数解释：** 翻页信息，从上次API调用返回的分页查询页的信息中获取。 **约束限制：** - 首页查询不携带此参数，非首页查询传入上一页响应返回的next_marker。 - 翻页过程中，查询条件不能修改，包括过滤条件、排序条件、limit和语言。 **取值范围：** \[0-128\] **默认取值：** 不涉及 | | limit | 否 | Integer | **参数解释：** 每页返回的个数，用于控制分页查询返回的记录数量。 **约束限制：** 不涉及 **取值范围：** \[1-100\] **默认取值：** 100 | 表2Filter | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 是 | String | **参数解释：** 过滤条件的key值。 **约束限制**： 不涉及 **取值范围：** - RESOURCE_SPEC：资源规格编码或者资源规格名称。 **默认取值：** 不涉及 | | value | 是 | String | **参数解释：** 过滤条件的value值。支持模糊查询。仅支持前缀匹配、后缀匹配、中间匹配。 **约束限制**： 不涉及 **取值范围：** \[1-128\] **默认取值：** 不涉及 | **请求示例** ``` POST https://bss.myhuaweicloud.com/v2/products/resource-specs-query HTTP/1.1 Content-Type: application/json X-Auth-Token: MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ X-Language: zh_CN { "cloud_service_type": "hws.service.type.ec2", "resource_type": "hws.resource.type.vm", "filters": [ { "key": "RESOURCE_SPEC", "value": "ac3.2xlarge.4.linux" } ], "region_code": "cn-north-1", "charge_mode": "3", "marker": null, "limit": 100 } ``` #### 响应消息 **响应参数** | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 状态码。 具体请参考[状态码]。只有失败才返回该字段。 **取值范围：** 最大长度：20 | | error_msg | String | **参数解释：** 错误描述信息。只有失败才返回该字段。 **取值范围：** 最大长度：1000 | | page_info | PageInfo Object | **参数解释：** 分页查询页的信息。具体参见[表3]。 **取值范围：** 不涉及 | | cloud_service_basics | List\ | **参数解释：** 商品规格列表，具体参见[表4]。 **取值范围：** 不涉及 | 表3PageInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | next_marker | String | **参数解释：** 向后分页标识符。下一页数据的起始marker，有值代表有下一页，为null代表无下一页。 **取值范围：** 最大长度：128 | 表4CloudServiceBasic | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | **参数解释：** 云服务类型的资源规格名称。 **取值范围：** 最大长度：200 | | charge_mode | String | **参数解释：** 计费模式。 **取值范围：** - 1：包年/包月 - 3：按需 | | region_code | String | **参数解释：** 云服务区编码。例如："cn-north-1"。 **取值范围：** 最大长度：64 | **响应示例** ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "page_info": { "next_marker": "c3ne.xlarge.2.linux" }, "cloud_service_basics": [ { "cloud_service_type": "hws.service.type.ec2", "cloud_service_type_name": "Elastic Cloud Server", "resource_type": "hws.resource.type.vm", "resource_type_name": "Cloud Host", "resource_spec": "ac3.2xlarge.4.linux", "resource_spec_name": "ARM Enhaced General Computing|ac3.2xlarge.4|8vCPUs|29GB|linux", "charge_mode": "3", "region_code": "cn-north-1" } ] } ``` #### 状态码 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 - 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 | HTTP状态码 | 错误码 | 错误描述 | |:---|:---|:---| | 403 | CBC.0151 | 访问拒绝。 | | 500 | CBC.0999 | 其他错误。 | | 400 | CBC.0100 | 参数错误。 |