检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本节以Windows系统为例介绍KooCLI的使用，Linux和Mac系统的使用基本相同，可参考。 完成初始化配置后，即可查询KooCLI支持的云服务列表，并执行相关命令。下文以弹性云服务器（ECS）的查询云服务器详情的API为例，说明如何查找与执行命令。 查询云服务的operation列表 hcloud
删除所有配置项 可执行如下命令，经交互确认后即可删除所有配置项： hcloud configure clear hcloud configure clear 是否删除所有配置信息(y/N): y 已删除所有配置信息 父主题： 配置信息管理
无配置方式使用概述 KooCLI既可以使用配置项调用云服务API，也提供了无配置的操作方式，无配置方式使用是指在使用KooCLI时不通过已有配置项传入当前用户的认证信息，而是直接在命令中传入当前用户认证相关的参数。此方式可使用户免于添加配置项，方便快捷地使用KooCLI。用户可以通过如下认证方式直接调用云服务API：
在Windows系统上安装KooCLI 点此下载适配Windows系统的KooCLI。 解压后得到hcloud.exe文件，如下图所示。 图1 在Windows系统下载并解压后的hcloud.exe文件 （可选）将KooCLI所在目录加入到系统环境变量Path中，方便在cmd窗口的任意目录下使用hcloud命令。 Windows
无配置方式ecsAgency 在用户已成功建立向弹性云（ECS）服务器的委托的前提下，在ECS服务器中使用KooCLI时，可以在命令中指定“--cli-mode=ecsAgency”，KooCLI将基于ECS委托，自动获取临时的AK/SK和SecurityToken用于认证。 此认证方式要
删除指定配置项及其custom参数 使用“--cli-profile”指定要删除的配置项的名称。删除指定配置项的命令为： hcloud configure delete --cli-profile=${profileName} hcloud configure delete --cli-profile=test
如何解决网络连接超时问题？ 问题背景 KooCLI调用云服务API的过程中，会对您输入参数的合法性进行校验，此校验过程可能需要远程获取该云服务和API的详情信息；在参数校验完成后，亦需要远程调用您的目标API。如在调用过程中因网络连接问题导致请求失败，会提示相关错误，例如： [NETWORK_ERROR]连接超时
PI中存在与新系统参数或旧系统参数重名的参数，被写入jsonInput文件中的默认将被识别为该API的参数； “--cli-jsonInput”选项传入的JSON文件中，KooCLI会根据JSON最外层的Key获取并解析其的参数值，目前支持的Key包括：path、query、bo
-num在使用时的注意事项有哪些？ 新输出参数的使用方法请参考：指定结果的输出格式。 命令中使用“--cli-query”用于传入JMESPath表达式，对结果执行JMESPath查询，方便提炼原返回结果中的关键信息；“--cli-output”用于指定响应数据的输出格式；“--
旧输出参数cli-json-filter如何使用，注意事项有哪些？ 旧输出参数cli-json-filter如何使用？ 旧输出参数cli-json-filter使用时的注意事项有哪些？ 父主题： 输出格式相关
通过KooCLI管理和使用您的各类云服务资源时，会远程获取您命令中目标云服务及其API的详情信息。为减少远程调用次数，提高响应速度，KooCLI引入了缓存机制，在运行过程中将云服务及其API的相关信息保存在本地缓存文件中，该文件称为元数据缓存文件。在元数据缓存文件过期前，会使用该文件中的信息对命令中的参数进行校验和组装。
提示缺少cli-region参数时如何处理？ 问题背景 使用KooCLI调用所有云服务的API时，都需要指定区域（即cli-region）。如果您未在命令中指定cli-region值，且您当前使用的配置项中也未配置cli-region值，会提示如下错误： [USE_ERROR]请输入cli-region
on”。其中，未添加“cli-”前缀的称为旧系统参数；添加了“cli-”前缀的称为新系统参数。之所以支持新系统参数，是因为在KooCLI上开放的云服务中，存在部分API的某参数与旧系统参数重名的情况。该场景可能会使命令中两个同名的参数用于不同的用途，即：其一作为目标API参数，另
自动补全提示参数时，若提示的参数名中有“[N]”，其含义为索引位，请使用数字代替该字符；若提示的参数名中有“{*}”，其含义为自定义参数名称，请使用任意不含“.”的字符串代替该字符； 若同一机器同一用户的多个目录下有KooCLI，且其中某一目录下的工具开启了自动补全，则该用户其他目录下的KooCLI也可完成自动补全功能。
通过KooCLI管理和使用您的各类云服务资源，在调用云服务的API时，KooCLI优先使用命令中“--cli-profile”选项指定的配置项。 如您未在命令中指定配置项，会使用默认配置项来调用目标API。 若该配置项的内容与目标API不匹配，或缺少访问目标API时需要的某参数，会提示相关错误，例如：
旧输出参数cli-json-filter使用时的注意事项有哪些？ KooCLI支持使用“--cli-json-filter”传入JMESPath表达式，对json结果执行JMESPath查询，提炼其中的关键信息。使用“--cli-json-filter”时需注意： 当命令中使用了
utput-num如何使用？ 旧输出参数cli-output-rows，cli-output-cols，cli-output-num使用时的注意事项有哪些？ 父主题： 输出格式相关
使用？ 通过KooCLI调用云服务API，默认会返回json格式的调用结果。KooCLI支持使用“--cli-json-filter”对json结果执行JMESPath查询，方便提炼其中的关键信息，如下： 以默认的json格式输出原调用结果： hcloud ECS NovaListServers
方式输出所有配置项中的accessKeyId信息； “--cli-output-rows”的参数值中可使用“[n]”或“[m:n]”指定其中要打印的数组元素的索引位。指定“[n]”时会打印索引为n的值；指定“[m:n]”时会打印原数据m ~（n-1）索引位置的值。例如执行命令“hcloud
} 以table输出调用结果时，“--cli-output-rows”指定json结构体的层级，即表格的数据来源；“--cli-output-cols”指定表格的列名，需要与json结构体中的字段相对应；“--cli-output-num”指定是否打印表格行号，默认值为true，如下图所示:
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
