查询客户用量明细（旧）

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

“客户用量明细”按月汇总（每月一个文件），每次生成的用量明细包含从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号的用量明细）。

• 包年/包月（仅包含转售类客户用量明细）：

  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. 包年/包月文件
   • 名称：

     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