华为云用户手册

Token认证 Token的有效期一般为24小时（例外场景除外），需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。具体Token有效期说明请参见获取用户Token。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 在构造请求中以调用获取用户Token接口为例说明了如何调用API。获取客户Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可,如下所示。 Content-Type: application/json X-Auth-Token: ABCDEFJ.... 获取客户Token请参见获取用户Token。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

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

请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/products/service-types?offset=0&limit=10 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ X-Language: zh_CN

URI GET /v2/products/service-types 表1 Header参数 参数 是否必选 取值范围 描述 X-Language 否 最大长度：8 语言。 zh_CN：中文 en_US：英文 缺省为zh_CN。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 offset 否 Integer [0-1000000000] 偏移量，从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] 每次查询的数量，默认值为10。 此参数不携带或携带值为空或携带值为null时，取默认值10；不支持携带值为空串。

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

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

URI GET /v2/products/resource-types 表1 Header参数 参数 是否必选 取值范围 描述 X-Language 否 最大长度：8 语言。 zh_CN：中文 en_US：英文 缺省为zh_CN。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 offset 否 Integer [0-1000000000] 偏移量，从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] 每次查询的数量，默认值为10。 此参数不携带或携带值为空或携带值为null时，取默认值10；不支持携带值为空串。

请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/products/resource-types?offset=0&limit=10 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ X-Language: zh_CN

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 region_code 否 String 最大长度：64 云服务区编码，例如：“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 order_id 否 String 最大长度：64 订单ID。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 product_id 否 String 最大长度：64 产品ID，即资源包ID。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 product_name 否 String 最大长度：256 产品名称，即资源包名称。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 enterprise_project_id 否 String 最大长度：64 企业项目ID。 如需查询企业项目下的资源列表，必须携带该参数； 若参数不携带或携带值为空串或携带值为null时，查询除企业项目外的其他所有资源列表。 status 否 Integer [0-4] 状态： 0：未生效 1：生效中 2：已用完 3：已失效 4：已退订 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 offset 否 Integer [0-9999] 页码，如果要查询第一页，请输入1，后面依次类推。 若此参数输入0，默认查询第一页。 此参数不携带或携带值为空串或携带值为null时，默认查询第一页；不支持携带值为空。 limit 否 Integer [1-1000] 每次查询的记录数，默认为10。 此参数不携带或携带值为空串或携带值为null时，取值为10；不支持携带值为空。 请求示例 POST https://bss.myhuaweicloud.com/v2/payments/free-resources/query HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "region_code": "cn-north-7", "order_id": " CS 21043011259RWXXTA", "product_id": "90301-296014-0--0", "product_name": "华为云 WeLink ", "enterprise_project_id": null, "status": 1, "offset": 0, "limit": 10 }

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/bills/customer-bills/resources/usage/details?bill_cycle=2021-07&service_type_code=hws.service.type.cdn&resource_type_code=hws.resource.type.cdn&usage_type=95Peak&offset=0&limit=10&resource_id=resourceinstanceid-00-000-0001 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v2/bills/customer-bills/resources/usage/details URL参数说明请参见下表。 表1 消息头参数 参数 是否必选 参数类型 取值范围 描述 X-Language 否 String 最大长度：10 语言。 en_US：英文 zh_CN：中文 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 bill_cycle 是 String 最大长度：7 账期，东八区时间，格式为yyyy-MM。 service_type_code 是 String 最大长度：64 云服务类型，当前仅支持： hws.service.type.cdn：内容分发网络 hws.service.type.obs： 对象存储服务 hws.service.type.vpc：虚拟私有云 hws.service.type.iec：智能边缘云 resource_type_code 是 String 最大长度：64 资源类型编码，当前仅支持： hws.resource.type.cdn：CDN hws.resource.type.obs： 云存储 hws.resource.type.bandwidth：固定带宽 hws.resource.type.edgebandwidth：边缘固定带宽 资源类型和云服务类型的对应关系可调用根据云服务类型查询资源列表接口获取。 usage_type 是 String 最大长度：64 使用量类型编码，当前仅支持： 95Peak：中国大陆月95峰值带宽_1024进制 95peak_1000：中国大陆月95峰值带宽_1000进制 95Peak_1000：中国大陆月95峰值带宽_1000进制（若查询1000进制的数据，需查询95peak_1000和95Peak_1000的数据，将响应值做聚合才是完整的数据） bandwidth95peak：95峰值带宽 95peak_plus：增强型95峰值 资源类型和使用量类型的对应关系可调用查询使用量类型列表接口获取。 resource_id 是 String 最大长度：64 资源ID，您可以调用查询资源用量汇总接口获取。 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。

URI GET /v2/bills/customer-bills/resources/usage/summary URL参数说明请参见下表。 表1 消息头参数 参数 是否必选 参数类型 取值范围 描述 X-Language 否 String 最大长度：10 语言。 en_US：英文 zh_CN：中文 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 bill_cycle 是 String 最大长度：7 账期，东八区时间，格式为yyyy-MM。 service_type_code 是 String 最大长度：64 云服务类型，当前仅支持： hws.service.type.cdn：内容分发网络 hws.service.type.obs：对象存储服务 hws.service.type.vpc：虚拟私有云 hws.service.type.iec：智能边缘云 resource_type_code 是 String 最大长度：64 资源类型编码，当前仅支持： hws.resource.type.cdn：CDN hws.resource.type.obs：云存储 hws.resource.type.bandwidth：固定带宽 hws.resource.type.edgebandwidth：边缘固定带宽 资源类型和云服务类型的对应关系可调用根据云服务类型查询资源列表接口获取。 usage_type 是 String 最大长度：64 使用量类型编码，目前仅支持： 95Peak：中国大陆月95峰值带宽_1024进制 95peak_1000：中国大陆月95峰值带宽_1000进制 95Peak_1000：中国大陆月95峰值带宽_1000进制（若查询1000进制的数据，需查询95peak_1000和95Peak_1000的数据，将响应值做聚合才是完整的数据） bandwidth95peak：95峰值带宽 95peak_plus：增强型95峰值 资源类型和使用量类型的对应关系可调用查询使用量类型列表接口获取。 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。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/bills/customer-bills/resources/usage/summary?bill_cycle=2021-07&service_type_code=hws.service.type.cdn&resource_type_code=hws.resource.type.cdn&usage_type=95Peak&offset=0&limit=10 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

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 GET /v2/products/usage-types 表1 Header参数 参数 是否必选 取值范围 描述 X-Language 否 最大长度：8 语言。 中文：zh_CN 英文：en_US 缺省为zh_CN。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 resource_type_code 否 String 最大长度：64 资源类型编码，例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 此参数不携带或携带值为空时，不作为筛选条件；携带值为空串或携带值为null时，作为筛选条件。 offset 否 Integer [0-100000000] 偏移量，从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-100] 每次查询的数量，默认值为10。 此参数不携带或携带值为空或携带值为null时，取默认值10；不支持携带值为空串。

请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/products/usage-types?offset=0&limit=3 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ X-Language: zh_CN

URI GET /v2/products/service-resources 表1 Header参数 参数 是否必选 取值范围 描述 X-Language 否 最大长度：8 语言。 中文：zh_CN 英文：en_US 缺省为zh_CN。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 service_type_code 是 String 最大长度：64 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 offset 否 Integer [0-10000000] 偏移量，从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-100] 每次查询的数量，默认值为10。 此参数不携带时，取默认值10；不支持携带值为空或携带值为空串或携带值为null。

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

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/products/service-resources?service_type_code=hws.service.type.obs&limit=5&offset=0 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ X-Language: zh_CN

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

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

请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/bases/resource-types?resource_type_code=hws.resource.type.workplace.basic HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ X-Language: zh_CN

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

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时，作为筛选条件。

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

resource_size、size_measure_id如何填写 询价线性产品时，resource_size、size_measure_id两个参数为必填。线性产品为包括硬盘，带宽等在订购时需要指定大小的产品。如您分辨不出产品是否线性，可咨询对应的云服务产品部。 两者需搭配使用，resource_size代表资源容量大小，例如云硬盘有10G、20G区分等等；size_measure_id代表资源容量度量标识，例如云硬盘度量标识为GB，此参数需填写17。

SDK列表 表1提供了客户运营支持的SDK列表，您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 表1 SDK列表 编程语言 Github地址 参考文档 Java huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导 NodeJs huaweicloud-sdk-nodejs-v3 NodeJs SDK使用指导 .NET huaweicloud-sdk-net-v3 .Net SDK使用指导 PHP huaweicloud-sdk-php-v3 PHP SDK使用指导 C++ huaweicloud-sdk-cpp-v3 C++ SDK使用指导

URI GET /v2/systems/configs/counties 查询参数 参数 是否必选 参数类型 取值范围 描述 city_code 是 String 最大长度：20 城市的编码。 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。

URI GET /v2/systems/configs/cities 查询参数 参数 是否必选 参数类型 取值范围 描述 province_code 是 String 最大长度：40 省份编码。 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。