Help Center/ Koo Command Line Interface/ FAQs/ Regions/ Why Am I Seeing a Message Indicating Unsupported cli-region?
Updated on 2023-10-16 GMT+08:00

Why Am I Seeing a Message Indicating Unsupported cli-region?

Background

When you use KooCLI to call cloud service APIs, a proper value of cli-region is required. If you encounter any of the following situations:

  • The value of cli-region in the command is incorrect.
  • The value of cli-region is specified in the command, but the target API does not support the region.
  • The value of cli-region is not specified in the command, and the target API does not support the region obtained from the current profile.

Either of the following error messages is displayed:

[USE_ERROR] The value of cli-region is not supported. Supported regions: *

[USE_ERROR] Value of cli-region in the current profile is not supported. Supported regions: *

Solution

  1. View the supported regions in the prompt and check whether the cli-region value you specified is correct.
  2. If the value is correct but one of the preceding error messages is displayed during command execution, check the following possible causes:
    1. Using the online mode: The target API does not support the cli-region. Modify the parameter as follows:
      1. If you have specified the value of cli-region in the command, change this value based on the list of supported regions in the prompt message, and try again.
      2. If the value of cli-region is not specified in the command, KooCLI parses and uses the value in the current profile. Add --cli-region=${regionValue} to the current command based on the list of supported regions in the error message, and try again. To change the value of cli-region in the profile, run the hcloud configure set --cli-profile=${profileName} --cli-region=${regionValue} command.
    2. Using the offline mode: The offline data package you used may not be the latest version, resulting in a parameter verification failure. In this case, run the hcloud meta download command to update the offline data package, and run the original command again. If the error persists, the cli-region value is unavailable for KooCLI offline mode. Try again when the offline data package is updated, or use the online mode instead.
  3. If the preceding error messages are not displayed during the command execution, but the returned value of the called API indicates that the region is incorrect, the local cache files containing the cli-region list may be modified. As a result, the parameter verification of KooCLI is inaccurate. In this case, run the hcloud meta clear command to clear the local cache files, and try again.
  4. Determine your current language environment based on the language setting on KooCLI or your system language. Currently, the regions (cli-region) supported by cloud service APIs in the English environment are different from those in the Chinese environment. To switch the language, run the hcloud configure set --cli-lang=en command.