云服务器内容精选

  • 请求消息 请求参数 无。 请求示例 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
  • 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。
  • 功能介绍 伙伴在伙伴销售平台可实时查询子客户的消费记录,了解客户的资源消耗情况。 伙伴在伙伴中心查询客户消费明细请参见这里。 消费记录支持查询18个月内的记录。 如果是客户经理主管来查询,只支持按照单个客户经理查询,必须输入客户经理ID。 目前支持伙伴查询所有子客户(包含代售类和顾问销售类)的消费记录。 如您的顾问销售子客户同时是财务托管模式企业子账号,解绑前当月账期消费数据体现在企业子账号,解绑后当月消费数据体现在企业主账号。详情请见“如何查询财务托管模式企业子账号解绑当月账期的消费数据”。
  • 请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 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 { "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年的数据。
  • 请求消息 请求参数 无。 请求示例 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] 页面大小。
  • URI GET /v2/bills/partner-bills/subcustomer-bills/monthly-sum 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 cycle 是 String 最大长度:10 消费时间。 格式固定为YYYY-MM。 示例:2018-08 charge_mode 是 String 最大长度:4 计费模式。 1:包年/包月 3:按需 11:节省计划 bill_type 否 String 最大长度:4 账单类型。 0:消费 1:退订 2:华为核销 此参数不携带或携带值为空时,不作为筛选条件。 indirect_partner_id 否 String 最大长度:64 云经销商ID。获取方法请参见查询云经销商列表。 如果需要查询云经销商伙伴的子客户的消费汇总账单,必须携带该字段。除此之外,此参数不做处理。 customer_id 否 String 最大长度:64 客户账号ID。您可以调用查询客户列表接口获取customer_id。 此参数不携带或携带值为空时,不作为筛选条件。 cloud_service_type 否 String 最大长度:256 云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空时,不作为筛选条件。 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-100] 每页个数。默认值为10。
  • REST API 合作伙伴可查询所有代售类客户或者某个代售类客户的消费汇总账单,消费按月汇总。每天刷新一次,更新前一天的数据。 用于合作伙伴查询其代售类客户在华为的消费情况,用于合作伙伴和其代售类客户消费记录的查看。 该接口只允许使用合作伙伴AK/SK或者Token调用。 此接口只能查询伙伴子自己的月度消费账单,无法查询其名下财务托管子账号(包含资源账号或云账号)的月度消费账单。如果需要查询,请切换到相应接口查询客户月度消费账单。