客户运营能力-华为云

客户运营能力-查询云服务类型列表（旧）:状态码

状态码状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码错误码错误描述 400 CBC.0100 输入参数校验失败。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

客户运营能力

客户运营能力-查询省份信息:URI

URI GET /v2/systems/configs/provinces 表1 查询参数参数是否必选参数类型取值范围描述 offset 否 Integer [0-1000] 偏移量，从0开始。默认值为0。此参数不携带或携带值为空或携带值为null时，取值为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] 每次查询的数量，最大1000。该参数不携带时，取默认值10。该参数不支持携带值为空、不支持携带值为空串、不支持携带值为null。

客户运营能力

客户运营能力-查询云服务类型列表（旧）:请求消息

请求消息请求参数无请求示例 GET https://bss.myhuaweicloud.com/v2/bases/service-types?service_type_code=hws.service.type.workplace HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZX-Language: zh_CN

客户运营能力

客户运营能力-查询度量单位进制:URI

URI GET /v2/bases/conversions 表1 查询参数参数是否必选参数类型取值范围描述 measure_type 否 Integer [1-2147483647] 度量类型。 1：货币 2：时长 3：流量 4：数量 6：长度 7：容量 9：行数 10：周期 11：频率 12：个数 15：容量*时长 16：带宽速率 17：容量时长 18：查询速率 19：带宽速率（1000进制） 20：性能测试用量 21：面积 22：视频 23：吞吐量 24：分辨率 26：通用资源包抵扣单位 27：核数*时长 28：内存*时长 29：IOPS*时长 30：吞吐量*时长 31：个/时长 40：流量（1000进制） 41：1K Tokens 82：帧 98：缓存带宽x时长 103：港币 104：tokens 此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。

客户运营能力

客户运营能力-查询云服务类型列表（旧）:URI

URI GET /v2/bases/service-types 表1 Header参数参数是否必选取值范围描述 X-Language 否最大长度：8 语言。 zh_CN：中文 en_US：英文缺省为zh_CN。表2 查询参数参数是否必选参数类型取值范围描述 service_type_code 否 String 最大长度：64 云服务类型编码。例如OBS的云服务类型编码为“hws.service.type.obs”。该参数不携带或携带值为空时，不作为筛选条件；携带值为空串或携带值为null时，作为筛选条件。

客户运营能力

客户运营能力-客户运营能力API简介

客户运营能力API简介华为云面向客户开放运营能力，用于支撑客户平台管理产品、管理账户、管理交易、管理账单、管理企业、管理配置信息、管理工单等场景。表1 API列表和描述场景子场景 API名称 API说明管理产品查询产品信息查询云服务类型列表客户在自建平台查询云服务类型的列表。查询资源类型列表客户在自建平台查询资源类型的列表。根据云服务类型查询资源列表客户在自建平台根据云服务类型查询关联的资源类型编码和名称，用于查询按需产品的价格或包年/包月产品的价格。查询使用量类型列表客户在自建平台查询资源的使用量类型列表。查询度量单位列表客户在自建平台上查询资源使用量，包年包月资源的时长及金额的度量单位及名称，度量单位类型等。查询度量单位进制客户在自建平台上查询度量单位的进制转换信息，用于不同度量单位之间的转换。查询商品价格查询按需产品价格客户在自建平台按照条件查询按需产品的价格。查询包年/包月产品价格客户在自建平台按照条件查询包年/包月产品开通时候的价格。查询包年/包月资源的续订金额客户在自建平台按照条件查询包年/包月资源续订时候的续订金额。管理账户管理账户查询账户余额客户可以查询自身的账户余额。管理交易管理优惠券查询优惠券列表客户可以查询自身的优惠券信息。管理包年/包月订单查询订单列表客户购买包年/包月资源后，可以查看待审核、处理中、已取消、已完成和待支付等状态的订单。查询订单详情客户可以在客户自建平台查看订单详情。查询订单可用优惠券客户在自建平台查看订单可用的优惠券列表。查询订单可用折扣客户在自建平台支付待支付订单时，查询可使用的折扣信息。支付包年/包月产品订单客户可以对待支付状态的包年/包月产品订单进行支付。取消待支付订单客户可以对待支付的订单进行取消操作。查询退款订单的金额详情客户在伙伴销售平台查询某次退订订单或者降配订单的退款金额所属资源类型和对应订单。管理包年/包月资源查询客户包年/包月资源列表客户在自建平台查询某个或所有的包年/包月资源。续订包年/包月资源客户在自建平台完成包年/包月资源的续订。退订包年/包月资源客户购买包年/包月资源后，支持客户退订包年/包月实例。退订资源实例包括资源续费部分和当前正在使用的部分，退订后资源将无法使用。设置包年/包月资源自动续费为防止资源到期被删除，客户可为长期使用的包年/包月资源开通自动续费。取消包年/包月资源自动续费客户设置自动续费后，还可以执行取消自动续费的操作。关闭自动续费后，资源到期将不会被自动续费。设置或取消包年/包月资源到期转按需客户可以设置包年/包月资源到期后转为按需资源计费。包年/包月计费模式到期后，按需的计费模式即生效。管理资源包查询资源包列表客户在自建平台查询资源包列表。查询资源包使用量客户在自建平台根据资源项维度查询资源包使用量。查询资源包使用明细客户在自建平台查询资源包使用明细。管理账单管理账单查询汇总账单客户在自建平台查询自身的消费汇总账单，此账单按月汇总消费数据。查询资源详单客户在自建平台查询自己的资源详单，用于反映各类资源的消耗情况。查询资源消费记录客户在自建平台查询每个资源的消费明细数据。查询流水账单客户在自建平台查询自己的消费流水账单。查询95计费资源用量查询95计费资源用量汇总客户在自建平台查询自己的资源使用量汇总。查询95计费资源用量明细客户在自建平台查询自己的资源使用量明细。管理成本管理成本查询月度成本客户在自建平台查询指定月份的月度摊销成本。查询成本数据客户在自建平台查询成本分析数据。管理企业管理企业项目开通客户企业项目权限客户在自建平台开通客户企业项目权限。管理企业多账号查询企业组织结构企业主账号在自建平台查询企业组织结构。查询企业子账号列表企业主账号在自建平台查询企业子账号信息列表。查询企业主账号可拨款余额企业主账号在自建平台查询自己的可拨款余额。查询企业子账号可回收余额企业主账号在自建平台查询企业子账号的可回收余额。创建企业子账号企业主账号在自建平台创建企业子账号。发送短信验证码企业主账号在自建平台发送短信验证码。企业主账号向企业子账号拨款企业主账号在自建平台向企业子账号拨款。企业主账号从企业子账号回收拨款企业主账号在自建平台回收给企业子账号的拨款。查询企业主账号可拨款优惠券列表企业主账号在自建平台查询自己的可拨款优惠券列表。查询企业子账号可回收优惠券列表企业主账号在自建平台查询企业子账号的可回收优惠券。企业主账号向企业子账号拨款优惠券企业主账号在自建平台向企业子账号拨款优惠券。企业主账号从企业子账号回收优惠券企业主账号在自建平台回收给企业子账号的拨款优惠券。管理配置信息查询国家省市信息查询省份信息客户在自建平台上查询省份信息。查询城市信息客户在自建平台上查询城市信息。查询区县信息客户在自建平台上查询区县信息。管理工单管理工单工单管理API参考客户可以在客户自建平台上提交华为云工单，华为云售后服务团队收到工单后会协助客户处理使用华为云过程中遇到的问题。

客户运营能力

客户运营能力-查询客户包年/包月资源列表（旧）:状态码

状态码状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码错误码描述 200 CBC.0000 成功。 400 CBC.0100 参数错误。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

客户运营能力

客户运营能力-查询客户包年/包月资源列表（旧）:功能介绍

功能介绍客户在自建平台查询某个或所有的包年/包月资源。注意事项：该接口允许客户的AK/SK或者Token调用。该接口只能查询开通成功的资源。成功调用本接口后，如果您需要对已生效状态的资源进行续订，您可以调用“查询包年/包月产品价格”接口对查询到的包年/包月资源进行续订询价，然后再调用“续订包年/包月资源（旧）”接口进行续订。该接口即将下线，“查询客户包年/包月资源列表”新接口请参考查询客户包年/包月资源列表。

客户运营能力

客户运营能力-查询客户包年/包月资源列表（旧）:URI

URI GET /v1.0/{domain_id}/common/order-mgr/resources/detail 参数说明请参见下表。表1 路径参数参数是否必选取值范围描述 domain_id 是最大长度：64 客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。表2 查询参数参数是否必选参数类型取值范围描述 resource_ids 否 String 最大长度： 4096 资源ID列表。查询指定资源ID的资源（当only_main_resource=0时，查询指定资源及其附属资源）。最大支持50个ID同时作为条件查询，多个ID以英文逗号分隔。此参数不携带、携带空时不参与过滤；携带值为空串、null参与过滤。说明：资源ID是指开通资源以后，云服务针对该资源分配的标志，譬如云主机E CS 的server_id。 order_id 否 String 最大长度：64 订单号。查询指定订单下的资源。此参数不携带、携带为空时不参与过滤；携带值为空串、携带为null参与过滤。 only_main_resource 否 Integer [0|1] 是否只查询主资源，该参数对于请求参数是子资源ID的时候无效，如果resource_ids是子资源ID，只能查询自己。 0：查询主资源及附属资源。 1：只查询主资源。默认值为0。此参数不携带、携带值为空、携带为null取默认值0；不支持携带为空串。说明：主资源是指有关联的几个资源中，处于主导位置的资源。对于ECS而言，虚拟机VM是主资源，磁盘EVS是辅资源。对于VPC而言，共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP）；独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽。 status_list 否 String - 资源状态。查询指定状态的资源。多个状态以英文逗号分隔。 2：使用中 4：已冻结 5：已过期此参数不携带、携带为空时返回所有状态的资源数据；不支持携带值为空串、携带为null。 page_no 否 Integer 大于等于1的整数页码。默认值是1。此参数不携带、携带值为空、携带为null时取默认值1；不支持携带值为空串。 page_size 否 Integer [1-500] 每页条数。默认值是10。最大值是500。此参数不携带、携带值为空、携带为null时取默认值10；不支持携带值为空串。

客户运营能力

客户运营能力-查询客户包年/包月资源列表（旧）:请求消息

请求消息请求参数无。请求示例 GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/resources/detail?resource_ids=b38*****62e,249*****c07&only_main_resource=1&page_no=1&page_size=100 HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

客户运营能力

客户运营能力-查询优惠券列表:URI

URI GET /v2/promotions/benefits/coupons 参数说明请参见下表。表1 查询参数参数是否必选参数类型取值范围描述 coupon_id 否 String 最大长度：64 优惠券ID。此参数不携带或携带值为空时，不作为筛选条件。 order_id 否 String 最大长度：64 订单ID。此参数不携带或携带值为空时，不作为筛选条件。 promotion_plan_id 否 String 最大长度：64 促销计划ID。此参数不携带或携带值为空时，不作为筛选条件。 coupon_type 否 Integer [1-4] 优惠券类型： 1：代金券 2：折扣券 4：现金券此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。 status 否 Integer [1-5] 客户优惠券实例状态： 2：待使用 3：已使用 4：已过期 5：已回收此参数不携带或携带值为空时，不作为筛选条件。 active_start_time 否 String 最大长度：64 激活开始时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 active_end_time 否 String 最大长度：64 激活结束时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为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-100] 查询的优惠券数量，默认值为10。 source_id 否 String 最大长度：255 发券来源，如果是合作伙伴发送的券，此处为伙伴ID。如果需要查询某个伙伴发放的券，可以在此处输入该伙伴ID。此参数不携带或携带值为空或携带值为null时，不作为筛选条件；携带值为空串时，作为筛选条件。

客户运营能力管理优惠券

客户运营能力-查询汇总账单（旧）:REST API

REST API 客户可以查询自身的消费汇总账单的功能，消费按月汇总。用于客户自身BSS系统的按需扣费或者客户消费记录的查看。该接口只允许使用客户AK/SK或者Token调用。当请求参数不传递“cloud_service_type_code”时，查询的账单是以云服务类型为维度的月度消费账单，即总条数“total_count”是以云服务类型进行统计，每条账单记录一种云服务类型的月度消费汇总。此时响应参数中返回的资源类型“resource_type_code”为“null”。当请求参数传递“cloud_service_type_code”时，查询的账单是以资源类型为维度的月度消费账单，即总条数“total_count”是具体云服务类型下以资源类型进行统计，每条账单记录该云服务类型下的一种资源类型的月度消费汇总。此时响应参数中返回的资源类型“resource_type_code”返回具体的资源类型。

客户运营能力

客户运营能力-查询订单详情（旧）:Web UI

Web UI 客户可以在费用中心“我的订单”页面查看订单详情。进入“我的订单”页面。查看云服务订单，选中“云服务”页签；查看硬件订单，选中“硬件商城”页签；查看按需订单，选中“按需”页签。可根据创建时间或输入订单号、商品名称筛选订单；硬件订单也可通过订单类型、订单状态进行过滤。在订单页面找到待查看的订单，单击“详情”。订单状态为“处理中”时，表示资源创建中；表示该订单下有资源开通失败。当云服务订单状态为“待支付”时，订单详情页面客户可支付订单或取消订单。当云服务订单中有资源开通失败时，系统会自动退订开通失败的资源。若订单是客户经理在合同内进行代客下单的，客户可在订单详情页面查看合同信息，点击合同名称进入合同详情页面。当新购硬件订单为“待支付”时，订单详情页面用户可以支付订单、申请修改地址或取消订单。当新购硬件订单为“待发货”时，订单详情页面用户可以申请取消发货，申请修改地址。当新购硬件订单为“已完成”时，订单详情页面用户可以退货、换货或查看售后记录。当硬件退货/换货订单处于待审核状态或待快递上门取货状态时，在订单详情页面用户可以取消订单。

客户运营能力

客户运营能力-根据产品规格查询价格（旧）:状态码

状态码状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码错误码描述 200 CBC.0000 成功。 400 CBC.0100 参数错误。 403 CBC.0151 拒绝访问。 200 CBC.6006 找不到您询价的产品。如果报此错误，请检查请求参数中的“productInfos”中 “cloudServiceType”、“resourceType”、“resourceSpecCode”及其他参数是否填写正确。 200 CBC.6055 询价结果超过金额最大限制。 500 CBC.0999 其他错误。

客户运营能力

客户运营能力-退订包年/包月资源（旧）:REST API

REST API 客户在自建平台完成包年/包月资源的退订。首先要成功支付包年/包月产品，产生一条开通成功的包年/包月资源，才能进行退订。该接口只允许使用客户AK/SK或者Token调用。调用接口后，如果某个主资源ID有对应的从资源ID，系统会将主资源ID和从资源ID一起退订，存在主从资源关系的资源为：云主机为主资源，对应的从资源为云硬盘共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP）独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽该接口支持5天无理由全额退订，具体规则请参见“退订规则说明”。

客户运营能力

云服务器内容精选

客户运营能力

7*24

备案

专业服务

退订

建议反馈

售前咨询热线