Koo Command Line Interface
Koo Command Line Interface
- Function Overview
- What's New
- Service Overview
- Getting Started
-
User Guide
- Configuration Management
- HTTP Proxy
- Commonly Used Commands
-
Options
- Option Overview
- Printing Help Information
- Printing Debugging Information
- Generating API Input Parameter Skeleton in JSON Format
- Checking Command
- Specifying Region
- Calling APIs with AK/SK in Non-configuration Mode
- Specifying Account ID
- Specifying Profile
- Specifying Authentication Mode
- Specifying Output Format
- Passing API Parameters with JSON File
- Specifying Request Timeouts
- Specifying Retry Count
- Skipping HTTPS Request Certificate Verification
- Specifying a Domain Name
- Polling Results
- Obtaining CLI Examples on API Explorer
- Using KooCLI in Non-configuration Mode
- Online Experience
- Obtaining Authentication Information
-
FAQs
- Overview
- Authentication
- Profiles
- Metadata Cache
- Logs
- Network Connections
- Cloud Services
- Cloud Service APIs
- Regions
-
Parameters
- What Are KooCLI System Parameters?
- Why Am I Seeing a Message Indicating an Invalid Parameter?
- Why Are Old and New KooCLI System Parameters (Such as region and cli-region) Available? Which Parameters Are Recommended?
- Why Am I Seeing a Message Indicating a Duplicate Parameter?
- How Do I Use cli-jsonInput?
- When Can I Use cli-jsonInput?
- Why Am I Seeing a Message Indicating an Unsupported Parameter Position or Type?
- How Do I Leave a Body Parameter Empty for Cloud Service APIs?
- Interactive Mode and Autocomplete
-
Output Formats
- What Output Formats Are Supported by KooCLI?
- How Do I Define a JMESPath Expression?
- Which KooCLI System Parameters Are Related to Data Output? Which Ones Are Recommended?
- How Do I Use cli-output, cli-query, and cli-output-num?
- How Do I Use cli-output-rows, cli-output-cols, and cli-output-num? What Are the Precautions?
- How Do I Use cli-json-filter? What Are the Precautions?
- Other
- Videos
- General Reference
On this page
Show all
Help Center/
Koo Command Line Interface/
FAQs/
Regions/
Why Am I Seeing a Message Indicating Unsupported cli-region?
Copied.
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
- View the supported regions in the prompt and check whether the cli-region value you specified is correct.
- If the value is correct but one of the preceding error messages is displayed during command execution, check the following possible causes:
- Using the online mode: The target API does not support the cli-region. Modify the parameter as follows:
- 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.
- 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.
- 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.
- Using the online mode: The target API does not support the cli-region. Modify the parameter as follows:
- 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.
- 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.
Parent topic: Regions
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
The system is busy. Please try again later.
For any further questions, feel free to contact us through the chatbot.
Chatbot