检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
步骤四：查看与执行云服务操作命令 本节以Windows系统为例介绍KooCLI的使用，Linux和Mac系统的使用基本相同，可参考。 完成初始化配置后，即可查询KooCLI支持的云服务列表，并执行相关命令。下文以弹性云服务器（ECS）的查询云服务器详情的API为例，说明如何查找与执行命令。
KooCLI系统参数包括哪些？ 系统参数 KooCLI系统参数是指其内置参数，各系统参数的描述信息及其使用方式如下表所示： 表1 KooCLI新系统参数 参数 参数描述 使用方式 help 打印帮助信息 命令中直接使用 debug 打印调试信息 命令中直接使用 dryrun 执行校验后打印请求报文
修改已初始化的配置项 KooCLI目前支持在配置项中以如下组合方式配置认证参数：访问密钥（永久AK/SK），临时安全凭证（临时AK/SK和SecurityToken）两种。 其中，临时安全凭证（临时AK/SK和SecurityToken）具有时效性。 初始化配置信息时，配置项的名
元数据管理 清理元数据缓存 KooCLI会缓存API调用过程中获取并保存在用户本地的元数据缓存文件，放置在如下目录下： 在线模式： Windows系统： C:\Users\{您的Windows系统用户名}\.hcloud\metaRepo\ Linux系统: /home/{当前用户名}/
指定配置项的认证模式 KooCLI的配置项的认证模式取值为AKSK、ecsAgency，推荐使用AKSK。当使用的配置项同时配置了多种认证模式相关的参数，用户可使用“--cli-mode”选项来指定配置项的认证模式： hcloud CCE ListNodes --cluster_
生成JSON格式API入参骨架 skeleton选项用于生成JSON格式API入参骨架。在命令中添加“--skeleton”选项，则在当前目录生成该API的JSON格式的入参文件，用户可填写文件中的参数值，以“--cli-jsonInput=${JSON文件名}”传入参数，调用API：
指定结果的输出格式 命令中使用“--cli-query”传入JMESPath表达式，对结果执行JMESPath查询，方便提炼原返回结果中的关键信息；“--cli-output”指定响应数据的输出格式；“--cli-output-num”指定当使用table格式输出时，是否打印行号。
日志文件存于何处？ KooCLI会记录您使用过程中产生的日志信息。日志记录功能暂不支持关闭。 日志文件名称为“hcloud.log”，日志文件的存放位置如下： Linux系统：/home/{当前用户名}/.hcloud/log/ Windows系统：C:\Users\{当前用户名}\
时存在两种形式，如“--cli-region”和“--region”。之所以同一系统参数同时支持两种参数名，是因为在KooCLI上开放的云服务中，存在部分API的某参数与系统参数重名的情况。 解决方案 若提示的错误信息为上述第一种，则命令中可能存在重复的非系统参数，请您检查是否误
检查配置文件格式 为快速检验本地配置文件的格式是否正确，可执行如下命令： hcloud configure test hcloud configure test 配置文件格式正确 父主题： 配置信息管理
以JSON文件的方式传递API参数 KooCLI调用云服务的API时，如果API的参数过多，不便直接在命令中传入，用户可通过“--cli-jsonInput”将云服务API的部分或全部参数以JSON文件的形式输入。剩余的其他参数，例如KooCLI系统参数、未通过JSON文件传入的云服务API参数等，仍可在命令中传入，例如：
无配置方式AKSK 访问密钥（永久AK/SK） 用户可以在命令中直接输入永久AK（cli-access-key）和SK（cli-secret-key）调用云服务API： hcloud ECS NovaListServers --cli-region="cn-north-4" --project_i
使用cli-jsonInput的场景有哪些？ 云服务的API参数名称中带有“.”，KooCLI可能无法正确解析该参数，此时需通过cli-jsonInput传入该API的参数； 云服务的API在不同位置中有同名的参数时，KooCLI无法正确解析该API的参数，此时需通过cli-jsonInput传入该API的参数；
无配置方式ecsAgency 此认证方式仅支持在弹性云服务器中使用KooCLI的场景。 用户必须已在IAM对该弹性云服务器进行云服务委托授权，并在相应的弹性云服务器的详情页面“管理信息 > 委托”栏目中添加向弹性云（ECS）服务器的委托。详细操作请参考委托其他云服务管理资源。 父主题： 其他
获取临时AK/SK和securitytoken 临时AK/SK和securitytoken是系统颁发给IAM用户的临时访问令牌，有效期可在15分钟至24小时范围内设置，过期后需要重新获取。临时AK/SK和securitytoken遵循权限最小化原则。请参见获取临时AK/SK和securitytoken。
云服务API的body位置参数值如何置空？ 对于云服务API的body位置的参数，KooCLI支持在任意层级置空： 若当前层级的值实际类型为map，则置空时参数值应为“{}”。 若当前层级的值实际类型为数组，则置空时参数值应为“[]”。 以云服务“ECS”的operation“B
查询指定配置项 查询指定配置项中的系统参数 查询指定配置项中的custom参数 父主题： 配置信息管理
删除指定配置项 删除指定配置项及其custom参数 删除指定配置项中的custom参数 父主题： 配置信息管理
删除所有配置项 可执行如下命令，经交互确认后即可删除所有配置项： hcloud configure clear hcloud configure clear 是否删除所有配置信息(y/N): y 已删除所有配置信息 父主题： 配置信息管理
如何指定云服务的API和版本号？ 问题背景 KooCLI调用云服务API的过程中，会对您输入参数的合法性进行校验。若您当前调用的云服务是多版本服务，即意味着该服务中的部分或全部API有多个版本。因同一API不同版本的参数、使用场景等可能存在差异，故须获取多版本服务API的版本信息。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
