# 查询客户包年/包月资源列表（旧） #### 功能介绍 客户在伙伴销售平台查询某个或所有的包年/包月资源。 注意事项： - 该接口允许使用客户AK/SK或者Token调用；使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用时接口不会报错，但查询不到数据。 - 该接口只能查询开通成功的资源。 - 成功调用本接口后，如果您需要对已生效状态的资源进行续订，您可以调用"[查询包年/包月产品价格-ListRateOnPeriodDetail](https://support.huaweicloud.com/api-bpconsole/bcloud_01002.html)"接口对查询到的包年/包月资源进行续订询价，然后再调用"[续订包年/包月资源（旧）](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0082522029.html)"接口进行续订。 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) 该接口即将下线，"查询客户包年/包月资源列表"新接口请参考[查询客户包年/包月资源列表-ListPayPerUseCustomerResources](https://support.huaweicloud.com/api-bpconsole/api_order_00021.html)。 #### URI GET /v1.0/{domain_id}/common/order-mgr/resources/detail 参数说明请参见下表。 表1路径参数 | 参数 | 是否必选 | 取值范围 | 描述 | |:---|:---|:---|:---| | domain_id | 是 | 最大长度：64 | 客户账号ID。获取方法请参见[如何获取客户的customer_id/domain_id](https://support.huaweicloud.com/api-bpconsole/offl_110002.html)。 | 表2查询参数 | 参数 | 是否必选 | 参数类型 | 取值范围 | 描述 | |:---|:---|:---|:---|:---| | resource_ids | 否 | String | 最大长度： 4096 | 资源ID列表。 查询指定资源ID的资源（当only_main_resource=0时，查询指定资源及其附属资源）。最大支持50个ID同时作为条件查询，多个ID以英文逗号分隔。 此参数不携带、携带空时不参与过滤；携带值为空串、null参与过滤。 说明： 资源ID是指开通资源以后，云服务针对该资源分配的标志，譬如云主机ECS的server_id。 | | order_id | 否 | String | 最大长度：64 | 订单号。 查询指定订单下的资源。 此参数不携带、携带为空时不参与过滤；携带值为空串、携带为null参与过滤。 | | only_main_resource | 否 | Integer | \[0\|1\] | 是否只查询主资源，该参数对于请求参数是子资源ID的时候无效，如果resource_ids是子资源ID，只能查询自己。 - 0：查询主资源及附属资源。 - 1：只查询主资源。 默认值为0。 此参数不携带、携带值为空、携带为null取默认值0；不支持携带为空串。 说明： 主资源是指有关联的几个资源中，处于主导位置的资源。 - 对于ECS而言，虚拟机VM是主资源，磁盘EVS是辅资源。 - 对于VPC而言，共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP）；独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽。 | | status_list | 否 | String | - | 资源状态。 查询指定状态的资源。多个状态以英文逗号分隔。 - 2：使用中 - 4：已冻结 - 5：已过期 此参数不携带、携带为空时返回所有状态的资源数据；不支持携带值为空串、携带为null。 | | page_no | 否 | Integer | 大于或等于1的整数 | 页码。 默认值是1。 此参数不携带、携带值为空、携带为null时取默认值1；不支持携带值为空串。 | | page_size | 否 | Integer | \[1-500\] | 每页条数。 默认值是10。最大值是500。 此参数不携带、携带值为空、携带为null时取默认值10；不支持携带值为空串。 | #### 请求消息 **请求参数** 无。 **请求示例** ``` GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/resources/detail?resource_ids=b38*****62e,249*****c07&only_main_resource=1&page_no=1&page_size=100 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ ``` #### 响应消息 **响应参数** | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 状态码。 具体请参见[状态码]。 | | error_msg | String | 错误描述信息。 | | data | List\ | 资源列表。 具体请参见[表3]。 | | total_count | Integer | 总记录数。 默认是0。 | 表3ResourceInstance | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 标识要开通资源的内部ID，资源开通以后生成的ID为resourceID。 | | resource_id | String | 资源ID。 | | resource_name | String | 资源实例名。 | | region_code | String | 云服务资源池区域编码。 | | cloud_service_type_code | String | 云服务类型编码，例如OBS的云服务类型编码为"hws.service.type.obs"。您可以调用[查询云服务类型列表-ListServiceTypes](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0000001256679455.html)接口获取。 | | resource_type_code | String | 资源类型编码，例如ECS的VM为"hws.resource.type.vm"。您可以调用[查询资源类型列表-ListResourceTypes](https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0000001256519451.html)接口获取。 | | resource_spec_code | String | 云服务产品的资源规格。如果是VM的资源规格，则需要在规格后面添加".win"或".linux"，例如"s2.small.1.linux"。 | | project_code | String | 资源项目ID。 | | product_id | String | 产品ID。 | | main_resource_id | String | 主资源ID。 | | is_main_resource | Integer | 是否是主资源。 - 0：非主资源 - 1：主资源 | | status | Integer | 资源状态。状态说明请参见[资源状态说明](https://support.huaweicloud.com/usermanual-billing/renewals_topic_90000001.html)。 - 2：使用中 - 3：已关闭（页面不展示这个状态） - 4：已冻结 - 5：已过期 | | valid_time | String | 资源生效时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如"2019-05-06T08:05:01Z"。 | | expire_time | String | 资源过期时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如"2019-05-06T08:05:01Z"。 | | next_operation_policy | Integer | 下一次扣费策略： - 1：到期转按需 - 2：到期后自动删除（从生效中直接删除） - 3：到期后自动续费 - 4：到期后冻结 - 5：到期后删除（从保留期删除） 说明： 只有"3"表示该资源是自动续订，其他情况下，都是非自动续订下的到期策略。 | **响应示例** ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "data": [ { "id": "01154-21800069-0", "status": 2, "resource_id": "249*****c07", "resource_name": "114.115.169.185", "region_code": "cn-north-1", "cloud_service_type_code": "hws.service.type.vpc", "resource_type_code": "hws.resource.type.ip", "resource_spec_code": "5_sbgp", "project_code": "3f*****400", "product_id": "c1*****55", "main_resource_id": "249*****c07", "is_main_resource": 1, "valid_time": "2018-04-26T18:03:03Z", "expire_time": "2018-06-27T15:59:59Z", "next_operation_policy": 3 }, { "id": "01154-21800073-0", "status": 2, "resource_id": "b3*****62e", "resource_name": "ecs-9f88-0001", "region_code": "cn-north-1", "cloud_service_type_code": "hws.service.type.ec2", "resource_type_code": "hws.resource.type.vm", "resource_spec_code": "s3.medium.2.linux", "project_code": "3f*****400", "product_id": "00301-62057-0--0", "main_resource_id": "b38*****62e", "is_main_resource": 1, "valid_time": "2018-04-26T18:02:33Z", "expire_time": "2018-06-27T15:59:59Z", "next_operation_policy": 3 } ], "error_code": "CBC.0000", "error_msg": "success", "total_count": 2 } ``` #### 状态码 ![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png) - 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 - 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 | HTTP状态码 | 错误码 | 描述 | |:---|:---|:---| | 200 | CBC.0000 | 成功。 | | 400 | CBC.0100 | 参数错误。 | | 403 | CBC.0151 | 访问拒绝。 | | 500 | CBC.0999 | 其他错误。 |