华为云用户手册

功能介绍 为防止资源到期被删除，客户可为长期使用的包年/包月资源开通自动续费。 客户在费用中心开通自动续费请参见这里。 首先要客户成功支付包年/包月资源订单，才能进行自动续费的开通。 目前支持设置自动续费的包年/包月产品请参见自动续费规则说明。 在调用本接口前，您可以调用“查询客户包年/包月资源列表”接口获取资源ID、资源过期时间以及资源过期后扣费策略等信息。 自动续费将于产品到期前7天的凌晨3:00开始扣款，请保持账户余额充足。若由于账户中余额不足等原因导致第一次未扣费成功，系统将每天凌晨3:00尝试进行一次扣款，直到扣款成功或保留产品资源的最后一天。 续费周期与原资源的购买周期一致。

请求消息 请求参数 无。 请求示例： DELETE https://bss.myhuaweicloud.com/v2/orders/subscriptions/resources/autorenew/eb1cac79-773b-414b-8915-6c3eed8ddf24 HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

支付使用折扣或优惠券说明 客户在调用“续订包年/包月资源”接口进行续订时，可以设置自动支付。 请求参数“isAutoPay”字段取值为“1”时表示自动支付，自动支付时支持使用折扣和券。 支付规则请参见自动续费规则说明中的相关规则说明。 请求参数未传“isAutoPay”字段，或者将该字段设置为“0”（以具体接口参数描述为准）时需要再调用“支付包年/包月产品订单”接口进行支付。 这种方法支付时可以在调用支付接口前，先调用“查询订单可用优惠券”接口查询可用的优惠券，再进行支付。使用优惠券支付将不能再享受折扣优惠。 父主题： 附录

功能介绍 客户设置自动续费后，还可以执行取消自动续费的操作。关闭自动续费后，资源到期将不会被自动续费。 客户在费用中心取消包年/包月资源自动续费请参见这里。 前提是已经调用“设置包年/包月资源自动续费”接口设置自动续费或在调用“续订包年/包月资源”接口时设置到期策略为自动续订。 目前支持取消自动续费的包年/包月产品同支持自动续费的包年/包月产品。 在调用本接口前，您可以调用“查询客户包年/包月资源列表”接口获取资源ID、资源过期时间以及资源过期后扣费策略等信息。

URI DELETE /v2/orders/subscriptions/resources/autorenew/{resource_id} 参数说明请参见下表。 表1 路径参数 参数 是否必选 取值范围 描述 resource_id 是 最大长度：64 资源ID。 您可以调用“查询客户包年/包月资源列表”接口获取资源ID。 设置主资源时会将从资源一起设置，主从关系为： 云主机为主资源，对应的从资源为云硬盘 共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP） 独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 400 CBC.99003012 资源ID不存在。 400 CBC.99003605 自动续费已取消，不可进行当前操作。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 200 CBC.30050007 资源非主资源，不允许续费询价。 200 CBC.30050008 资源不存在对应的的周期类型或周期数。 200 CBC.30050009 资源已过期删除或不存在。 200 CBC.30050010 当前操作的资源中，有资源包含在您的待支付的订单，不能进行当前操作。 200 CBC.30050011 资源正在退订或者变更。 200 CBC.30050013 该产品不支持续费。 400 CBC.0100 参数错误。 400 CBC.99006006 找不到您询价的产品。 400 CBC.99006024 查询产品信息失败。 400 CBC.99006016 查询优惠券信息失败。 400 CBC.99006017 查询客户信息失败。 400 CBC.99006050 使用量单位错误。 400 CBC.99006055 询价结果超过金额最大限制。 400 CBC.99006066 查询计费信息失败。 400 CBC.99006073 项目不存在。 400 CBC.30050012 存在重复的资源ID。 403 CBC.0151 访问拒绝。 403 CBC.0154 token非法/过期。 500 CBC.0999 其他错误。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.99000037 您没有操作该云经销商的权限。 400 CBC.99005003 余额不足。 401 CBC.0154 token非法/过期。 403 CBC.0150 非法操作。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 indirect_partner_id 是 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 amount 是 BigDecimal - 回收金额。 华为云总经销商回收的云经销商的账户金额。 说明： 回收金额不能大于云经销商的账户余额。 单位：元。取值大于0且精确到小数点后2位。 请求示例 POST https://bss.myhuaweicloud.com/v2/accounts/partner-accounts/indirect-partner-reclaim HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ{ "indirect_partner_id": "05bad7a90700d5bf0ff6c00ae40d0ca0", "amount": 0.01}

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

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

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/accounts/partner-accounts/balances?indirect_partner_id=0977ffa9f20010790f0fc003f6900520 HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

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

URI GET /v2/accounts/partner-accounts/balances 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 indirect_partner_id 否 String 最大长度：64 云经销商ID。 获取方法请参见查询云经销商列表。 华为云总经销商（一级经销商）查询云经销商（二级经销商）余额时，需要携带该参数；除此之外，此参数不做处理。否则只能查询自己的账户余额。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 account_name 否 String 最大长度：64 云经销商伙伴的账号名。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 associated_on_begin 否 String 最大长度：20 云经销商关联华为云总经销商的开始时间。 UTC时间（包括时区），比如2016-03-28T00:00:00Z。 此参数不携带或携带值为null时，不作为筛选条件。 associated_on_end 否 String 最大长度：20 云经销商关联华为云总经销商的结束时间。 UTC时间（包括时区），比如2016-03-28T00:00:00Z。 此参数不携带或携带值为null时，不作为筛选条件。 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 如果需要查询具体某个云经销商伙伴，必须携带该字段。除此之外，此参数不做处理。 offset 否 Integer [0-40000000] 偏移量，从0开始。默认值为0。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 例如，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。 limit 否 Integer [1-100] 每次查询的数量限制。默认值为10。

URI GET /v2/partners/coupon-quotas/records 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 为空表示查询所有的代金券额度发放回收记录。 不为空表示仅查询与该云经销商相关的代金券额度发放回收记录。 默认查询所有云经销商的代金券额度发放回收记录。 quota_id 否 String 最大长度：64 云经销商的代金券额度ID。获取方法请参见查询优惠券额度。 即华为云总经销商给云经销商发放代金券额度时，产生的云经销商的代金券额度ID，或者从云经销商回收代金券额度时，云经销商的代金券额度ID。 此参数不携带或携带值为空时，不作为筛选条件。 operation_time_begin 否 String 最大长度：20 查询条件：操作起始时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。 此参数不携带或携带值为空时，不作为筛选条件。不支持携带值为空串。 operation_time_end 否 String 最大长度：20 查询条件：操作截止时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。 此参数不携带或携带值为空时，不作为筛选条件。不支持携带值为空串。 parent_quota_id 否 String 最大长度：64 父额度ID。 这即华为云总经销商给云经销商发放代金券额度时，华为云总经销商的额度ID，或者从云经销商回收代金券额度时，回收的华为云总经销商的额度ID。 此参数不携带或携带值为空时，不作为筛选条件。携带值为空串或携带值为null时，作为筛选条件。 operation_type 否 String 最大长度：8 操作类型。 10：发放额度 11：回收额度 此参数不携带或携带值为空或携带值为空串时，不作为筛选条件。 limit 否 Integer [1-100] 每次查询的数目。默认值为10。 offset 否 Integer [0-最大整数] 偏移量，从0开始，默认值为0。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 例如，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。

URI GET /v2/partners/issued-coupon-quotas 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 quota_id 否 String 最大长度：64 云经销商的代金券额度ID。获取方法请参见查询优惠券额度。 此参数不携带或携带值为空时，不作为筛选条件。 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 如果需要查询云经销商伙伴的代金券额度，必须携带该字段。除此之外，此参数不做处理。 parent_quota_id 否 String 最大长度：64 父额度ID，即华为云总经销商用于发放给云经销商代金券额度的额度ID。 此参数不携带时，不作为筛选条件；携带值为空或携带值为空串时，作为筛选条件。 offset 否 Integer [0-最大整数] 偏移量，从0开始。默认值为0。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 例如，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。 limit 否 Integer [1-100] 每次查询记录数。默认值为10。

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

响应消息 响应参数 参数 参数类型 取值范围 描述 error_code String 最大长度：16 状态码。具体请参考状态码。只有失败才会返回这个参数。 error_msg String 最大长度：1024 错误描述信息。只有失败才会返回这个参数。 review_result Integer - 实名认证审核结果，只有状态码为200并且已经提交过实名认证请求才返回： 0：审核中 1：不通过 2：通过 opinion String 最大长度：256 审批意见，只有状态码为200并且审核不通过才返回。 响应示例 HTTP/1.1 200 OKContent-Type: application/json;charset=UTF-8Content-Length: lengthDate: response time {"review_result": 2,"opinion": null}

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/customers/realname-auths/result?customer_id=06a7969058802f0c0f01c00b91846780 HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.99000027 验证码过期。 400 CBC.99000035 非合作伙伴子客户。 400 CBC.99005030 伙伴未开通实名认证功能或者桶鉴权失败。 400 CBC.99007188 该客户已经实名认证或者实名认证在审核中。 400 CBC.99007189 使用该证件号进行实名认证的客户数已经超过系统规定。 400 CBC.99007191 客户实名认证次数超过最大配置值。 400 CBC.99007193 该证件号属于违规证件号，不允许进行实名认证。 400 CBC.99007202 实名认证校验失败。 400 CBC.99007219 实名认证信息与人脸不匹配。 400 CBC.99007255 持卡人身份信息或手机号输入不正确。 400 CBC.99007258 银行卡状态不正确（可能是冻结或过期的银行卡）。 400 CBC.99007261 不支持该银行卡，请尝试其他银行卡。 400 CBC.99007260 银联与发卡行之间调用失败，请稍后重试或使用其它银行卡。 400 CBC.99007262 银行系统异常，网络异常。 400 CBC.0100 参数错误。 400 CBC.70600026 抱歉，华为云暂无法审核您提交的实名认证信息，请联系您的客户经理协助。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 receiver_type 是 Integer [1] 发送验证码的类型： 1：发送短信验证码 timeout 否 Integer [1-3000] 发送验证码的超时时间。 此参数不携带或携带值为null时，采用系统默认超时时间10分钟。 此参数值超过60时，取值固定为5分钟。 单位：分钟。 mobile_phone 是 String 最大长度：32 指定发送验证码的手机号。 目前系统只支持中国手机号。 示例：13XXXXXXXXX lang 否 String 最大长度：16 根据该参数的取值选择发送短信验证码的语言。此参数默认值为“zh-cn”。 zh-cn：中文 en-us：英文 此参数不携带或携带值为空串或携带值为null时，取默认值zh-cn。 scene 否 Integer - 验证码使用的场景，目前支持如下场景： 29：注册场景 18：个人银行卡实名认证场景 此参数不携带或携带值为null时，默认值为“29”；不支持携带值为空串。 customer_id 否 String 最大长度：64 客户账号ID。您可以调用查询客户列表接口获取customer_id。 当scene=18时此参数必填；除此之外此参数非必填，不携带或携带值为空串或携带值为null时均不做处理。 请求示例 POST https://bss.myhuaweicloud.com/v2/bases/verificationcode/send HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ{ "receiver_type":1, "timeout": 5, "mobile_phone":"188****8888", "lang":"en-us", "scene": 18, "customer_id": "a0d736359ada40aab6502d1a828c1809"}

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 400 CBC.99000035 非合作伙伴子客户。 400 CBC.99004002 生成验证码失败。 400 CBC.99004003 验证码生成成功但发送失败。 400 CBC.99004005 手机号为空/格式不合法。 400 CBC.99004015 发送验证码次数已达到上限（15次/小时，60次/天）。 401 CBC.0154 token非法/过期。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

响应消息 响应参数 参数 参数类型 取值范围 描述 error_code String 最大长度：16 状态码。具体请参考状态码。只有失败才会返回这个参数。 error_msg String 最大长度：1024 错误描述信息。只有失败才会返回这个参数。 响应示例 HTTP/1.1 204 No ContentContent-Type: application/json;charset=UTF-8Content-Length: lengthDate: response time

请求消息 表1 Header参数 参数 是否必选 取值范围 描述 X-Language 否 最大长度：8 语言。 中文：zh_CN 缺省为zh_CN。 请求参数 参数 是否必选 参数类型 取值范围 描述 recipient 是 String 最大长度：256 收件人姓名。 province 是 String 最大长度：64 省、自治区或直辖市。例如：江苏省。 city 是 String 最大长度：64 市/区。例如：南京市。 district 是 String 最大长度：64 区。例如：雨花台区。 address 是 String 最大长度：200 邮寄详细地址。 zipcode 否 String 最大长度：32 邮寄地址所在邮编。 此参数不携带或携带值为null时，不赋值；不支持携带值为空串。 mobile_phone 是 String 最大长度：32 手机号码，不带国家码。 is_default 否 Integer - 是否默认地址，默认值为“0：非默认地址”。 1：默认地址 0：非默认地址 此参数不携带或携带值为空串或携带值为null时，赋值为0。

Web应用防火墙 可以拦截multipart/form-data格式的数据包吗？ WAF支持拦截multipart/form-data格式的数据包。您可以提交工单申请配置拦截multipart/form-data格式的数据包。 Multipart/form-data是浏览器使用表单上传文件的方式。例如，在写邮件时，如果邮件添加了附件，附件通常使用multipart/form-data格式上传到服务器。 父主题： 功能说明类

如何将非PEM格式的证书转换为PEM格式？ WAF当前仅支持PEM格式证书。如果证书为非PEM格式，请参考表1在本地将证书转换为PEM格式，再上传。 表1 证书转换命令 格式类型 转换方式 CER/CRT 将“cert.crt”证书文件直接重命名为“cert.pem”。 PFX 提取私钥命令，以“cert.pfx”转换为“key.pem”为例。 openssl pkcs12 -in cert.pfx -nocerts -out key.pem -nodes 提取证书命令，以“cert.pfx”转换为“cert.pem”为例。 openssl pkcs12 -in cert.pfx -nokeys -out cert.pem P7B 证书转换，以“cert.p7b”转换为“cert.cer”为例。 openssl pkcs7 -print_certs -in cert.p7b -out cert.cer 将“cert.cer”证书文件直接重命名为“cert.pem”。 DER 提取私钥命令，以“privatekey.der”转换为“privatekey.pem”为例。 openssl rsa -inform DER -outform PEM -in privatekey.der -out privatekey.pem 提取证书命令，以“cert.cer”转换为“cert.pem”为例。 openssl x509 -inform der -in cert.cer -out cert.pem 执行openssl命令前，请确保本地已安装openssl。 如果本地为Windows操作系统，请进入“命令提示符”对话框后，再执行证书转换命令。 父主题： 证书管理

系统自动生成策略包括哪些防护规则？ 在添加防护网站进行“策略配置”时，您可以选择已创建的防护策略或默认的“系统自动生成策略”，系统自动生成的策略相关说明如表1所示。 入门版、标准版只能选择“系统自动生成策略”。 您也可以在域名接入后根据防护需求配置防护规则。 表1 系统自动生成策略说明 版本 防护策略 策略说明 云模式：入门版、标准版 Web基础防护（“仅记录”模式、常规检测） 仅记录SQL注入、XSS跨站脚本、远程溢出攻击、文件包含、Bash漏洞攻击、远程命令执行、目录遍历、敏感文件访问、命令/代码注入等攻击行为。 云模式：专业版、铂金版/独享模式 Web基础防护（“仅记录”模式、常规检测） 仅记录SQL注入、XSS跨站脚本、远程溢出攻击、文件包含、Bash漏洞攻击、远程命令执行、目录遍历、敏感文件访问、命令/代码注入等攻击行为。 网站反爬虫（“仅记录”模式、扫描器） 仅记录 漏洞扫描 、病毒扫描等Web扫描任务，如OpenVAS、Nmap的爬虫行为。 “仅记录”模式：发现攻击行为后WAF只记录攻击事件不阻断攻击。 父主题： 其他类

仅放行通过WAF的访问请求，如何配置？ 您可以在源站服务器上配置只放行WAF回源IP的访问控制策略，即仅允许通过WAF的请求访问到源站，防止黑客获取源站IP后绕过WAF直接攻击源站，以确保源站安全、稳定、可用。 放行WAF回源IP的访问控制策略操作说明如下： 源站服务器配置放行WAF回源IP的访问控制策略。 云模式：请参见如何放行云模式WAF的回源IP段？。 独享模式：请参见放行独享引擎回源IP。 建议您关闭防火墙和服务器安全防护软件。 父主题： 使用说明类

为什么Cookie中有HWWAFSESID或HWWAFSESTIME字段？ HWWAFSESID：会话ID；HWWAFSESTIME：会议时间戳，这两个字段用于标记请求，如CC防护规则中用户计数。 防护域名/IP接入WAF后，WAF会在客户请求Cookie中插入HWWAFSESID（会话ID），HWWAFSESTIME（会话时间戳）等字段，这些字段服务于WAF统计和安全特性，不插入这些字段将会影响CC人机验证、攻击惩罚、动态反爬虫的功能使用。 如果您不希望WAF在Cookie中插入HWWAFSESTIME和HWWAFSESID字段，可参考开启不插入Cookie字段的能力开启“不插入Cookie字段”。 父主题： 使用说明类