查询客户包年/包月资源列表(旧)
功能介绍
客户在自建平台查询某个或所有的包年/包月资源。
注意事项:
- 该接口允许客户的AK/SK或者Token调用。
- 该接口只能查询开通成功的资源。
- 成功调用本接口后,如果您需要对已生效状态的资源进行续订,您可以调用“查询包年/包月产品价格”接口对查询到的包年/包月资源进行续订询价,然后再调用“续订包年/包月资源(旧)”接口进行续订。
该接口即将下线,“查询客户包年/包月资源列表”新接口请参考查询客户包年/包月资源列表。
URI
GET /v1.0/{domain_id}/common/order-mgr/resources/detail
参数说明请参见下表。
参数 |
是否必选 |
取值范围 |
描述 |
---|---|---|---|
domain_id |
是 |
最大长度:64 |
客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。 |
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
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。 此参数不携带、携带值为空、携带为null取默认值0;不支持携带为空串。
说明:
主资源是指有关联的几个资源中,处于主导位置的资源。
|
status_list |
否 |
String |
- |
资源状态。 查询指定状态的资源。多个状态以英文逗号分隔。
此参数不携带、携带为空时返回所有状态的资源数据;不支持携带值为空串、携带为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<ResourceInstance> |
资源列表。 具体请参见表3。 |
total_count |
Integer |
总记录数。 默认是0。 |
参数 |
参数类型 |
描述 |
---|---|---|
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”。您可以调用查询云服务类型列表接口获取。 |
resource_type_code |
String |
资源类型编码,例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 |
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 |
是否是主资源。
|
status |
Integer |
资源状态。状态说明请参见资源状态说明。
|
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 |
下一次扣费策略:
说明:
只有“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 }