云服务器内容精选

  • 请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 xaccount_id 是 String 最大长度:128 伙伴销售平台的用户唯一标识,该标识的具体值由伙伴分配。 xaccount_type 是 String 最大长度:64 华为分给合作伙伴的平台标识。 该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。 domain_name 否 String [5-32] 客户的华为云账号名。 如果为空,随机生成。 不能以“op_”或“shadow_”开头且不能全为数字。 校验长度(5到32位)和规则^([a-zA-Z_-]([a-zA-Z0-9_-])*)$。 此参数不携带或携带值为空串或携带值为null时,随机生成。 mobile_phone 否 String 最大长度:32 手机号。 目前系统只支持中国的手机号。 示例:13XXXXXXXXX 此参数不携带或携带值为null时,不被赋值;携带值为空串时,赋值为空串。 verification_code 否 String [6] 验证码。 请调用“发送验证码”接口获取。 如果手机号不存在,则不需要输入验证码。 此参数不携带或携带值为null时,不做处理;不支持携带值为空串。 password 否 String 长度:[8-32] 密码规则如下: 至少包含以下四种字符中的两种: 大写字母、小写字母、数字、特殊字符; 不能和账号名或倒序的账号名相同; 不能包含手机号。 如果为空,用户没有密码,则不能直接在华为云登录,只能通过伙伴系统SSO方式跳转到华为云。 此参数不携带或携带值为null时,密码随机生成;不支持携带值为空串。 is_close_market_ms 否 String 最大长度:10 是否关闭营销消息的发送。 true:关闭 false:不关闭(默认) 此参数不携带或携带值为空串或携带值为null时,赋值为false。 indirect_partner_id 否 String 最大长度:64 云经销商ID。获取方法请参见查询云经销商列表。 如果需要创建云经销商的子客户,必须携带该字段。除此之外,此参数不携带或携带值为空串或携带值为null,不做处理。 include_association_result 否 Boolean - 是否返回子客户的关联结果。 true:返回子客户和伙伴的关联结果 false:不返回子客户和伙伴的关联结果 默认值为false。 此参数不携带或携带值为空串或携带值为null时,赋值为false。 请求示例 POST https://bss.myhuaweicloud.com/v2/partners/sub-customers HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "domain_name": "test", "mobile_phone": "188****8888", "verification_code": "253***", "xaccount_id": "35rey****", "xaccount_type": "***_IDP", "password": "*******", "is_close_market_ms": "true", "indirect_partner_id": "a0d736********aab6502d1a828c1809", "include_association_result": "false" }
  • 接口约束 该接口只允许使用合作伙伴AK/SK或者Token调用。 合作伙伴销售平台创建客户的页面必须体现华为云用户协议和隐私政策声明。 此接口会为客户创建委托授权,用于将合作伙伴的Token置换成客户Token,即允许合作伙伴以客户的身份做资源开通、查询等相关操作。因此合作伙伴销售平台在调用此接口前请先获得客户授权说明。 如果创建客户的时候输入手机号,在调用该接口前,请先调用“发送验证码”接口获取验证码。 自2022年8月1日起,密码长度至少为8个字符。
  • 状态码 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 请根据“请求消息”中请求参数的描述检查输入的参数是否满足条件。 400 CBC.0101 参数无效。 400 CBC.50010059 一级经销商不允许关联子客户。 400 CBC.50010065 该伙伴是云经销商,其关联的总经销商已经摘牌退出,无法拓客创建关联关系。 400 CBC.99000038 客户登录名已经存在。 400 CBC.99000029 客户手机号已经存在。 400 CBC.99000031 客户登录名格式不合法。 400 CBC.5017 客户手机号格式不合法。 400 CBC.99000039 xaccountId重复。 400 CBC.99000004 客户向伙伴授权时发生异常。 400 CBC.99000030 手机号注册数量超过上限。 400 CBC.99000036 客户密码格式不合法。 400 CBC.99000037 您没有操作该云经销商的权限。 500 CBC.99000050 伙伴和子客户关联结果查询超时,请使用查询客户列表确认最终关联结果。 400 CBC.99000051 该手机号/邮箱已被华为报备,无法创建客户。 400 CBC.99004008 有验证码,但是已经失效。 400 CBC.99004009 有验证码,但是校验失败次数已经大于3。 400 CBC.99004010 校验客户端输入的验证码错误。 400 CBC.99005035 测试伙伴账号不能使用该接口。 401 CBC.0154 token非法/过期。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。 400 CBC.50010085 该伙伴企业目前处于受限状态,无法拓客创建关联关系。 400 CBC.50010086 该伙伴是云经销商,其关联的总经销商企业目前处于受限状态,无法拓客创建关联关系。
  • 响应消息 响应参数 参数 参数类型 取值范围 描述 error_code String 最大长度:16 状态码。具体请参考状态码。只有失败才会返回这个参数。 error_msg String 最大长度:1024 错误描述信息。只有失败才会返回这个参数。 domain_id String 最大长度:64 客户ID。 只有成功或者错误码在CBC.99000050时才会返回。 domain_name String 最大长度:64 客户的华为云账号名。 若请求参数中传递了此参数值,此处返回的响应值与请求参数中取值一致。 若请求参数中未传递此参数值,此处返回的响应值为系统随机生成的32位字符串。 只有成功时或者错误码在CBC.99000050时才会返回。 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "domain_id": "06a7969058802f0c0f01c00b91846780", "domain_name": "a0d736359ada40aab6502d1a828c1809" }
  • 功能介绍 在伙伴销售平台创建客户时同步创建华为云账号,并将客户在伙伴销售平台上的账号与华为云账号进行映射。同时,创建的华为云账号与伙伴账号关联绑定。 华为云总经销商(一级经销商)可以注册云经销商(二级经销商)的子客户。注册完成后,子客户可以自动和云经销商绑定。 调用该接口为客户创建华为云账号后,如果想从合作伙伴销售平台跳转至华为云官网,还需要进行SAML认证,具体请参见“Web UI方式”中的“SAML认证”。 如果创建的时候不输入手机号,那么客户将无法收到华为云发出的任何提醒短信,需要客户自己登录到华为云平台补充手机号。 调用“创建客户”接口时,华为云会同步创建华为云客户账号,将客户ID及账号名返回给伙伴平台,然后华为云异步完成客户与伙伴的关联。伙伴与客户的关联结果可通过“查询客户列表”查询。 默认会创建代售模式的客户。
  • 请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 search_type 是 String [email|mobile|name] 该字段内容可填为:“email”、“mobile”或“name”。 search_value 是 String 最大长度:64 手机号、邮箱或登录名称。 手机号需符合正则表达式 ^\d{4}-\d+$;包括国家码,以00开头,格式:00XX-XXXXXXXX。目前手机号仅支持以86开头的国家码。 邮箱需为含有@的正确格式的完整邮箱地址。 name:符合正则表达式^([a-zA-Z-]([a-zA-Z0-9_-]){4,31})$,长度5-32;不能以“op_”或“shadow_”开头且不能全为数字,且只能以字母(不区分大小写)或者-开头。 请求示例 POST https://bss.myhuaweicloud.com/v2/partners/sub-customers/users/check-identity HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "search_type": "name", "search_value": "ceshiyonghu001" }
  • 响应消息 响应参数 参数 参数类型 取值范围 描述 error_code String 最大长度:16 状态码。具体请参考状态码。只有失败才会返回这个参数。 error_msg String 最大长度:1024 错误描述信息。只有失败才会返回这个参数。 check_result String 最大长度:32 available:该登录名称/手机号/邮箱有效。 used_by_user:该登录名称/手机号/邮箱已被占用。 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_code": "CBC.0000", "error_msg": "success", "check_result": "available" }
  • 状态码 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 请根据“请求消息”中请求参数的描述检查输入的参数是否满足条件。 400 CBC.50010065 该伙伴是云经销商,其关联的总经销商已经摘牌退出,无法拓客创建关联关系。 401 CBC.0154 token非法/过期。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。 500 CBC.4008 有验证码,但是已经失效。 500 CBC.4009 有验证码,但是校验失败次数已经大于3。 400 CBC.0101 参数无效。 500 CBC.5012 客户登录名已经存在。 500 CBC.5014 客户手机号已经存在。 500 CBC.5015 客户登录名格式不合法。 500 CBC.5017 客户手机号格式不合法。 500 CBC.5018 xAccountId重复。 500 CBC.5025 客户向伙伴授权时发生异常。 500 CBC.7228 客户密码格式不合法。 400 CBC.99000051 该手机号/邮箱已被华为报备,无法创建客户。 400 CBC.50010085 该伙伴企业目前处于受限状态,无法拓客创建关联关系。 400 CBC.50010086 该伙伴是云经销商,其关联的总经销商企业目前处于受限状态,无法拓客创建关联关系。
  • 响应消息 响应参数 参数 参数类型 取值范围 描述 error_code String 最大长度:16 状态码。具体请参考状态码。只有失败才会返回这个参数。 error_msg String 最大长度:1024 错误描述信息。只有失败才会返回这个参数。 domainId String 最大长度:64 客户ID。 只有成功或客户向伙伴授权发生异常(CBC.5025)时才会返回。 domainName String 最大长度:64 客户的华为云账号名。 若请求参数中传递了此参数值,此处返回的响应值与请求参数中取值一致。 若请求参数中未传递此参数值,此处返回的响应值为系统随机生成的32位字符串。 只有成功或客户向伙伴授权发生异常(CBC.5025)时才会返回。 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "domainId":"xxxxxxx", "domainName":"xxxxxxx" }
  • 请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 domainName 否 String 最大长度:32 最小长度:5 客户的华为云账号名。 如果为空,随机生成。 不能以“op_”或“shadow_”开头且不能全为数字。 校验长度(5到32位)和规则^([a-zA-Z_-]([a-zA-Z0-9_-])*)$。 此参数不携带或携带值为空串或携带值为null时,随机生成。 mobilePhone 否 String 最大长度:32 手机号。 目前系统只支持中国手机,必须全部是数字。 示例:13XXXXXXXXX 此参数不携带或携带值为null时,不被赋值;携带值为空串时,赋值为空串。 countryCode 否 String [0086] 手机国家码,目前只支持0086,输入手机号的情况下,该字段如果不填写,系统默认是0086。 此参数不携带或携带值为空串或携带值为null时,默认是0086。 verificationCode 否 String [1-10] 验证码。 请调用“发送验证码(旧)”接口获取。 如果手机号不存在,则不需要输入验证码。 此参数不携带或携带值为null时,不做处理;不支持携带值为空串。 xAccountId 是 String 最大长度:128 伙伴销售平台的用户唯一标识,该标识的具体值由伙伴分配。 xAccountType 是 String 最大长度:64 华为分给合作伙伴的平台标识。 该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。 password 否 String 长度:[8-32] 密码规则如下: 至少包含以下四种字符中的两种: 大写字母、小写字母、数字、特殊字符; 不能和账号名或倒序的账号名相同; 不能包含手机号。 如果为空,密码随机生成。 此参数不携带或携带值为null时,密码随机生成;不支持携带值为空串。 isCloseMarketMs 否 String 长度:[0-10] 是否关闭营销消息的发送: true:关闭; false:不关闭(默认)。 此参数不携带或携带值为空串或携带值为null时,赋值为false。 cooperationType 否 String - 合作类型。 1:顾问销售。 仅支持1,如果不传递,默认会创建成代售模式的客户。 此参数不携带或携带值为空串或携带值为null是,默认为代售。 请求示例 POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/customer-mgr/customer HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "domainName":"xxxxxxx", "mobilePhone":"xxxxxxxxxxx", "countryCode":"0086", "verificationCode":"xxxxxx", "xAccountId":"xxxxxxx", "xAccountType":"xxxxxxx", "cooperationType":"1" }
  • 功能介绍 在伙伴销售平台创建客户时同步创建华为云账号,并将客户在伙伴销售平台上的账号与华为云账号进行映射。同时,创建的华为云账号与伙伴账号关联绑定。 注意事项: 该接口只允许使用合作伙伴AK/SK或者Token调用。 合作伙伴销售平台创建客户的页面必须体现华为云用户协议和隐私政策声明。 此接口会为客户创建委托授权,用于将合作伙伴的Token置换成客户Token,即允许合作伙伴以客户的身份做资源开通、查询等相关操作。因此合作伙伴销售平台在调用此接口前请先获得客户授权说明。 如果创建客户的时候输入手机号,在调用该接口前,请先调用“发送验证码(旧)”接口获取验证码。 调用该接口为客户创建华为云账号后,如果想从合作伙伴销售平台跳转至华为云官网,还需要进行SAML认证,具体请参见“Web UI方式”中的“SAML认证”。 如果创建的时候不输入手机号,那么客户将无法收到华为云发出的任何提醒短信,需要客户自己登录到华为云平台补充手机号。 调用“创建客户”接口时,华为云会同步创建华为云客户账号,将客户ID及账号名返回给伙伴平台,然后华为云异步完成客户与伙伴的关联。伙伴与客户的关联结果可通过“查询客户列表(旧)”查询。 合作伙伴调用该接口创建的客户为合作伙伴的代售类客户。 自2022年8月1日起,密码长度至少为8个字符。 该接口即将下线,“创建客户”接口请参考创建客户。
  • 响应消息 响应参数 参数 参数类型 取值范围 描述 error_code String 最大长度:16 状态码。具体请参考状态码。只有失败才会返回这个参数。 error_msg String 最大长度:1024 错误描述信息。只有失败才会返回这个参数。 响应示例 HTTP/1.1 204 No ContentContent-Type: application/json;charset=UTF-8Content-Length: lengthDate: response time
  • 请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 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 其他错误。