检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用“--cli-query”指定的JMESPath表达式不同，输出的结果中各参数的排列顺序可能不同。部分表达式的输出结果不会带有输出数据的属性名（即参数的key值），故用户需对输出数据的顺序有所把握，以便于数据处理。不同类型的JMESPath表达式，输出结果的顺序如下表所示： 表1 不同JMESPath表达式的数据输出顺序
参数可分为API参数和KooCLI系统参数。API参数是指云服务的API中定义的参数；系统参数是指KooCLI的内置参数，具有其固定的使用方式和特定含义。请查看系统参数列表。 选项 KooCLI选项是指可以直接在调用API的命令中添加的KooCLI系统参数，并非所有的系统参数都可作为选项使用。请查看选项列表。
提示不支持的operation时如何处理？ 问题背景 KooCLI调用云服务API的过程中，会对您输入参数的合法性进行校验。如果您命令中API的operation输入有误，或该API未在KooCLI上线，会提示如下错误： [USE_ERROR]不支持的operation: * 解决步骤
交互式中提示云服务和系统命令列表 所提示的云服务列表中，左列展示云服务短名/系统命令，右列展示该云服务的服务名称/该系统命令的描述信息。 API 已输入的云服务/系统命令经校验无误后，会继续提示该服务的API列表/该系统命令的子命令（或参数）。 所提示的系统命令列表中，左列展示该系统命令的子命令（或参数）
中获取的cli-region。 会提示如下错误： [USE_ERROR]cli-region的值不支持,当前支持的区域值如下:* [USE_ERROR]当前配置项中cli-region的值不支持,当前支持的区域值如下：* 解决步骤 如遇如上情形时，请您参考该提示信息中支持的cli
据已有命令提示其待补全的内容。 发布区域：全部 自动补全 交互式提示 KooCLI支持功能强大的多平台支持的交互式提示，方便命令构建，在命令中添加“--interactive”参数即可进入交互式提示。交互式中根据用户当前输入的内容，提示云服务名称，API的operation，参数
提示不正确的参数时如何处理？ 问题背景 通过KooCLI管理和使用您的各类云服务资源时，在调用云服务API的过程中，会对您输入参数的合法性进行校验。若您在命令中输入了当前API不支持的参数，或将只允许配置在配置项中使用的参数在命令直接传入，会提示如下错误： [USE_ERROR]不正确的参数:*
命令中直接使用 cli-output 响应数据的输出格式[json|table|tsv] 命令中直接使用 cli-query 筛选响应数据的JMESPath路径 命令中直接使用 cli-output-num table输出时，是否打印表格的行号。取值为true或false，默认为true
云服务API的body位置参数值如何置空？ 对于云服务API的body位置的参数，KooCLI支持在任意层级置空： 若当前层级的值实际类型为map，则置空时参数值应为“{}”。 若当前层级的值实际类型为数组，则置空时参数值应为“[]”。 以云服务“ECS”的operation“B
SSO登录 KooCLI的SSO登录命令通过完成SSO登录，将用户的认证信息存储在配置文件中，避免执行操作时频繁输入这些固定信息。可通过如下命令进行SSO登录： hcloud configure sso 输入以上命令并回车后，会逐步提示您输入SSO profile name（此S
在Windows系统上安装KooCLI 点此下载适配Windows系统的KooCLI。 解压后得到hcloud.exe文件，如下图所示。 图1 在Windows系统下载并解压后的hcloud.exe文件 （可选）将KooCLI所在目录加入到系统环境变量Path中，方便在cmd窗口的任意目录下使用hcloud命令。 Windows
KooCLI与输出相关的系统参数有哪些，推荐使用哪些？ KooCLI与输出相关的参数如下： 表1 KooCLI与输出相关的参数 参数分组 参数 参数用途 新输出参数 cli-output，cli-query，cli-output-num cli-output 响应数据的输出格式，取值可以为如下其一：
--cli-offline=false”可切换至在线模式。 离线模式适用场景 可将KooCLI最新的离线元数据打包下载到用户本地，该元数据缓存文件长期有效。后续执行KooCLI命令时将读取文件内容完成命令校验及解析。此模式下，已打包下载的元数据缓存文件不会自动更新，故不会因元数据文件内容修改，导致已有命令中
-num在使用时的注意事项有哪些？ 新输出参数的使用方法请参考：指定结果的输出格式。 命令中使用“--cli-query”用于传入JMESPath表达式，对结果执行JMESPath查询，方便提炼原返回结果中的关键信息；“--cli-output”用于指定响应数据的输出格式；“--
本节以Windows系统为例介绍KooCLI的使用，Linux和MacOS系统的使用基本相同，可参考。 KooCLI最基础的入门操作包括：快速安装、初始化配置信息，查看与执行云服务操作命令。 图1为KooCLI大致的入门流程，本入门指导旨在帮助您对其操作有初步的认识。 图1 入门流程 注册华为
--cli-retry-count=3 需要注意的是，因为使用“--cli-retry-count”设置重试次数可能会导致调用接口幂等性的问题，有重复调用的风险。对于创建类的接口，请您谨慎使用。 修改指定配置项的跳过https请求证书验证选项的值 hcloud configure set
PI中存在与新系统参数或旧系统参数重名的参数，被写入jsonInput文件中的默认将被识别为该API的参数； “--cli-jsonInput”选项传入的JSON文件中，KooCLI会根据JSON最外层的Key获取并解析其的参数值，目前支持的Key包括：path、query、bo
} 以table输出调用结果时，“--cli-output-rows”指定json结构体的层级，即表格的数据来源；“--cli-output-cols”指定表格的列名，需要与json结构体中的字段相对应；“--cli-output-num”指定是否打印表格行号，默认值为true，如下图所示:
[CLI_ERROR]：一般是因KooCLI处理命令过程中本身的异常导致的错误，请联系KooCLI的oncall协助处理； [USE_ERROR]：一般是因命令中参数不正确造成的错误，请根据错误提示做相应修改； [OPENAPI_ERROR]：一般是调用云服务API时发生的错误，请联系相关云服务oncall协助处理；
使用中的实际需要判断该参数是否需要加密保存。对于需要加密保存的custom参数，为保障您的参数安全，对您输入的参数值进行了匿名化处理。在您输入过程中不会显示输入的字符，在输入结束回车至下一行时，会以“****”回显您的输入内容。 使用custom参数的方法是将命令中原参数的value值用“custom
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
