查询客户用量明细(旧)
文件方式
伙伴在华为云伙伴中心订阅“客户用量明细”,了解客户的资源消耗情况。
系统每天12:00~20:00(东八区时间)之间(最晚每天24:00前)生成截止到前一天的客户用量明细文件。建议伙伴销售平台每天24:00定时获取客户用量明细文件。
- 文件获取地址
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
产品类型的名称。
- 包年/包月(仅包含转售类客户用量明细):
- 文件样例
- 包年/包月文件
- 名称:
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
- 名称:
- 按需文件
- 名称:
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
- 名称:
- 预留实例文件
- 名称:
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
- 名称:
- 包年/包月文件