文档首页/ 合作伙伴中心/ API参考/ 管理账单/ 管理客户用量/ 查询客户用量明细
更新时间：2024-02-22 GMT+08:00
查看PDF
分享

查询客户用量明细

功能介绍

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

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

文件方式

伙伴在华为云伙伴中心订阅“客户用量明细”，了解客户的资源消耗情况，如何订阅文件请参见这里。

  • 系统每天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

    文件名称。

    文件命名方式为：customerUsageV2_YYYYMM_YYYYMMDD.tar.gz。

    • 其中customerUsageV2_YYYYMM_YYYYMMDD.tar.gz为压缩包；
    • YYYYMM指导出的明细数据对应的月份，例如导出2019年2月份的数据，YYYYMM为201902；
    • YYYYMMDD指导出时间，例如2019年3月1日导出2019年2月1日到2月28日的数据，文件命名为：customerUsageV2_201902_20190301.tar.gz。

    压缩包里面包含的文本文件命名为：customerUsageV2_YYYYMM_YYYYMMDD_XXXXXXXX.csv，每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. 文件字段说明
    文件：customerUsageV2_YYYYMM_YYYYMMDD_XXXXXXXX.csv

    参数

    参数类型

    取值范围

    描述

    账期

    String

    最大长度：256

    该消费记录对应的账期。

    客户ID

    String

    最大长度：256

    消费归属客户的Domain ID。

    交易时间

    String

    最大长度：256

    交易时间。UTC时间。

    计费模式

    String

    最大长度：8

    计费模式：

    • 1：包周期
    • 3：按需
    • 10：预留实例
    • 11：节省计划

    账单类型

    String

    最大长度：8

    账单类型：

    • 1：消费-新购
    • 2：消费-续订
    • 3：消费-变更
    • 4：退款-退订
    • 5：消费-使用
    • 8：消费-自动续订
    • 9：调账-补偿
    • 12：消费-按时计费
    • 13：消费-退订手续费
    • 14：消费-服务支持计划月末扣费
    • 15：消费-税金
    • 16：调账-扣费
    • 17：消费-保底差额
      说明：

      保底差额=客户签约保底合同后，如果没有达到保底消费，客户需要补交的费用，仅限于直销或者伙伴顾问销售类子客户，且为后付费用户。

    • 20：退款-变更
    • 23：消费-节省计划抵扣
    • 24：退款-包年/包月转按需
    • 100：退款-退订税金
    • 101：调账-补偿税金
    • 102：调账-扣费税金

    资源ID

    String

    最大长度：256

    资源实例ID。如果资源是预留实例，此处是预留实例ID。

    资源名称

    String

    最大长度：256

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

    说明：

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

    资源标签

    String

    最大长度：11000

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

    购买资源包产品时，如果不是针对某一个具体的资源，该字段为空。

    说明：

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

    产品类型编码

    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”。具体请参见地区和终端节点对应云服务的“区域”列的值。

    项目ID

    String

    最大长度：256

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

    订单号/交易号

    String

    最大长度：256

    客户下单时生成的订单号。仅包年/包月产品存在，其他情况下为空。

    订单类型

    String

    最大长度：256

    订单类型，仅包周期存在，其他情况下为空：

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

    周期数

    String

    最大长度：256

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

    说明：
    • 仅包年/包月存在，其他情况下为空。
    • 值可为整数或小数。

    周期类型

    String

    最大长度：256

    包年/包月产品的周期类型，仅包年/包月存在，其他情况下为空：

    • 0：包天
    • 2：包月
    • 3：包年
    • 4：包小时
    • 99：未知

    使用量类型

    String

    最大长度：256

    使用量类型，您可以调用查询使用量类型列表接口获取。

    使用量

    String

    最大长度：256

    总的使用量。

    使用量单位

    String

    最大长度：256

    使用量单位。

    您可以调用查询度量单位列表接口获取。

    套餐内使用量

    String

    最大长度：256

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

    套餐内使用量单位

    String

    最大长度：256

    套餐内使用量对应的单位。

    您可以调用查询度量单位列表接口获取。

    预留实例内使用量

    String

    最大长度：256

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

    预留实例内使用量单位

    String

    最大长度：256

    预留实例内使用量对应的单位。

    您可以调用查询度量单位列表接口获取。

    消费金额

    String

    最大长度：256

    华为云官网成交价格，不包含华为云给伙伴的商务优惠。

    单位：美元。

    说明：

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

    单价

    String

    最大长度：256

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

    单价单位

    String

    最大长度：256

    产品的单价单位。

    • 线性产品的单价单位为“元/{线性单位}/月”或“元/{线性单位}/小时”等。
    • 非线性产品的单价单位为“元/月”或“元/小时”等。
    说明：

    “线性单位”为线性产品（即有大小概念的产品）的大小的单位，比如硬盘的线性单位为GB，带宽的线性单位为Mbps。

    例如：0.6元/10000次。按步长定价时，单价为0.6，单价单位为元，步长为10000，步长单位为次；给用户呈现时单价为0.6，单价单位为元/10000次。

    组合交易号

    String

    最大长度：256

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

    该字段为预留字段。

    产品类型名称

    String

    最大长度：200

    产品类型的名称。

    资源类型名称

    String

    最大长度：200

    资源类型的名称。
  1. 文件样例

    账期,客户ID,交易时间,计费模式,账单类型,资源ID,资源名称,资源标签,产品类型编码,资源类型编码,产品ID,产品名称,产品规格,区域编码,项目ID,订单号/交易号,订单类型,周期数,周期类型,使用量类型,使用量,使用量单位,套餐内使用量,套餐内使用量单位,预留实例内使用量,预留实例内使用量单位,消费金额,单价,单价单位,组合交易号,产品类型名称,资源类型名称

    Apr-21,4FB84D6C27DB4C768B0940560C2AB2CE,2021-04-26 16:13:35 GMT+08:00,1,1,34ae3e78-d93e-4d46-9bc7-aa8532e44d18,FALSE,111,hws.service.type.ebs,hws.resource.type.volume,5797403154426640,GD3型线性云硬盘_包月,GD3型线性云硬盘_包月1,cn-north-1,ab7eb17368654ff4b1bb3c63c6a478e0,CS20012416121ADNL2,1,1,99,Duration-1,12312.125,1,123,3,120,1,8400,12312.123,1,CS20012416121ADNL3,Elastic Cloud Server,Cloud Host

父主题： 管理客户用量