云服务器内容精选

  • 请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 cycle 是 String 最大长度:8 查询的资源详单所在账期,东八区时间,格式为YYYY-MM。 示例:2019-01。 cloud_service_type 否 String 最大长度:64 云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 resource_type 否 String 最大长度:64 资源类型编码,例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 region 否 String 最大长度:64 云服务区编码,例如:“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 res_instance_id 否 String 最大长度:64 资源实例ID。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 charge_mode 否 Integer - 计费模式。 1 : 包年/包月 3:按需 10:预留实例 11:节省计划 此参数不携带或者携带值为null时,返回所有计费模式的资源详单数据记录。 bill_type 否 Integer - 账单类型: 1:消费-新购 2:消费-续订 3:消费-变更 4:退款-退订 5:消费-使用 8:消费-自动续订 9:调账-补偿 14:消费-服务支持计划月末扣费 16:调账-扣费 18:消费-按月付费 20:退款-变更 23:消费-节省计划抵扣 24:退款-包年/包月转按需 此参数不携带或者携带值为null时,返回所有账单类型的资源详单数据记录。 enterprise_project_id 否 String 最大长度:64 企业项目标识(企业项目ID)。 default项目对应ID:0 未归集(表示该云服务不支持企业项目管理能力)项目对应ID:-1 其余项目对应ID获取方法请参见如何获取企业项目ID。 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 include_zero_record 否 Boolean - 返回是否包含应付金额为0的记录。 true: 包含 false: 不包含 此参数不携带或携带值为空串或携带值为null时,不作为筛选条件。 method 否 String 最大长度:64 查询方式。 oneself:客户自己 sub_customer:企业子客户 all:客户自己和企业子客户 此参数不携带或携带值为空串或携带值为null时,默认值为“all”,如果没有企业子客户,all的时候也是查询客户自己的数据。 说明: 若需要查询财务独立企业子的账单信息,前提是子账号已经接受了企业主账号的“允许查看子账号消费信息”的申请。申请方法见“变更子账号权限”。 sub_customer_id 否 String 最大长度:64 企业子账号ID。 说明: 如果method取值不为sub_customer,则此参数无效。 如果method取值为sub_customer,则此参数不能为空。 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。 statistic_type 否 Integer [1-2] 统计类型。默认值为1。 1:按账期 2:按天 该参数不携带或携带值为null时,取默认值1;不支持携带为空串。 query_type 否 String [0-9] 查询类型。默认值为BILLCYCLE。 BILLCYCLE:按月 DAILY:按天 仅当statistic_type=2时,支持传递query_type=DAILY。 该参数不携带或携带值为null或携带为空串时,取默认值BILLCYCLE。 bill_cycle_begin 否 String [0-10] 账期开始时间。格式为YYYY-MM-DD。 仅当query_type=DAILY时,必须传递账期开始时间。 该参数不携带或携带值为null或携带为空串时,不作为筛选条件。 说明: 如果query_type取值不为DAILY,则该参数无效。 如果query_type取值为DAILY,则该参数不能为空,必须和cycle(即资源详单所在账期)在同一个月。 bill_cycle_end 否 String [0-10] 账期结束时间。格式为YYYY-MM-DD。 仅当query_type=DAILY时,必须传递账期结束时间。 该参数不携带或携带值为null或携带为空串时,不作为筛选条件。 说明: 如果query_type取值不为DAILY,则该参数无效。 如果query_type取值为DAILY,则该参数不能为空,必须和cycle(即资源详单所在账期)在同一个月。 请求示例 POST https://bss.myhuaweicloud.com/v2/bills/customer-bills/res-records/query HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ X-Language:zh_CN { "cycle": "2018-12", "cloud_service_type": "hws.service.type.ec2", "resource_type": "hws.resource.type.vm", "region": "cn-north-1", "res_instance_id": "76*****7f", "charge_mode": 1, "bill_type": 1, "enterprise_project_id": "6***f3-3**4-4**2-9a3e-a****c24", "include_zero_record": "true", "method": "sub_customer", "sub_customer_id": "05b5fef62300d2ad0f98c00befba72c0", "offset": 1, "limit": 10 }
  • 功能介绍 客户在自建平台查询自己的资源详单,用于反映各类资源的消耗情况。 客户登录费用中心查询资源详单请参见这里。 由于资源消费呈现的是资源维度的8位小数原始消费金额,实际从账户扣费时按2位小数进行扣费(即扣到分),会存在精度差异,所以,不推荐消费汇总和资源消费直接对账。 若需要查询财务独立企业子的账单信息,前提是子账号已经接受了企业主账号的“允许查看子账号消费信息”的申请。申请方法见“变更子账号权限”。 支持查看近3年的数据。
  • 账单说明 账单分为通用账单、联营账单、严选账单&严选自营账单,通用账单是通用商品产生的账单。如果商家没有联营商品,则不会产生联营账单。 华为云云商店通用商品的账单说明如表1 通用商品账单说明所示。 表1 通用商品账单说明 账单项 说明 商品销售金额 “商品1”单价*其对应购买时长 *“商品1”数量+“商品2”单价*其对应的购买时长 * “商品2”数量+…“商品n”单价 *其对应购买时长 * “商品n”数量【n=订单中商品的类型总数】。 本期结算金额 指商品销售金额按协议约定计算出来在本结算账期应结算给商家的金额。 2024年3月1日前:商家结算金额 =(商品销售金额 –代金券扣款)*(1-平台费比例) 2024年3月1日后:商家结算金额 =(商品销售金额 –代金券扣款)*(1-平台费比例+区间增量分成比例) 说明: ① 自2024年3月1日00:00(北京时间)起,云商店通用商品平台服务费政策调整,增加基于月度的客户实际付费金额,增加增量分成比例,单个商品月度达成一定区间的阶梯付费金额后,将根据客户付费金额的对应区间增量分成比例从华为云平台费扣减并结算给商家,详细信息请参考《关于华为云云商店2024年3月1日00:00(北京时间)通用商品平台服务费政策调整的通知》。 ② 自2019年5月1日开始,云商店对所有通用商品执行平台服务费减半的优惠政策,即:所有通用商品按订单交易金额的5%收取平台服务费。本期结算金额=商品销售金额*(1-5%) 华为云云商店联营商品的账单说明如表2 联营商品账单说明所示。 表2 联营商品账单说明 账单项 说明 商品销售金额 “商品1”单价*其对应购买时长 *“商品1”数量+“商品2”单价*其对应的购买时长 * “商品2”数量+…“商品n”单价 *其对应购买时长 * “商品n”数量【n=订单中商品的类型总数】。 产品成交价 指订单实付金额。 如订单使用了商家发放的代金券,此代金券成本由商家承担,成交价=实付金额-代金券金额 如订单使用了销售折扣,则成交价=目录价*折扣 本期结算金额 指商品销售金额按协议约定计算出来在本结算账期应结算给商家的金额。 商品销售收入分成基数 成交价分成计算公式:(成交价*伙伴结算比例*数量*时长)/(1+税率) 底价折扣分成计算公式:(目录价*底线折扣*伙伴结算比例*数量*时长)/(1+税率) 说明: 计税规则请参考商品计税及计费模式。 伙伴结算比例 按照商品上架时约定的分成比例,每个商品的分成比例不同。 按税率拆分金额(含税) 若账单中包含多种税率的订单,则按照不同税率的订单金额汇总显示。例如本期结算金额为100元,其中包含2种税率订单:13%、6%,结算金额分别90和10,则展示为:13.00%:90|3.00%:10 华为云云商店严选商品的账单说明如表3 严选&严选自营商品账单说明所示。 表3 严选&严选自营商品账单说明 账单项 说明 商品销售金额 “商品1”单价*其对应购买时长 *“商品1”数量+“商品2”单价*其对应的购买时长 * “商品2”数量+…“商品n”单价 *其对应购买时长 * “商品n”数量【n=订单中商品的类型总数】。 本期结算金额 指商品销售金额按协议约定计算出来在本结算账期应结算给商家的金额。 商品销售收入分成基数 该分成基数按如下公式进行计算:(“商品1”底价*其对应购买时长 *“商品1”数量+“商品2” 底价*其对应的 购买时长 * “商品2”数量+…“商品n” 底价*其对应购买时长 * “商品n”数量【n=订单中商品的类型总数】) / (1+按税法规定的税率)。 分成比例 指按协议约定的商家对应的分成比例。 伙伴不含税收入 严选商品销售收入分成基数 * 分成比例。 华为云云商店不同交易场景下,账单说明如下: 交易场景 场景说明 商家结算金额(含税) 备注 CPPO场景 CPPO为针对通用商品的销售策略,此场景下,商家和客户服务商协商分成。商家授权部分商家分成用于激励客户服务商销售,即客户服务商分成来自商家分成。 商家结算金额(含税)=订单成交价*(1-平台费分成比例-客户服务商分成比例)*数量*时长 客户服务商分成比例为商家和客户服务商约定的分成比例,不同商品的分成比例不同。 ISV阶梯分成场景 针对通用商家,云商店在原平台服务费政策基础上,基于单商品月度累计销售额的GMV达成,减免部分平台服务费并按月结算给商家。具体方案请参考《关于华为云云商店2024年3月1日00:00(北京时间)通用商品平台服务费政策调整的通知》。 常规销售场景:商家结算金额(含税)=(订单成交价-代金券扣款)*(1-平台费分成比例+区间增量分成比例) 单商品月度累计销售额的GMV达成,计算方式如下。 常规销售场景下:商家单商品月度累计销售额=订单1成交价*(1-平台费分成比例)+订单2成交价*(1-平台费分成比例)+……订单n成交价*(1-平台费分成比例) CPPO销售场景下:商家单商品月度累计销售额=订单1成交价*(1-平台费分成比例-客户服务商分成比例)+订单2成交价*(1-平台费分成比例-客户服务商分成比例)+……订单n成交价*(1-平台费分成比例-客户服务商分成比例) CPPO销售场景:商家结算金额(含税)=(订单成交价-代金券扣款)*(1-平台费分成比例+区间增量分成比例-客户服务商分成比例) 商家Private Offer场景 商家PO场景下按销售项目贡献价值进行多方分成,华为云给出销售分成,由销售方获得该销售分成,有如下两种场景。 商家独立销售,由商家面向客户创建专属优惠并申请销售分成。 此场景下,商家进行销售,可以在原定的商品分成比例基础上,向华为云申请销售分成比例,从华为云的分成比例中让利给商家。 成交价分成模式:商家结算金额(含税)=订单成交价*(商品分成比例+销售分成比例)-代金券扣款 底价折扣分成模式:商家结算金额(含税)=商品目录价*底线折扣*商家分成比例-代金券扣款 适用联营商品,商家独立销售场景下,底价折扣分成模式的商品,商家销售分成比例默认0;客户服务商和商家联合销售场景,只适用成交价分成模式的联营商品。 客户服务商和商家联合销售,即客户服务商共享机会点给商家并与商家协商机会点分成,协商的分成范围为销售分成和商家商品分成让利。 成交价分成模式:商家结算金额(含税)=订单成交价*(商品分成比例 - 商家让利机会点分成比例)-代金券扣款 成交价分成和底价折扣场景(且非商家Private Offer) 商品上架时需选择交易模式为成交价分成或底价折扣分成,两种交易模式的结算方式不同。 成交价分成模式下,通用商品上架时需约定商家分成比例,联营商品和自服务商品需约定商家分成比例和客户服务商分成比例。 通用商品商家结算金额(含税)=订单成交价*商家分成比例 -代金券ISV承担金额 联营、自服务商品商家结算金额(含税)=订单成交价*商家分成比例 -代金券扣款 通用商品非CPPO订单不涉及客户服务商分成。 联营、自服务商品支持底价折扣模式,该模式下,商品上架时需约定底线折扣、客户服务商授权折扣、商家分成比例和客户服务商分成比例。其中,客户服务商授权折扣需高于底线折扣。 商家结算金额(含税)=目录价*底线折扣*商家分成比例 -代金券扣款 / 涉及赋能云、基地云管理费的场景 赋能云、基地云项目用户购买云商店销售的联营商品,如涉及须按政府要求给运营公司支付运营管理费,云商店将在与商家结算时从相应交易中扣减赋能云、基地云运营管理费。 成交价分成模式下,商家结算金额(含税)计算方式如下: 商家结算金额(含税)= (联营订单成交价-赋能云或基地云运营管理费(如涉及)) *商家结算比例-代金券扣款 底价折扣模式下,商家结算不涉及管理费,成交价分成模式下,商家结算需扣减管理费。 客户服务商结算不涉及管理费。 底价折扣分成模式下,商家结算金额(含税)计算方式如下: 商家结算金额(含税) = 联营商品目录价 *销售底价折扣*结算比例-代金券扣款 父主题: 账单管理
  • 账单汇总 展示用户总费用金额和总费用构成。 账单汇总 消费汇总:账单类型为消费的汇总金额,如包年/包月新购、续订、变更、按需使用等。 退款汇总:账单类型为退款的汇总金额,如包年/包月退订、降配等。 调账汇总:账单类型为调账的汇总金额,如调账补偿、调账扣费等。 总费用(应付金额):客户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含:商务折扣等各种折扣。 总费用构成 总费用构成 = 现金支付 + 信用额度支付 + 代金券抵扣 + 现金券抵扣 + 储值卡抵扣 + 欠费金额 = 总费用(应付金额)。
  • 多维度汇总表格(按产品/按产品规格) 使用API查询汇总账单请参见“查询汇总账单”。 官网价:华为云商品在官网上未叠加应用商务折扣、促销折扣等优惠的销售价格。官网价 = 优惠金额 + 抹零金额 + 应付金额。 应付金额:客户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含:商务折扣等各种折扣。应付金额 = 现金支付 + 信用额度支付 + 代金券抵扣 + 现金券抵扣 + 储值卡抵扣 + 欠费金额。 消费账单折扣率:仅当“账单类型”为“全部”和“消费”时展示。消费账单折扣率= (1-优惠金额/官网价)*100%。 支持客户按产品和产品规格查看账单汇总数据 按产品汇总:根据产品类型、产品、计费模式、账单类型展示费用的汇总数据。 按产品规格汇总:根据产品类型、产品、计费模式、订单号、账单类型、规格、区域、企业项目展示费用的汇总数据。 客户可以根据自己关心的内容,单击“定制列”,设置列表中需要展示或隐藏的字段。 支持汇总表格内容和表格视图的自定义设置 单击“多维度设置”,可自定义设置表格内容、嵌套结构等。 选择按照“产品汇总”或“产品规格汇总”维度查看表格内容,以及按固定表或自定义分组查看表格视图。 表格视图选择“多维度表格”时,可自定义分组显示账单。 1、单击“上移/下移”,调整嵌套层级的次序。 2、单击“删除”,删除对应层级。 3、单击“添加层级”,新增嵌套层级,最多支持4级嵌套。 设置完成后,单击“确定”,账单列表如下所示。单击或,可显示或隐藏嵌套数据。 表格视图选择“固定表”时,不支持分组和表格嵌套。设置成固定表后,账单列表如下所示。
  • 流水账单 展示每一笔订单和每个计费周期维度构成的账单,华为云根据此账单进行扣费和结算。 使用API查询流水账单请参见“查询流水账单”。 进入“流水账单”页面。 设置查询条件,查看流水账单数据。 计费模式为“包年/包月”的产品完成支付后,准实时呈现在流水账单页面。计费模式为“按需”的产品,扣费和结算的详细信息请参见按需产品周期结算说明。 在搜索框中添加筛选条件,设置“应付金额(隐藏0元消费)”。 单击“操作列”的“详情”,可查看该流水账单的详细信息。 单击表格右上方,可以定制需要查看的账单字段,字段的详细说明请参见账单字段说明。
  • 明细账单 明细账单可以通过多维度展示客户账单的详细信息。 进入“明细账单”页面。 设置统计维度和统计周期,查看账单的详细信息。 设置统计维度:单击“维度设置”,可设置账单的统计维度: 按使用量查看账单:提供使用量维度的账单信息,包含资源ID、资源标签、规格、使用量详细信息等。 按资源名称/ID查看账单:提供资源维度的账单信息,包含资源ID、资源标签、规格等信息。 按产品查看账单 按产品类型查看账单 按账号查看账单 设置统计周期: 按账期:根据账期展示账单数据。 按天:根据账期、日期展示账单数据。 明细:根据账期、消费时间、交易时间等展示账单数据。 定制账单列字段:单击表格右上方“定制列”,可以定制需要查看的账单字段,字段的详细说明请参见账单字段说明。 按需计费模式为简单定价(使用量*单价)时提供单价信息,其他的定价如:阶梯定价、小额累计等不提供单价。 在搜索框中添加筛选条件,设置“应付金额(隐藏0元消费)”。 查看统计维度为“按使用量”,统计周期为“明细”的账单时: 按需和包年包月产品的使用量明细账单: 从2020/11/15 00:00:00开始,“优惠类型”字段按照实际享受的优惠类型进行赋值;2020/11/15 00:00:00以前的历史数据中不展示该字段取值,统一设置为“--”。 从2021/08/01 00:00:00开始,“优惠信息”字段按照实际享受的优惠信息进行赋值;2021/08/01 00:00:00以前的历史数据中不展示该字段取值,统一设置为“--”。 查看统计维度为“按使用量”,统计周期为“按账期”或“按天”账单时: 包年包月产品的使用量按天/按账期账单,“优惠类型”和“优惠信息”字段分别按照实际享受的优惠类型和优惠信息进行赋值。 按需产品的使用量按天/按账期账单从2022/08/01 00:00:00开始,“优惠类型”和“优惠信息”字段分别按照实际享受的优惠类型和优惠信息进行赋值;2022/08/01 00:00:00以前的历史数据中不展示“优惠类型”和“优惠信息”字段取值,统一设置为“--”。 对于包年包月产品,如果客户在云服务控制台更新了资源名称和资源标签,该产品消费明细账单中,对于已过期资源信息(资源名称、资源标签)不支持更新。示例如下: 操作: 2023年10月10日,客户订购了包年包月产品硬盘EVS,购买时长为1个月。费用中心生成新购订单。 2023年11月08日,客户对该订单进行续费,续费时长为1个月。费用中心生成续费订单。 2023年11月20日,客户在EVS云服务控制台更新了资源名称和资源标签。 结果: 由于新购订单中的资源状态为已过期,该订单对应的明细账单中,资源名称、资源标签不会同步刷新。 由于续费订单中的资源状态为使用中,该订单对应的明细账单中,资源名称、资源标签会同步刷新。
  • 请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/bills/subcustomer-bills/res-fee-records?bill_cycle=2021-04&customer_id=D60F111AB9BB4ADAA99E940EF144EF40&service_type_code=86CC8C59F70342C885F8AB13AEDDF342®ion_code=0FE00BE8AEE3443C88C155033D1D0CAF&charging_mode=3&bill_detail_type=1&resource_id=88EB78D951A042629CF4D3A9370340B9&resource_name=B5F8A086477F469F8BAF0320441678D8&trade_id=4A9AFD7CFC2245419DDDE0B7AB813E18&account_manager_id=lvjingjing003&association_type=1&offset=0&limit=10&indirect_partner_id=5A2A73552DE24E07A996BB0DD5665464&bill_date_begin=2021-04-05&bill_date_end=2021-04-06
  • 功能介绍 伙伴在伙伴销售平台可实时查询子客户的消费记录,了解客户的资源消耗情况。 伙伴在伙伴中心查询客户消费明细请参见这里。 消费记录支持查询18个月内的记录。 如果是客户经理主管来查询,只支持按照单个客户经理查询,必须输入客户经理ID。 目前支持伙伴查询所有子客户(包含代售类和顾问销售类)的消费记录。 如您的顾问销售子客户同时是财务托管模式企业子账号,解绑前当月账期消费数据体现在企业子账号,解绑后当月消费数据体现在企业主账号。详情请见“如何查询财务托管模式企业子账号解绑当月账期的消费数据”。
  • URI GET /v2/bills/subcustomer-bills/res-fee-records 参数说明请参见表1-1。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 bill_cycle 是 String 最大长度:7 账期所在月份。 格式:YYYY-MM customer_id 是 String 最大长度:64 客户账号ID。您可以调用查询客户列表接口获取customer_id。 service_type_code 否 String 最大长度:64 云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空时,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 region_code 否 String 最大长度:64 云服务区编码,例如:“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空时,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 charging_mode 否 Integer - 计费模式。 1:包周期 3:按需 10:预留实例 11:节省计划 此参数不携带或携带值为空或携带为null时,默认查询所有计费模式下的消费记录;不支持携带值为空串。 bill_detail_type 否 Integer - 账单类型。 1:消费-新购 2:消费-续订 3:消费-变更 4:退款-退订 5:消费-使用 8:消费-自动续订 9:调账-补偿 14:消费-服务支持计划月末扣费 16:调账-扣费 18:消费-按月付费 20:退款-变更 23:消费-节省计划抵扣 24:退款-包年/包月转按需 此参数不携带或携带值为空或携带值为null时,不作为筛选条件;不支持携带值为空串。 resource_id 否 String 最大长度:64 资源标识。 此参数不携带或携带值为空时,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 resource_name 否 String 最大长度:128 资源名称。 此参数不携带或携带值为空时,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 trade_id 否 String 最大长度:64 订单ID或交易ID,扣费维度的唯一标识。 账单类型为1,2,3,4,8时为订单ID。 其它场景下为交易ID。 非月末扣费:应收ID 月末扣费:账单ID 此参数不携带或携带值为空时,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 account_manager_id 否 String 最大长度:64 客户经理标识。 此参数不携带或携带值为空时,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 indirect_partner_id 否 String 最大长度:64 云经销商ID。获取方法请参见查询云经销商列表。 说明: 华为云总经销商可以查询名下所有子客户消费(包括云经销商子客户)。 如果是普通经销商,那么此处可以为空。 如果华为云总经销商需要查询客户在云经销商关联期间的消费,需要携带该字段;除此之外,此参数不做处理。否则只能查询该客户在与自己关联期间的消费。 association_type 否 String 最大长度:2 子客户的关联类型: 1:顾问销售 2:代售 此参数不携带或携带值为空时,不作为筛选条件;不支持携带为null和空串。 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。 bill_date_begin 否 String 最大长度:20 查询的资源消费记录的开始日期,格式为YYYY-MM-DD。 此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串。 说明: 必须和bill_cycle(即资源的消费账期)在同一个月。 bill_date_begin需小于等于bill_date_end。 bill_date_end 否 String 最大长度:20 查询的资源消费记录的结束日期,格式为YYYY-MM-DD。 此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串。 说明: 必须和bill_cycle(即资源的消费账期)在同一个月。 bill_date_begin和bill_date_end两个参数必须同时出现,否则仅按照bill_cycle(即资源的消费账期)进行查询。 bill_date_begin需小于等于bill_date_end。
  • 请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/bill/res-records?cycle=2019-06&payMethod=0&offset=1&limit=10 HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
  • URI GET /v1.0/{domain_id}/customer/account-mgr/bill/res-records URL参数说明请参见下表。 表1 路径参数 参数 是否必选 取值范围 描述 domain_id 是 最大长度:64 客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 cycle 是 String 最大长度:8 消费月份,格式为YYYY-MM。 例如2020-01。 cloudServiceTypeCode 否 String 最大长度:256 云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 resourceTypeCode 否 String 最大长度:256 资源类型编码,例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 此参数不携带或携带值为空,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 regionCode 否 String 最大长度:64 云服务区编码,例如:“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 resInstanceId 否 String 最大长度:256 资源实例ID。 此参数不携带或携带值为空,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 payMethod 是 String 最大长度:4 支付方式: 0:包年/包月 1:按需 10:预留实例 enterpriseProjectId 否 String 最大长度:64 企业项目标识(企业项目ID)。 default项目对应ID:0 未归集(表示该云服务不支持企业项目管理能力)项目对应ID:-1 其余项目对应ID获取方法请参见如何获取企业项目ID。 此参数不携带或携带值为空,不作为筛选条件;携带值为null时,作为筛选条件;不支持携带值为空串。 offset 是 Integer [1-最大整数] 页码。 limit 是 Integer [1-1000] 页面大小。
  • 核对资源用量是否与实际相符 如果您想要对比视频直播服务的使用量和费用账单中的用量是否一致,您首先需要登录视频直播控制台,在“概览”页面右侧查看当前账号的“计费方式”,不同的计费方式是否支持对齐用量及对齐用量方法不同,详情请参考下表: 计费方式 使用量类型 对齐用量的方式 流量计费 流量 如果想要用量,可以参考核对资源用量的方式对账-流量计费。 流量计费不支持按照企业项目、直播域名、标签来对齐用量,如果您想要按照企业项目、加速域名或标签来拆分成本,请参考共同成本分拆功能完成。 日峰值带宽计费 日峰值带宽 日峰值带宽计费不支持对齐总量。如果您有成本分摊的需求,可以借助成本单元功能进行成本分摊,将费用分摊到不同的部门或企业项目,请参考使用成本单元查看成本分配完成成本拆分。 日峰值带宽计费暂不支持共同成本拆分功能。 月结95峰值带宽计费 95峰值带宽 不支持按照企业项目、直播域名、标签来对齐用量,如果您想要按照企业项目、加速域名或标签来拆分成本,请参考共同成本分拆功能完成。 增值服务 直播转码费用:按转码使用的编码标准、输出分辨率及输出文件的时长进行计费。 用量核对方式相同,以直播截图费用为例,进行核对,详情请参考核对资源用量的方式对账-直播截图费用。 直播录制费用:统计每日录制并发路数并取当月峰值为计费点。 直播截图费用:根据截图张数进行计费。
  • 账单内容说明 表1 对账单参数说明-包年/包月 字段名称 类型 字段描述 取值示例 账期 String 与用户约定的一个时间范围,这样对账时才能确定对账范围。该时间范围可根据华为云的营销策略来决定,通常是一个自然月。当一个账期结束时,系统计算出用户在该账期内需要支付的全部费用,并生成账单。 2020-07 消费/退订时间 String 产品的消费或退订时间。包年/包月产品,消费时间为产品的支付时间;按需产品,消费时间为云服务生失效时间段。 2020/07/02 08:36 订单号 String 包年包月计费模式时的订单唯一标识号。 CS2007020834553YB 订单类型 String 包年/包月产品的订单类型: 新购 续费 退订 变更:升配或降配的订单。正常情况下,消费金额为正数,表示升配;消费金额为负数,表示降配。 新购 原订单号 String 包年包月计费模式时的退订订单所对应的原订单唯一标识号。 CS2007071751B1LFF 产品类型 String 主要指云服务的分类。 云硬盘 区域 String 指能独立提供公有云服务资源、并服务于一个较大地理范围的云服务区域。 华北-北京一 产品 String 云服务的名称。 HD3型线性云硬盘_包月 规格 String 用于描述云服务所需资源的特征信息,一组属性和属性值域的集合,同一个资源类型的资源规格所包含的属性相同,但属性取值不同。 高IO|10.000000GB 计费模式 String 计费模式。 包天 包月 包年 一次性 按需 预留实例-零预付 预留实例-全预付 预留实例-部分预付 节省计划 包月 购买数量 Integer 购买资源的数量。 1 时长 BigDecimal 包年/包月产品的购买数量。示例:计费模式为包月,购买数量取值为3,表示购买3个月。 1 官网价总金额 BigDecimal 选择购买的产品和周期后,华为云官网显示的价格。 3.5 应付金额 BigDecimal 用户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含:促销产品折扣、促销折扣券、商务折扣等各种折扣。 3.5 现金支付 BigDecimal 通过现金支付费用的金额。 3.5 代金券抵扣 BigDecimal 通过代金券抵扣费用。 0 欠费 BigDecimal 包含未结清金额和未结算金额,为待抵扣和待支付的费用金额。 0 备注 String 补充信息。 -- 组合交易单号 String 组合交易订单的单号。 多个订单一同交易生成组合交易订单。“一同交易”包括多个云服务资源组合开通、批量操作、组合购买等场景。组合交易订单下的各个订单必须一同支付或取消。支付完成后,各个云服务资源后续可单独进行交易。 CS24CSYZHD0050016 表2 对账单参数说明-按需 字段名称 类型 字段描述 取值示例 账期 String 与用户约定的一个时间范围,这样对账时才能确定对账范围。该时间范围可根据华为云的营销策略来决定,通常是一个自然月。当一个账期结束时,系统计算出用户在该账期内需要支付的全部费用,并生成账单。 2020-07 产品类型 String 主要指云服务的分类。 应用运维管理 区域 String 指能独立提供公有云服务资源、并服务于一个较大地理范围的云服务区域。 华北-北京一 产品 String 云服务的名称。 AOS堆栈 按需 规格 String 用于描述云服务所需资源的特征信息,一组属性和属性值域的集合,同一个资源类型的资源规格所包含的属性相同,但属性取值不同。 AOS堆栈|4.000000个 计费模式 String 计费模式。 包天 包月 包年 一次性 按需 预留实例 节省计划 按需 使用量类型 String 按需使用云服务时进行计费的方式,如:时长、容量、上行流量等。 时长 使用量 BigDecimal 一定时间范围内产品、资源的使用情况。如使用时长、使用容量、使用次数、使用流量等。 2678400 使用量单位 String 产品使用量的度量单位。 秒 官网价总金额 BigDecimal 选择购买的产品和周期后,华为云官网显示的价格。 0.93 应付金额 BigDecimal 用户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含:促销产品折扣、促销折扣券、商务折扣等各种折扣。 0.93 现金支付 BigDecimal 通过现金支付费用的金额。 0.93 代金券抵扣 BigDecimal 通过代金券抵扣费用。 0 欠费 BigDecimal 包含未结清金额和未结算金额,为待抵扣和待支付的费用金额。 0 备注 String 补充信息。 -- 表3 对账单参数说明-节省计划 字段名称 类型 字段描述 取值示例 账期 String 与用户约定的一个时间范围,这样对账时才能确定对账范围。该时间范围可根据华为云的营销策略来决定,通常是一个自然月。当一个账期结束时,系统计算出用户在该账期内需要支付的全部费用,并生成账单。 2020-07 消费/退订时间 String 产品的消费或退订时间。包年/包月产品,消费时间为产品的支付时间;按需产品,消费时间为云服务生失效时间段。 2020/07/02 08:36 订单号 String 订单唯一标识号。 CS2007020834553YB 订单类型 String 节省计划产品的订单类型: 新购 续费 退订 变更:升配或降配的订单。正常情况下,消费金额为正数,表示升配;消费金额为负数,表示降配。 新购 原订单号 String 退订订单所对应的原订单唯一标识号。 CS2007071751B1LFF 产品类型 String 主要指云服务的分类。 云硬盘 区域 String 指能独立提供公有云服务资源、并服务于一个较大地理范围的云服务区域。 华北-北京一 产品 String 云服务的名称。 HD3型线性云硬盘_包月 规格 String 用于描述云服务所需资源的特征信息,一组属性和属性值域的集合,同一个资源类型的资源规格所包含的属性相同,但属性取值不同。 高IO|10.000000GB 计费模式 String 计费模式。 包天 包月 包年 一次性 按需 预留实例 节省计划 包月 购买数量 Integer 购买资源的数量。 1 时长 BigDecimal 订单购买时长,单位为年。 1 使用量 BigDecimal 一定时间范围内产品、资源的使用情况。如使用时长、使用容量、使用次数、使用流量等。 24 使用量单位 String 产品使用量的度量单位。 小时 官网价总金额 BigDecimal 选择购买的产品和周期后,华为云官网显示的价格。 3.5 应付金额 BigDecimal 用户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含:促销产品折扣、促销折扣券、商务折扣等各种折扣。 3.5 现金支付 BigDecimal 通过现金支付费用的金额。 3.5 代金券抵扣 BigDecimal 通过代金券抵扣费用。 0 欠费 BigDecimal 包含未结清金额和未结算金额,为待抵扣和待支付的费用金额。 0 备注 String 补充信息。 -- 组合交易单号 String 组合交易订单的单号。 多个订单一同交易生成组合交易订单。“一同交易”包括多个云服务资源组合开通、批量操作、组合购买等场景。组合交易订单下的各个订单必须一同支付或取消。支付完成后,各个云服务资源后续可单独进行交易。 CS24CSYZHD0050016
  • 汇总表格(按产品/按产品规格) 使用API查询汇总账单请参见“查询汇总账单”。 官网价:华为云商品在官网上未叠加应用商务折扣、促销折扣等优惠的销售价格。官网价 = 优惠金额 + 抹零金额 + 应付金额。 应付金额:客户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含:商务折扣等各种折扣。应付金额 = 现金支付 + 信用额度支付 + 代金券抵扣 + 现金券抵扣 + 储值卡抵扣 + 欠费金额。 消费账单折扣率:仅当“账单类型”为“全部”和“消费”时展示。消费账单折扣率= (1-优惠金额/官网价)*100%。 支持用户按产品和产品规格查看账单汇总数据 按产品汇总:根据产品类型、产品、计费模式、账单类型展示费用的汇总数据。 按产品规格汇总:根据产品类型、产品、计费模式、订单号、账单类型、规格、区域、企业项目展示费用的汇总数据。 客户可以根据自己关心的内容,单击该卡片右上角,设置列表中需要展示或隐藏的字段。 支持汇总表格内容和表格视图的自定义设置 单击卡片右上角,可自定义设置表格内容、嵌套结构等。 选择按照“产品汇总”或“产品规格汇总”维度查看表格内容,以及按固定表或嵌套表来查看表格视图。 表格视图选择“嵌套表”时,可自定义分组显示账单。 1、单击“上移/下移”,调整嵌套层级的次序。 2、单击“删除”,删除对应层级。 3、单击“添加层级”,新增嵌套层级,最多支持4级嵌套。 设置完成后,单击“确定”,账单列表如下所示。单击或,可显示或隐藏嵌套数据。 表格视图选择“固定表”时,不支持分组和表格嵌套。设置成固定表后,账单列表如下所示。