检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
误，请根据错误提示做相应修改； [OPENAPI_ERROR]：一般是调用云服务API时发生的错误，请联系相关云服务oncall协助处理； [APIE_ERROR]：一般是调用API Explorer获取元数据时发生的错误，请联系API Explorer云服务oncall协助处理。
本节以Windows系统为例介绍KooCLI的使用，Linux和Mac系统的使用基本相同，可参考。 如果您希望以无配置方式使用KooCLI，可跳过此步骤；若您希望以非交互方式添加配置项，请参考新增或修改配置项。 KooCLI初始化命令用于将常用的永久AK/SK和区域信息存储在配置文
检查命令正确性 dryrun选项用于检查所传入命令的正确性。在命令中添加“--dryrun”选项，执行校验后打印请求报文，跳过实际运行，不调用目标API： hcloud RDS CreateConfiguration --cli-region="cn-north-4" --project_
日志进行访问权限控制以达到审计日志不可篡改的目的。此外， 同使用SDK一样，KooCLI将用户命令解析成https请求发送到API Gateway后，API Gateway记录的相关信息也可用作审计目的。 详情请见日志管理。 父主题： 安全
KooCLI既可以使用配置项调用云服务API，也提供了无配置的操作方式，无配置方式使用是指在使用KooCLI时不通过已有配置项传入当前用户的认证信息，而是直接在命令中传入当前用户认证相关的参数。此方式可使用户免于添加配置项，方便快捷地使用KooCLI。用户可以通过如下认证方式直接调用云服务API： 无配置方式AKSK
提示不正确的参数时如何处理？ 问题背景 通过KooCLI管理和使用您的各类云服务资源时，在调用云服务API的过程中，会对您输入参数的合法性进行校验。若您在命令中输入了当前API不支持的参数，或将只允许配置在配置项中使用的参数在命令直接传入，会提示如下错误： [USE_ERROR]不正确的参数:*
元数据缓存文件存于何处？如何清理？ 通过KooCLI管理和使用您的各类云服务资源时，会远程获取您命令中目标云服务及其API的详情信息。为减少远程调用次数，提高响应速度，KooCLI引入了缓存机制，在运行过程中将云服务及其API的相关信息保存在本地缓存文件中，该文件称为元数据缓存文件。在元数据缓存文件过期前，会使
cli-endpoint用于自定义请求云服务的域名。KooCLI默认会请求对应区域的目标云服务，您也可以针对该云服务指定Endpoint： hcloud IoTDA UpdateDevice --cli-region="cn-north-4" --description="test update device"
指定至对象层级，KooCLI会以该对象各属性名的字典顺序，输出其对应的值。在此示例中指定至对象"items[0]"，该对象中各属性按字典顺序排序后为：apiVersion，kind，metadata，spec，status。因此输出结果如下： hcloud CCE ListClusters -
体验优化 KooCLI版本：2.1.13 调用多版本服务的API时，若用户未指明API的版本号的，默认调用该API的最新版本。 公测 指定云服务API和版本号 3 新特性 KooCLI版本：2.1.10 调用云服务API时，根据命令中用户的认证信息自动获取用户未输入的必填参数“domain_id”。
访问密钥（永久AK/SK） 用户可以在命令中直接输入永久AK（cli-access-key）和SK（cli-secret-key）调用云服务API： hcloud ECS NovaListServers --cli-region="cn-north-4" --project_id="
aS和SaaS类云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、虚拟主机和访客虚拟机的操作系统，虚拟防火墙、API网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措
日志管理 KooCLI提供日志记录和管理功能，会缓存API调用过程中产生的日志信息，日志文件保存目录如下： Windows系统： C:\Users\{您的Windows系统用户名}\.hcloud\log\ Linux系统: /home/{当前用户名}/.hcloud/log/ Mac系统：
旧输出参数cli-output-rows，cli-output-cols，cli-output-num如何使用？ 通过KooCLI调用云服务API，默认会返回json格式的调用结果。KooCLI支持使用“--cli-output-rows”，“--cli-output-cols”，“
无法识别命令中%s的位置.请确认该参数为:KooCLI系统参数(a);目标API参数(b);兼为两者(c): 目标API中可自定义与KooCLI系统参数%s同名的参数,无法识别命令中%s的位置.请确认该参数为:KooCLI系统参数(a);目标API参数(b);兼为两者(c): 因此，当您构建KooCL
元数据管理 清理元数据缓存 KooCLI会缓存API调用过程中获取并保存在用户本地的元数据缓存文件，放置在如下目录下： 在线模式： Windows系统： C:\Users\{您的Windows系统用户名}\.hcloud\metaRepo\ Linux系统: /home/{当前用户名}/
华为云命令行工具服务（Koo Command Line Interface，KooCLI），是为发布在API Explorer上的华为云服务API提供的命令行管理工具。您可以通过此工具调用API Explorer中各云服务开放的API，管理和使用您的各类云服务资源。 在线体验 详细文档 仅两个按钮时选用 立即使用
旧输出参数cli-json-filter如何使用？ 通过KooCLI调用云服务API，默认会返回json格式的调用结果。KooCLI支持使用“--cli-json-filter”对json结果执行JMESPath查询，方便提炼其中的关键信息，如下： 以默认的json格式输出原调用结果：
} --cli-region=${regionValue}”命令将其配置到目标配置项中。后续使用该配置项调用API时，命令中可以不必输入cli-region；但若目标API不支持该cli-region，则您仍需在命令中通过“--cli-region=${regionValue}”传入支持的cli-region。
如何卸载KooCLI？ KooCLI无需安装，下载解压后即可使用。因此您在卸载时仅需要删除该工具及相关本地缓存文件即可。请参考如下步骤： 执行“hcloud auto-complete off”命令关闭自动补全； 删除缓存文件，配置文件及日志文件： Linux系统： /home/{当前用户名}/
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
