更新时间:2023-03-31 GMT+08:00
分享

查询客户包年/包月资源列表

功能介绍

客户在自建平台查询某个或所有的包年/包月资源。

注意事项:

  • 该接口允许客户的AK/SK或者Token调用。
  • 该接口只能查询开通成功的资源。
  • 成功调用本接口后,如果您需要对已生效状态的资源进行续订,您可以调用“查询包年/包月产品价格”接口对查询到的包年/包月资源进行续订询价,然后再调用“续订包年/包月资源”接口进行续订。

    该接口即将下线,“查询客户包年/包月资源列表”接口请参考查询客户包年/包月资源列表

URI

GET /v1.0/{domain_id}/common/order-mgr/resources/detail

参数说明请参见下表。

表1 路径参数

参数

是否必选

取值范围

描述

domain_id

最大长度:64

客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id

表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-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息

响应参数

参数

参数类型

描述

error_code

String

状态码。

具体请参见状态码

error_msg

String

错误描述信息。

data

List<ResourceInstance>

资源列表。

具体请参见表3

total_count

Integer

总记录数。

默认是0。

表3 ResourceInstance

参数

参数类型

描述

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

是否是主资源。

  • 0:非主资源
  • 1:主资源

status

Integer

资源状态。状态说明请参见资源状态说明

  • 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
}

状态码

  • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
  • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

HTTP状态码

错误码

描述

200

CBC.0000

成功。

400

CBC.0100

参数错误。

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

分享:

    相关文档

    相关产品