华为云命令行工具服务 KooCLI-概述

时间：2025-02-12 14:52:48

概述

KooCLI将调用命令时出现的错误分为五种类型，在错误提示信息的起始位置声明其具体类型：[NETWORK_ERROR]，[CLI_ERROR]，[USE_ERROR]，[OPENAPI_ERROR]和[APIE_ERROR]。各类错误的定位方法如下：

[NETWORK_ERROR]：一般是HTTP请求异常，请检查网络连接；
[CLI_ERROR]：一般是因KooCLI处理命令过程中本身的异常导致的错误，请联系KooCLI的oncall协助处理；
[USE_ERROR]：一般是因命令中参数不正确造成的错误，请根据错误提示做相应修改；
[OPENAPI_ERROR]：一般是调用云服务API时发生的错误，请联系相关云服务oncall协助处理；
[APIE_ERROR]：一般是调用 API Explorer 获取元数据时发生的错误，请联系API Explorer云服务oncall协助处理。

您也可以根据下表常见问题概览查找所需内容。

表1 常见问题概览
常见问题分类	相关链接
认证相关	如何获取永久AK/SK？
	如何获取账号ID、项目ID？
	如何获取区域？
	如何获取临时AK/SK和securitytoken？
	各认证方式的优先级是什么？
配置项相关	命令中未指定配置项时默认使用哪个配置项？
元数据缓存相关	元数据缓存文件存于何处？如何清理？
日志相关	日志文件存于何处？
网络连接相关	如何解决网络连接超时问题？
云服务相关	提示不支持的服务时如何处理？
云服务API相关	提示不支持的operation时如何处理？
	如何指定云服务的API和版本号？
	云服务API的响应体为空时，如何判断命令是否执行成功？
区域相关	提示缺少cli-region参数时如何处理？
区域相关	提示不支持的cli-region时如何处理？
参数相关	KooCLI系统参数包括哪些？
	提示不正确的参数时如何处理？
	为什么会有新旧系统参数，如cli-region与region，在使用时的区别是什么推荐使用哪个？
	提示重复的参数时如何处理？
	如何使用cli-jsonInput？注意事项有哪些？
	使用cli-jsonInput的场景有哪些？
	提示不支持的参数位置/类型时如何处理？
	云服务API的body位置参数值如何置空？
交互式/自动补全相关	使用交互式/自动补全需要注意什么？
输出格式相关	KooCLI支持的输出格式有哪些？
	JMESPath表达式的用法有哪些？
	JMESPath支持的内置函数有哪些？
	KooCLI与输出相关的系统参数有哪些，推荐使用哪些？
	新输出参数cli-output，cli-query，cli-output-num在使用时的注意事项有哪些？
	旧输出参数cli-output-rows，cli-output-cols，cli-output-num如何使用？
	旧输出参数cli-output-rows，cli-output-cols，cli-output-num使用时的注意事项有哪些？
	旧输出参数cli-json-filter如何使用？
	旧输出参数cli-json-filter使用时的注意事项有哪些？
其他	无配置方式使用KooCLI需要注意什么？
	命令中服务名、operation、参数的value值是否需要使用双引号引起？
	在线/离线模式分别适用什么场景？
	如何卸载KooCLI？