检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
前提下，在ECS服务器中使用KooCLI时，可以在命令中指定“--cli-mode=ecsAgency”，KooCLI将基于ECS委托，自动获取临时的AK/SK和SecurityToken用于认证。 此认证方式要求用户已经建立了ECS服务器委托。若该委托尚未建立，可以在IAM对该
方便在任意目录下使用hcloud命令（完成本步骤之前，请确保PATH系统变量值中存在“/usr/local/bin/”路径）。 您可在该命令执行过程中根据交互信息修改文件下载目录等。如执行过程中提示权限不足，您可切换至root用户重新执行安装命令。 若您希望使用其默认配置且跳过交
若执行如上命令的输出值是“x86_64”，请使用AMD 64位系统的下载命令；若执行该命令输出结果为空，请使用如下命令查看您主机的操作系统： uname -a 执行如上命令的输出值结尾是“x86_64”，请使用AMD 64位系统的下载命令；若输出值结尾是“arm64”，请使用ARM 64位系统的下载命令。
旧输出参数cli-json-filter如何使用？ 通过KooCLI调用云服务API，默认会返回json格式的调用结果。KooCLI支持使用“--cli-json-filter”对json结果执行JMESPath查询，方便提炼其中的关键信息，如下： 以默认的json格式输出原调用结果：
e值是否需要使用双引号引起？ 需要视参数value的具体内容而定。 一般情况下，命令中的服务名、operation、参数的value值可不必使用双引号引起。但若您命令中的服务名、operation、参数的value值中有特殊符号、空格、或需要转义的符号，请您在命令中传入该值时，将其使用双引号引起。
在Windows系统上安装KooCLI 点此下载适配Windows系统的KooCLI。 解压后得到hcloud.exe文件，如下图所示。 图1 在Windows系统下载并解压后的hcloud.exe文件 （可选）将KooCLI所在目录加入到系统环境变量Path中，方便在cmd窗口的任意目录下使用hcloud命令。
种输出格式外的tsv输出格式，同时也使输出参数得以统一，方便用户使用。 KooCLI之后关于输出格式相关的功能，将在新输出参数的基础上开发。对旧输出参数将仅维持其已有功能，不再持续升级。故用户在构造命令时，推荐使用新输出参数。 父主题： 输出格式相关
针对不同的环境，您可以参考如下方式完成快速安装： 在Windows系统上安装KooCLI 在Linux系统上安装KooCLI 在MacOS系统上安装KooCLI 在Docker中配置和使用KooCLI 您也可以从下表中直接下载适配您目标系统的KooCLI到本地，再将其上传至您的目标机器，解压后即可使用： 表1 下载地址
“--cli-output-cols”与“--cli-output-rows”可单独使用，也可组合使用： 单独使用“--cli-output-rows”： 在命令中单独使用“--cli-output-rows”传入调用结果中某json结构体的名称时，各层级之间以“.”分隔，目标json结构体的内容必须为数
通过KooCLI管理和使用您的各类云服务资源时，会远程获取您命令中目标云服务及其API的详情信息。为减少远程调用次数，提高响应速度，KooCLI引入了缓存机制，在运行过程中将云服务及其API的相关信息保存在本地缓存文件中，该文件称为元数据缓存文件。在元数据缓存文件过期前，会使用该文件中的信息对命令中的参数进行校验和组装。
无配置方式AKSK 访问密钥（永久AK/SK） 用户可以在命令中直接输入永久AK（cli-access-key）和SK（cli-secret-key）调用云服务API： hcloud ECS NovaListServers --cli-region="cn-north-4" --
另外，若云服务的API中存在（或可自定义）与旧系统参数同名的参数，则若该参数出现在命令中，KooCLI将无法确认该参数作何种用途。故在解析该命令的过程中，会通过交互向信息向用户确认该参数的实际用途，避免解析错误。例如： 目标API中存在与KooCLI系统参数%s同名的参数,无法识别命令中%s的位置
custom参数的名称不能超过128位字符。在交互设置的过程中，用户可根据custom参数在使用中的实际需要判断该参数是否需要加密保存。对于需要加密保存的custom参数，为保障您的参数安全，对您输入的参数值进行了匿名化处理。在您输入过程中不会显示输入的字符，在输入结束回车至下一行时，会以“****”回显您的输入内容。
--cli-agree-privacy-statement=true 修改是否加密存储配置文件中的认证信息 是否加密存储配置文件中的认证信息修改后，将作用于所有配置项。可通过如下命令配置不加密存储配置文件中的认证信息： hcloud configure set --cli-auth-encrypt=false
云服务相关 提示不支持的服务时如何处理？
num如何使用？ 通过KooCLI调用云服务API，默认会返回json格式的调用结果。KooCLI支持使用“--cli-output-rows”，“--cli-output-cols”，“--cli-output-num”参数，以table格式输出，方便提炼调用结果中的关键信息，如下：
旧输出参数cli-json-filter如何使用，注意事项有哪些？ 旧输出参数cli-json-filter如何使用？ 旧输出参数cli-json-filter使用时的注意事项有哪些？ 父主题： 输出格式相关
本节以Windows系统为例介绍KooCLI的使用，Linux和Mac系统的使用基本相同，可参考。 如果您希望以无配置方式使用KooCLI，可跳过此步骤；若您希望以非交互方式添加配置项，请参考新增或修改配置项。 KooCLI初始化命令用于将常用的永久AK/SK和区域信息存储在配置文件中，如下表所示，避免使用时频繁输入这些固定信息：
提示不支持的参数位置/类型时如何处理？ 问题背景 通过KooCLI管理和使用您的各类云服务资源，在调用云服务API的过程中，KooCLI会对您输入参数的合法性进行校验。在此校验过程中，KooCLI会获取该API中所有参数的详情信息，其中包括每个参数的类型、在request中的位置等信息。若您本地缓存的元数据文件被
提示不正确的参数时如何处理？ 问题背景 通过KooCLI管理和使用您的各类云服务资源时，在调用云服务API的过程中，会对您输入参数的合法性进行校验。若您在命令中输入了当前API不支持的参数，或将只允许配置在配置项中使用的参数在命令直接传入，会提示如下错误： [USE_ERROR]不正确的参数:*
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
