检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
/Users/{当前用户名}/.hcloud/metaOrigin/ 如何清理元数据缓存文件 在线模式： 清理缓存文件时执行命令“hcloud meta clear”即可。元数据缓存文件清理后，调用API时会重新获取并写入新文件。 离线模式： 执行命令“hcloud meta clear”
日志文件存于何处？ KooCLI会记录您使用过程中产生的日志信息。日志记录功能暂不支持关闭。 日志文件名称为“hcloud.log”，日志文件的存放位置如下： Linux系统：/home/{当前用户名}/.hcloud/log/ Windows系统：C:\Users\{当前用户名}\
检查配置文件格式 为快速检验本地配置文件的格式是否正确，可执行如下命令： hcloud configure test hcloud configure test 配置文件格式正确 父主题： 配置信息管理
SON文件，在该文件中，各API参数需要根据其在request中的位置信息被放在对应的Key下。 构造JSON文件的方法有如下两种： 方法一 使用“--skeleton”生成并填写JSON格式API入参骨架文件，并将该文件以“--cli-jsonInput=${JSON文件名}”传入。
如何卸载KooCLI？ KooCLI无需安装，下载解压后即可使用。因此您在卸载时仅需要删除该工具及相关本地缓存文件即可。请参考如下步骤： 执行“hcloud auto-complete off”命令关闭自动补全； 删除缓存文件，配置文件及日志文件： Linux系统： /home/{当前用户名}/
查看帮助信息 KooCLI支持在命令中添加“--help”参数查看帮助信息，例如： hcloud --help 查看KooCLI的使用方法及支持的云服务列表。 hcloud <service> --help 查看指定云服务的operation列表。例如查看“ECS”服务的operation列表：hcloud
如何解决网络连接超时问题？ 问题背景 KooCLI调用云服务API的过程中，会对您输入参数的合法性进行校验，此校验过程可能需要远程获取该云服务和API的详情信息；在参数校验完成后，亦需要远程调用您的目标API。如在调用过程中因网络连接问题导致请求失败，会提示相关错误，例如： [NETWORK_ERROR]连接超时
云服务的API可在API Explorer上查看。您可以在API Explorer上先填写好各参数的值，即可从“CLI示例”页签中直接获取命令。 KooCLI帮助信息查询 具体查询方法可参考查看与执行云服务操作命令，Mac和Linux系统下查询方法类似。 通过KooCLI调用云服务API。
Dockerfile文件名带有大写字母D，且没有文件扩展名，每个目录只能保存一个。 hcloud_install.sh文件为一键式安装KooCLI的脚本文件，其对应的软件包校验文件为hcloud_install.sh.sha256 可在上述Dockerfile文件中追加如下内容，指定启动容器时运行的程序为KooCLI：
等信息。若您本地缓存的元数据文件被修改，可能会使KooCLI在运行过程中无法根据缓存文件正确解析到该API的参数详情，导致校验时提示如下错误： [CLI_ERROR]参数*的位置不正确:* [USE_ERROR]不支持的参数类型:key=*,type=* 解决方案 如遇如上情况，您可执行“hcloud
I入参骨架。在命令中添加“--skeleton”选项，则在当前目录生成该API的JSON格式的入参文件，用户可填写文件中的参数值，以“--cli-jsonInput=${JSON文件名}”传入参数，调用API： hcloud RDS CreateConfiguration --c
风险防范 我们强烈建议您： 在.hcloud目录及其子目录和文件上配置适当的文件系统权限，仅限授权用户访问。 在使用敏感变量时对变量值进行加密，以防止敏感信息泄露。 尽可能使用临时认证凭据以降低认证凭据泄露时带来的风险。 父主题： 安全
步骤四：查看与执行云服务操作命令 本节以Windows系统为例介绍KooCLI的使用，Linux和Mac系统的使用基本相同，可参考。 完成初始化配置后，即可查询KooCLI支持的云服务列表，并执行相关命令。下文以弹性云服务器（ECS）的查询云服务器详情的API为例，说明如何查找与执行命令。
旧输出参数cli-json-filter如何使用？ 通过KooCLI调用云服务API，默认会返回json格式的调用结果。KooCLI支持使用“--cli-json-filter”对json结果执行JMESPath查询，方便提炼其中的关键信息，如下： 以默认的json格式输出原调用结果：
云服务API的版本查询与指定 版本查询 您可以通过“hcloud <service> --help”命令，查看该云服务的operation列表。若在查询结果的“Available Operations”中某operation出现多次，且以“/”拼接了不同的版本号，则调用该AP
N格式的文件，且文件扩展名必须为“.json”，支持传入的最大文件为5MB；使用“--cli-jsonInput”时，会校验JSON文件的格式及文件中参数的类型。若JSON文件的格式有误，会提示： [USE_ERROR]cli-jsonInput参数的文件解析失败,文件中参数有误
数）。若不存在，请您检查是否误输。若存在（此种冲突的情况出现的概率极小），请您将命令中的API参数写入cli-jsonInput文件中，以JSON文件的方式传递API参数。 父主题： 参数相关
如KooCLI在命令执行过程中未提示您如上所述的错误信息，但调用API的返回值显示参数有误，可能是因您本地缓存API详情的文件被修改，导致参数校验失其准确性。您可通过执行“hcloud meta clear”命令清理当前的缓存文件后，重新执行“hcloud <service> <operation> --help”
提示不支持的服务时如何处理？ 问题背景 KooCLI调用云服务API的过程中，会对您输入参数的合法性进行校验。如果您命令中云服务的名称输入有误，或调用的云服务未在KooCLI上线，会提示相关错误： [USE_ERROR]不支持的服务名称:* 解决步骤 如遇如上情形，您可先通过执行“hcloud
但调用API的返回值显示region错误，可能是因您本地缓存cli-region列表的文件被修改，导致参数校验失其准确性。此时请您执行“hcloud meta clear”命令清理本地缓存文件后，重新调用； 如您的错误提示信息是英文，说明您此前已在配置中将KooCLI语言设置为英
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
