客户运营能力-查询月度成本:URI

时间:2024-12-24 10:04:22

URI

GET /v2/costs/cost-analysed-bills/monthly-breakdown

URL参数说明请参见下表。
表1 消息头参数

参数

是否必选

参数类型

取值范围

描述

X-Language

String

最大长度:10

语言。

  • zh_CN:中文
  • en_US:英文

缺省为zh_CN。

表2 查询参数

参数

是否必选

参数类型

取值范围

描述

shared_month

String

最大长度:10

查询分摊成本的月份,东八区时间,格式:YYYY-MM。

charging_mode

Integer

[1-11]

计费模式。

  • 1:包年/包月
  • 3:按需
  • 10:预留实例
  • 11:节省计划

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

service_type_code

String

最大长度:64

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

此参数不携带或携带值为空时,不作为筛选条件;携带值为空串时,作为筛选条件。

resource_type_code

String

最大长度:64

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

此参数不携带或携带值为空时,不作为筛选条件;携带值为空串时,作为筛选条件。

region_code

String

最大长度:64

云服务区编码,例如:“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。

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

bill_type

Integer

-

账单类型。

  • 1:消费-新购
  • 2:消费-续订
  • 3:消费-变更
  • 4:退款-退订
  • 5:消费-使用
  • 8:消费-自动续订
  • 9:调账-补偿
  • 14:消费-服务支持计划月末扣费
  • 16:调账-扣费
  • 18:消费-按月付费
  • 20:退款-变更
  • 23:消费-节省计划抵扣
  • 24:退款-包年/包月转按需

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

offset

Integer

[0-最大整数]

偏移量,从0开始。默认值为0。

说明:

offset用于分页处理,如不涉及分页,请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1,则返回满足条件的第二个数据至最后一个数据。

示例1,满足查询条件的结果共10条数据,limit取值为10,offset取值为1,则返回的数据为2~10,第一条数据不返回。

示例2,查询总数20条,期望每页返回10条数据,则获取第一页数据,入参offset填写0,limit填写10;获取第二页数据,入参offset填写10,limit填写10。

limit

Integer

[1-1000]

每次查询的数量限制。默认值为10。

resource_id

String

最大长度:256

资源ID。

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

resource_name

String

最大长度:256

资源名称。

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

enterprise_project_id

String

最大长度:64

企业项目标识(企业项目ID)。

  • default项目对应ID:0
  • 未归集(表示该云服务不支持企业项目管理能力)项目对应ID:-1或null
  • 其余项目对应ID获取方法请参见如何获取企业项目ID

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

method

String

最大长度:64

查询资源消费记录的方式。

  • oneself:客户自己
  • sub_customer:企业子客户
  • all:客户自己和企业子客户

默认为all,如果没有企业子客户,取值为all时查询的是客户自己的资源消费记录。

此参数不携带,不作为筛选条件。

sub_customer_id

String

最大长度:64

企业子账号ID。

此参数不携带或携带值为空或携带值为空串时,不作为筛选条件。

说明:
  • 如果method取值不为sub_customer,则该参数无效。
  • 如果method取值为sub_customer,则该参数不能为空。
support.huaweicloud.com/api-oce/mbc_00010.html