文档首页> 合作伙伴中心> API参考> 待下线接口> 管理账单> 查询客户用量明细(旧)
更新时间:2024-02-07 GMT+08:00

查询客户用量明细(旧)

功能介绍

伙伴可以查询客户用量明细。

该接口即将下线,“查询客户用量明细”接口请参考查询客户用量明细

客户用量明细数据存在延时,该数据不能用在监控、预算控制等对数据准确性要求高的场景。

文件方式

伙伴在华为云伙伴中心订阅“客户用量明细”,了解客户的资源消耗情况。

系统每天12:00~20:00(东八区时间)之间(最晚每天24:00前)生成截止到前一天的客户用量明细文件。建议伙伴销售平台每天24:00定时获取客户用量明细文件。

  1. 文件获取地址

    https://bucketname.obs.Endpoint.myhuaweicloud.com/customerUsage/filename

    表1 参数说明

    参数

    描述

    bucketname

    OBS桶名称。仅支持使用在华为云香港区域购买的OBS桶。如何创建桶请参见创建桶

    说明:

    伙伴账号无法购买资源,可以使用任意客户账号购买OBS桶资源。

    Endpoint

    指定承载REST服务端点的服务器域名或IP,从地区和终端节点获取。

    customerUsage

    系统上传客户用量明细文件的文件夹名称。

    filename

    文件名称。

    文件命名方式为:customerUsage_YYYYMM_YYYYMMDD.tar.gz。

    其中customerUsage_YYYYMM_YYYYMMDD.tar.gz为压缩包;

    YYYYMM指导出的明细数据对应的月份,例如导出2019年2月份的数据,YYYYMM为201902;

    YYYYMMDD指导出时间,例如2019年3月1日导出2019年2月1日到2月28日的数据,文件命名为:customerUsage_201902_20190301.tar.gz。

    压缩包里面包含的文本文件命名为:customerUsage_MonthlyYearly_YYYYMM_YYYYMMDD_XXXXXXXX.csv、customerUsage_PerByUse_YYYYMM_YYYYMMDD_XXXXXXXX.csv、customerUsage_RI_YYYYMM_YYYYMMDD_XXXXXXXX.csv、

    customerUsage_SP_YYYYMM_YYYYMMDD_XXXXXXXX.csv,xxxx为序列号,每100000条记录一个csv文件。

  1. 用量明细生成时间

    “客户用量明细”按月汇总(每月一个文件),每次生成的用量明细包含从1号开始的增量数据。由于用量明细数据生成后,可能会存在变化,请以最新获取的用量明细数据为准。

    系统每天12:00~20:00(东八区时间)之间(最晚每天24:00前)生成用量明细:

    • 每个月1号生成上个月的用量明细(例如8月1号生成7月份的用量明细);
    • 每个月2号到4号生成本月和上月两个月的用量明细(例如8月3号生成8月1号至8月2号的用量明细和7月份的用量明细);
    • 5号到月末生成本月的用量明细(例如8月6号生成8月1号至8月5号的用量明细)。

  1. 文件字段说明
    • 包年/包月(仅包含转售类客户用量明细):

      customerUsage_MonthlyYearly_YYYYMM_YYYYMMDD_XXXXXXXX.csv

      参数

      参数类型

      取值范围

      描述

      客户ID

      String

      最大长度:256

      消费归属客户的domainID。

      消费/退订时间

      String

      最大长度:256

      UTC时间。

      资源ID

      String

      最大长度:256

      资源实例ID。

      资源名称

      String

      最大长度:256

      客户在创建资源实例时填写的名称。

      说明:

      如果录入的是存在注入风险的字符串(例如{"=", "+", "-", "@"}且这些字符后非纯数字),则导出时需在此字段前后加入双引号""。

      产品类型编码

      String

      最大长度:64

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

      资源类型编码

      String

      最大长度:100

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

      产品ID

      String

      最大长度:256

      产品ID。

      产品名称

      String

      最大长度:256

      产品名称。

      产品规格

      String

      最大长度:256

      产品规格,例如:

      General Computing|s2.small.1|1vCPUs|1GB|linux

      云服务区

      String

      最大长度:64

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

      订单号

      String

      最大长度:256

      客户下单时生成的订单号。

      订单类型

      String

      最大长度:256

      订单类型:

      • 1:开通
      • 2:续订
      • 3:变更
      • 4:退订
      • 10:包年/包月转按需
      • 11:按需转包年/包月
      • 13:试用
      • 14:转商用
      • 15:费用调整

      购买时长

      String

      最大长度:256

      购买包年/包月产品的周期长度。

      周期类型

      String

      最大长度:256

      包年/包月产品的周期类型:

      0:包天;

      1:包周;

      2:包月;

      3:包年;

      4:包小时。

      5:一次性

      消费金额

      String

      最大长度:256

      华为云官网成交价格,不包含华为云给伙伴的商务优惠,单位为美元。

      项目ID

      String

      最大长度:256

      资源归属的项目ID,在购买资源的时候可以选择属于哪个项目。

      资源标签

      String

      最大长度:11000

      资源标签,客户在管理资源的时候,可以设置标签。包年/包月情况下,如果某个包年/包月产品不属于某个具体的资源(譬如按需套餐包这种购买使用时长的产品,就不是针对某一个具体资源的),该字段为空。

      说明:

      如果录入的是存在注入风险的字符串(例如{"=", "+", "-", "@"}且这些字符后非纯数字),则导出时需在此字段前后加入双引号""。

      组合交易号

      String

      最大长度:256

      客户下单时生成的组合交易号。仅包年/包月产品存在,其他情况下为空。

      该字段为预留字段。

      产品类型名称

      String

      最大长度:200

      产品类型的名称。

      资源类型名称

      String

      最大长度:200

      资源类型的名称。

    • 按需(仅包含转售类客户用量明细):

      customerUsage_PerByUse_YYYYMM_YYYYMMDD_XXXXXXXX.csv

      参数

      参数类型

      取值范围

      描述

      客户ID

      String

      最大长度:256

      消费归属客户的domainID。

      消费时间

      String

      最大长度:256

      资源消耗区间,UTC时间。

      账期

      String

      最大长度:256

      该消费记录对应的账期。

      资源ID

      String

      最大长度:256

      资源实例ID。

      资源名称

      String

      最大长度:256

      客户在创建资源实例时填写的名称。

      说明:

      如果录入的是存在注入风险的字符串(例如{"=", "+", "-", "@"}且这些字符后非纯数字),则导出时需在此字段前后加入双引号""。

      产品类型编码

      String

      最大长度:64

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

      资源类型编码

      String

      最大长度:100

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

      产品ID

      String

      最大长度:256

      产品ID。

      产品名称

      String

      最大长度:256

      产品名称.

      产品规格

      String

      最大长度:256

      产品规格,例如:

      General Computing|s2.small.1|1vCPUs|1GB|linux

      云服务区

      String

      最大长度:64

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

      计费项

      String

      最大长度:256

      使用量因子。也就是使用量类型

      取值和话单中的使用量因子一致,云服务和使用量因子对应关系如下:

      • 云服务器:Duration
      • 云硬盘:Duration
      • 弹性IP:Duration
      • 带宽:Duration(按带宽询价)或upflow(按流量询价)
      • 市场镜像:Duration

      使用量

      String

      最大长度:256

      总的使用量。

      套餐内使用量

      String

      最大长度:256

      匹配到套餐内的使用量。该使用量不参与按需的价格计算。

      预留实例内使用量

      String

      最大长度:256

      匹配到预留实例内的使用量。该使用量不参与按需的价格计算。

      使用量单位

      String

      最大长度:256

      使用量的单位,目前有:

      • 0:天(时长);
      • 1:元(货币);
      • 2:角(货币);
      • 3:分(货币);
      • 4:小时(时长);
      • 5:分钟(时长);
      • 6:秒(时长);
      • 7:EB(流量);
      • 8:PB(流量);
      • 9:TB(流量);
      • 10:GB(流量);
      • 11:MB(流量);
      • 12:KB(流量);
      • 13:Byte(流量);
      • 14:个(次)(数量);
      • 15:Mbps(流量);
      • 16:Byte(容量);
      • 17:GB(容量);
      • 18:KLOC(行数);
      • 19:年(周期);
      • 20:月(周期);
      • 21:MB(容量);
      • 22:赫兹(频率);
      • 23:核(数量);
      • 24:天(周期);
      • 25:小时(周期);
      • 30:个数(个数);
      • 31:千次(数量);
      • 32:百万次(数量);
      • 33:十亿次(数量);
      • 34:bps(带宽速率);
      • 35:kbps(带宽速率);
      • 36:Mbps(带宽速率);
      • 37:Gbps(带宽速率);
      • 38:Tbps(带宽速率);
      • 39:GB-秒(容量时长);
      • 40:次(数量);
      • 41:个(数量);
      • 42:千个(数量);
      • 43:张(数量);
      • 44:千张(数量);
      • 45:每秒查询率(查询速率);
      • 46:人/天(数量);
      • 47:TB(容量);
      • 48:PB(容量)。

      消费金额

      String

      最大长度:256

      华为云官网成交价格,不包含华为云给伙伴的商务优惠,单位为美元。

      如果华为云对于按需的欠款进行核销,或者对于多扣的金额进行退费,则会产生一条金额为负值的记录。

      项目ID

      String

      最大长度:256

      资源归属的项目ID,在购买资源的时候可以选择属于哪个项目。

      资源标签

      String

      最大长度:11000

      资源标签,客户在管理资源的时候,可以设置标签。

      说明:

      如果录入的是存在注入风险的字符串(例如{"=", "+", "-", "@"}且这些字符后非纯数字),则导出时需在此字段前后加入双引号""。

      单价

      String

      最大长度:256

      按需产品的单价,只有统一价格的情况下才有值,如果是分档计费该字段为空。

      单价单位

      String

      最大长度:256

      单价单位。

      例:对于那种按步长定价的, 比如0.6元/10000次; 单价为0.6, 单价单位为元,步长为10000,步长单位为次;给用户呈现时单价为0.6,单价单位为元/10000次

      产品类型名称

      String

      最大长度:200

      产品类型的名称。

      资源类型名称

      String

      最大长度:200

      资源类型的名称。

    • 预留实例(仅包含转售类客户用量明细):

      customerUsage_RI_YYYYMM_YYYYMMDD_XXXXXXXX.csv

      参数

      参数类型

      取值范围

      描述

      客户ID

      String

      最大长度:256

      消费归属客户的domainID。

      消费/退订时间

      String

      最大长度:256

      UTC时间。

      费用类型

      String

      最大长度:256

      1:订购

      2:续订

      3:变更

      4:退订

      8:自动续订

      12:RI周期性费用

      预留实例ID

      String

      最大长度:256

      购买的预留实例的实例ID。

      预留实例名称

      String

      最大长度:256

      预留实例的名称。

      说明:

      如果录入的是存在注入风险的字符串(例如{"=", "+", "-", "@"}且这些字符后非纯数字),则导出时需在此字段前后加入双引号""。

      产品类型编码

      String

      最大长度:64

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

      云服务区

      String

      最大长度:64

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

      产品

      String

      最大长度:256

      产品ID。

      订单号

      String

      最大长度:256

      预留实例订单的订单ID。

      消费金额

      String

      最大长度:256

      华为云官网成交价格,不包含华为云给伙伴的商务优惠,单位为美元。

      项目ID

      String

      最大长度:256

      资源归属的项目ID,在购买资源的时候可以选择属于哪个项目。

      资源标签

      String

      最大长度:11000

      资源标签,客户在管理资源的时候,可以设置标签。

      目前预留实例不属于某个具体资源,该字段目前为空(预留)。

      说明:

      如果录入的是存在注入风险的字符串(例如{"=", "+", "-", "@"}且这些字符后非纯数字),则导出时需在此字段前后加入双引号""。

      产品类型名称

      String

      最大长度:200

      产品类型的名称。

  1. 文件样例
    1. 包年/包月文件
      • 名称:

        customerUsage_MonthlyYearly_201905_20190521_232738ebd8d044ac8006571d694ff05d.csv

      • 内容:

        Customer,Expenditure or Unsubscription Time,Resource ID,Resource Name,Product Type Code,Resource Type Code,Product ID,Product Name,Product Specifications,Region,Order No.,Order Type,Duration,Period Type,Amount(USD),Project ID,Resource Tag,Product Type Name,Resource Type Name

        37be0256053e467ba425d6dd61135370,2019-05-06 14:30:25 GMT+00:00,57f5faa7-0aa5-4f13-91e7-b838a6b69178,volume-220f,hws.service.type.ebs,hws.resource.type.volume,00301-03439-0--0,GD3 linear EVS_Monthly,Common IO|10.0|17,cn-north-7,CS1905061430U2BKA,4,,2,0.00,6a4cffd705254584a4386d30b3e15df9,resourcetag008,lastic Cloud Server,Cloud Host

    2. 按需文件
      • 名称:

        customerUsage_PerByUse_201905_20190521_c40692bef76442e688e044530d62eb03.csv

      • 内容:

        Customer,Expenditure Time,Billing Cycle,Resource ID,Resource Name,Product Type Code,Resource Type Code,Product ID,Product Name,Product Specifications,Region,Billing Item,Usage,Package Usage,Reserved Instance Usage,Unit,Amount(USD),Project ID,Resource Tag,Unit,Unit Price,Product Type Name,Resource Type Name

        b9965f7fa88a49d3aa571d6ab25543fb,2019-05-01 10:00:00 GMT+00:00 - 2019-05-01 23:59:59 GMT+00:00,20190501,bf930731-996d-422e-a2ec-f556d88bc784,ecs-a5d9-volume-0001,hws.service.type.ebs,hws.resource.type.volume,00301-18779-0--0,GD3 linear EVS_On demand,Common IO|duration,cn-north-7,duration,"22,545.00",,0.00,6,0.02,6a4cffd705254584a4386d30b3e15df9,resourcetag001,0,1,lastic Cloud Server,Cloud Host

    3. 预留实例文件
      • 名称:

        customerUsage_RI_201905_20190521_f5ee75c834494106b39f4511d20cb416.csv

      • 内容:

        Customer,Expenditure or Unsubscription Time,Expenditure Type,Reserved Instance ID,Reserved Instance Name,Product Type Code,Region,Product,Order No.,Amount(USD),Project ID,Resource Tag,Product Type Name

        37be0256053e467ba425d6dd61135370,2019-05-07 15:01:17 GMT+00:00,Subscribed Order,01154-3100049-0,,hws.service.type.ec2,cn-north-7,General Computing Enhaced_C3_2U4G_linux reserve,CS19050715008ZEL8,516.84,6a4cffd705254584a4386d30b3e15df9,resourcetag002,lastic Cloud Server