文档首页/ 华为云命令行工具服务 KooCLI/ 常见问题/ 区域相关/ 提示不支持的cli-region时如何处理?
更新时间:2023-10-16 GMT+08:00

提示不支持的cli-region时如何处理?

问题背景

使用KooCLI调用所有云服务的API时,都需要提供合适的cli-region。如果您遇到如下几种情况:

  • 命令中cli-region值输入有误;
  • 命令指定了cli-region值,但目标API不支持该cli-region;
  • 命令中未指定cli-region值,目标API不支持从当前配置项中获取的cli-region。

会提示如下错误:

[USE_ERROR]cli-region的值不支持,当前支持的区域值如下:*

[USE_ERROR]当前配置项中cli-region的值不支持,当前支持的区域值如下:*

解决步骤

  1. 如遇如上情形时,请您参考该提示信息中支持的cli-region列表,确认cli-region值是否误输;
  2. 若您确认cli-region值无误,但命令执行时提示如上错误,可能是因为如下原因:
    1. 若您已使用在线模式,则目标API不支持该cli-region,请你按照实际情况修改:
      1. 命令中指定了cli-region值,请您参考该提示信息中支持的cli-region列表,修改命令中的cli-region值,重新调用;
      2. 命令中未指定cli-region值,KooCLI会在运行过程中解析并使用当前配置项中的cli-region值。您可根据错误提示中支持的cli-region列表,在当前命令中添加“--cli-region=${regionValue}”后重新调用。如您要修改配置项中cli-region的值,请您执行“hcloud configure set --cli-profile=${profileName} --cli-region=${regionValue}”命令;
    2. 若您已使用离线模式,可能是您当前使用的离线数据包并非最新版本,导致参数校验不通过。您可先执行“hcloud meta download”命令,更新离线数据包后,再重新执行原命令;若仍提示如上错误,则该cli-region值未在KooCLI离线模式中上线,请等待离线数据包更新,或切换至在线模式尝试;
  3. 如KooCLI在执行命令的过程中未提示您如上所述的错误信息,但调用API的返回值显示region错误,可能是因您本地缓存cli-region列表的文件被修改,导致参数校验失其准确性。此时请您执行“hcloud meta clear”命令清理本地缓存文件后,重新调用;
  4. 如您的错误提示信息是中文,说明您此前已在配置中将KooCLI语言设置为中文,或KooCLI判断您的系统语言为中文。目前英文环境下KooCLI中云服务的各API支持的cli-region与中文环境存在差异。若您要将语言设置为英文,您可以通过执行“hcloud configure set --cli-lang=en”命令修改语言配置;