检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
自定义请求域名 cli-endpoint用于自定义请求云服务的域名。KooCLI默认会请求对应区域的目标云服务，您也可以针对该云服务指定Endpoint： hcloud IoTDA UpdateDevice --cli-region="cn-north-4" --description="test
http_proxy="http://username:password@proxyServer:port" 其中，proxyServer为代理服务器的域名（如果能解析）或者IP。port为端口号。如果你的代理服务器需要用户名和密码才能访问，需要填写上面的username和passwo
括每个参数的类型、在request中的位置等信息。若您本地缓存的元数据文件被修改，可能会使KooCLI在运行过程中无法根据缓存文件正确解析到该API的参数详情，导致校验时提示如下错误： [CLI_ERROR]参数*的位置不正确:* [USE_ERROR]不支持的参数类型:key=*
新输出参数cli-output，cli-query，cli-output-num在使用时的注意事项有哪些？ 新输出参数的使用方法请参考：指定结果的输出格式。 命令中使用“--cli-query”用于传入JMESPath表达式，对结果执行JMESPath查询，方便提炼原返回结果中的
Explorer页面填写完成各项请求参数后，CLI示例会及时刷新命令内容。您可以将填写好请求参数的CLI示例保存，后续在KooCLI中直接调用，或集成到脚本中调用。 图1 在API Explorer上获取CLI示例 在API Explorer界面上，已填写值的参数，才会体现在CLI示例中。
提示不支持的cli-region时如何处理？ 问题背景 使用KooCLI调用所有云服务的API时，都需要提供合适的cli-region。如果您遇到如下几种情况： 命令中cli-region值输入有误； 命令指定了cli-region值，但目标API不支持该cli-region；
为什么会有新旧KooCLI系统参数，如cli-region与region，推荐使用哪个？ 问题背景 在KooCLI系统参数列表中，部分参数同时存在两种形式，如“--cli-region”和“--region”。其中，未添加“cli-”前缀的称为旧系统参数；添加了“cli-”前缀的
使用cli-jsonInput的场景有哪些？ 云服务的API参数名称中带有“.”，KooCLI可能无法正确解析该参数，此时需通过cli-jsonInput传入该API的参数； 云服务的API在不同位置中有同名的参数时，KooCLI无法正确解析该API的参数，此时需通过cli-jsonInput传入该API的参数；
如何使用cli-jsonInput？注意事项有哪些？ 问题背景 命令提示符（cmd.exe）等工具对使用时输入的字符串的最大长度有限制。当需要执行的命令的参数过多或参数值过长时，可能会因为其长度限制导致命令输入不完整。因此KooCLI除了支持参数在命令中直接输入之外，也支持使用“
提示重复的参数时如何处理？ 问题背景 KooCLI在命令执行过程中会对参数的合法性进行检查，若命令中存在重复参数，视具体场景不同，会提示不同错误，例如： [USE_ERROR]重复的参数:* [USE_ERROR]重复的参数*,如非误输,请以cli-*为key输入其中的KooCLI系统参数
若将该类参数配置到配置项中，会提示如下错误： [USE_ERROR]不正确的参数:* 配置于配置项后使用 / 命令中直接使用： 指该类参数既可以通过“hcloud configure set --key1=value1 --key2=value2 ...”命令配置到配置项后再使用，也可以通过“--key1=value1
KooCLI支持使用"--cli-sso-account-name"，"--cli-sso-permission-set-name"参数将帐号名、权限集名称配置到配置文件中，配置后进行sso登录时无需再次交互选择。 商用 配置账号名及权限集名称 2024年5月 序号 功能名称 功能描述 阶段 相关文档
当您使用默认版本信息的方式调用多版本云服务的API时，若您本地缓存的元数据文件被修改，可能会导致KooCLI在执行过程中无法根据缓存文件正确解析到该API的版本信息。在此情形下，会提示如下错误： [USE_ERROR]服务为多版本,请指定API版本号 解决方案 如遇如上情形，您可通过执行“hcloud
审计与日志 由于KooCLI是部署在用户本地的客户端工具，工具本身记录的日志可以作为审计目的使用，但是需要用户对日志进行访问权限控制以达到审计日志不可篡改的目的。此外， 同使用SDK一样，KooCLI将用户命令解析成https请求发送到API Gateway后，API Gateway记录的相关信息也可用作审计目的。
li-query”，“cli-output-num”，“cli-jsonInput”，“cli-endpoint”之外，其余选项支持被设置到配置项中。执行命令时，命令中的参数值优先于配置项中该参数值。 表1 KooCLI 选项列表 命令选项 说明 使用示例 help 选项 打印帮助信息
在线/离线模式分别适用什么场景？ 查看/切换当前模式 KooCLI支持在线/离线模式。默认为在线模式。添加配置项之后，您可以执行“hcloud configure list --cli-query=offline”命令查看当前是否已使用离线模式。 执行命令“hcloud configure
选项说明 选项概述 打印帮助信息 打印命令调用过程中的调试信息 生成JSON格式API入参骨架 检查命令正确性 指定区域 以无配置方式AKSK调用云服务API 指定用户所属账号ID 指定配置项 指定配置项的认证模式 指定结果的输出格式 以JSON文件的方式传递API参数 指定请求超时时间
元数据缓存文件存于何处？如何清理？ 通过KooCLI管理和使用您的各类云服务资源时，会远程获取您命令中目标云服务及其API的详情信息。为减少远程调用次数，提高响应速度，KooCLI引入了缓存机制，在运行过程中将云服务及其API的相关信息保存在本地缓存文件中，该文件称为元数据缓存文
认证方式优先级 KooCLI在命令解析过程中，依照如下优先级使用其认证方式，完成调用API时的认证流程： 无配置方式AKSK认证： 无配置方式AKSK：命令中直接输入访问密钥（永久AK/SK，即cli-access-key和cli-secret-key）或临时安全凭证（临时AK/
元数据管理 清理元数据缓存 KooCLI会缓存API调用过程中获取并保存在用户本地的元数据缓存文件，放置在如下目录下： 在线模式： Windows系统： C:\Users\{您的Windows系统用户名}\.hcloud\metaRepo\ Linux系统: /home/{当前用户名}/
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
