检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
http_proxy="http://username:password@proxyServer:port" 其中，proxyServer为代理服务器的域名（如果能解析）或者IP。port为端口号。如果你的代理服务器需要用户名和密码才能访问，需要填写上面的username和password部分，否则的话，可以省略这两部分，如下：
“cli-query”，“cli-output-num”，“cli-jsonInput”，“cli-endpoint”之外，其余选项支持被设置到配置项中。执行命令时，命令中的参数值优先于配置项中该参数值。 表1 KooCLI 选项列表 命令选项 说明 使用示例 help 选项 打印帮助信息
无配置方式ecsAgency 在用户已成功建立向弹性云（ECS）服务器的委托的前提下，在ECS服务器中使用KooCLI时，可以在命令中指定“--cli-mode=ecsAgency”，KooCLI将基于ECS委托，自动获取临时的AK/SK和SecurityToken用于认证。 此
设置配置项中的系统参数 设置配置项中的系统参数的示例如下： 增加配置项 新增配置项时，以“--cli-profile”声明配置项的名称，示例如下： 新增认证模式为AK/SK的配置项，其中认证参数为访问密钥，即永久AK（cli-access-key）和SK（cli-secret-key）：
认证方式优先级 KooCLI在命令解析过程中，依照如下优先级使用其认证方式，完成调用API时的认证流程： 无配置方式AKSK认证： 无配置方式AKSK：命令中直接输入访问密钥（永久AK/SK，即cli-access-key和cli-secret-key）或临时安全凭证（临时AK/
参数“--cli-custom”的取值可标识向配置项中设置的参数类型：当“--cli-custom=false”时，设置其中的系统参数；当“--cli-custom=true”时，设置其中的custom（即用户自定义）参数。 设置配置项中的系统参数时，若该配置项不存在则新增配置项，否则修改该配置项。
使用cli-jsonInput的场景有哪些？ 云服务的API参数名称中带有“.”，KooCLI可能无法正确解析该参数，此时需通过cli-jsonInput传入该API的参数； 云服务的API在不同位置中有同名的参数时，KooCLI无法正确解析该API的参数，此时需通过cli-jsonInput传入该API的参数；
步骤四：查看与执行云服务操作命令 本节以Windows系统为例介绍KooCLI的使用，Linux和Mac系统的使用基本相同，可参考。 完成初始化配置后，即可查询KooCLI支持的云服务列表，并执行相关命令。下文以弹性云服务器（ECS）的查询云服务器详情的API为例，说明如何查找与执行命令。
支持ECS服务器委托认证 2021年9月 序号 功能名称 功能描述 阶段 相关文档 1 新特性 KooCLI版本：2.3.14 支持设置和使用custom（即用户自定义）参数。 商用 设置和使用custom参数 2 功能优化 KooCLI版本：2.3.14 修复参数取值范围只给出最小值时校验错误的问题。
获取账号ID、项目ID 在调用云服务API的时候，大多数场景需要填入项目ID。项目ID获取步骤如下： 注册并登录管理控制台。 单击右上角用户名，在下拉列表中单击“我的凭证”，查看“账号ID（cli-domain-id）”、“项目ID（cli-project-id）”，如下图。 项
无配置方式使用KooCLI需要注意什么？ 无配置方式使用是指在使用KooCLI时不通过已有配置项传入当前用户的认证信息，而是直接在命令中传入当前用户认证相关的参数。此方式可使用户免于添加配置项，方便快捷。具体使用方式请参考：无配置方式使用KooCLI。 无配置方式使用KooCLI时，需要注意如下事项：
系统参数都可作为选项使用。请查看选项列表。 元数据 KooCLI在命令执行过程中需要获取云服务及其API的详情信息，用于命令中参数的校验及解析，该数据称为元数据。远程获取的元数据会被保存在用户本地供后续使用，以减少命令执行过程中的网络IO，提高命令响应速度，保存元数据的文件称为元
日志可以作为审计目的使用，但是需要用户对日志进行访问权限控制以达到审计日志不可篡改的目的。此外， 同使用SDK一样，KooCLI将用户命令解析成https请求发送到API Gateway后，API Gateway记录的相关信息也可用作审计目的。 详情请见日志管理。 父主题： 安全
-cli-jsonInput=${jsonFileName}”传入JSON文件，向KooCLI传递云服务API参数。KooCLI会在运行时解析并使用该JSON文件中的参数调用目标API。 使用方式 cli-jsonInput的使用方式请参考：以JSON文件的方式传递API参数。 注意事项
中包括每个参数的类型、在request中的位置等信息。若您本地缓存的元数据文件被修改，可能会使KooCLI在运行过程中无法根据缓存文件正确解析到该API的参数详情，导致校验时提示如下错误： [CLI_ERROR]参数*的位置不正确:* [USE_ERROR]不支持的参数类型:key=*
如您的错误提示信息是英文，说明您此前已在配置中将KooCLI语言设置为英文，或KooCLI判断您的系统语言为英文。目前英文环境下KooCLI中云服务的各API支持的cli-region与中文环境存在差异。若您要将语言设置为中文，您可以通过执行“hcloud configure set
缓存清理成功 离线模式： 执行命令“hcloud meta clear”，会清理从已下载的离线元数据包中解析出来的元数据缓存文件，离线元数据包仍然保留。之后调用API时，会重新从该离线元数据包中解析并写入新元数据缓存文件。若需完全清理离线元数据包及元数据缓存文件，用户需根据系统，删除该文件所在目录。
离线模式适用场景 可将KooCLI最新的离线元数据打包下载到用户本地，该元数据缓存文件长期有效。后续执行KooCLI命令时将读取文件内容完成命令校验及解析。此模式下，已打包下载的元数据缓存文件不会自动更新，故不会因元数据文件内容修改，导致已有命令中参数校验不通过而报错。可保证KooCLI命令
离线模式： 执行命令“hcloud meta clear”，会清理从已下载的离线元数据包中解析出来的元数据缓存文件，离线元数据包仍然保留。之后调用API时，会重新从该离线元数据包中解析并写入新元数据缓存文件。 父主题： 元数据缓存相关
设置配置项中的custom参数 KooCLI支持向配置项中设置custom参数，方便用户集中管理命令中高频使用，参数值过长，或需要对其值加密处理的参数。使用如下命令进入交互模式，根据提示新增或修改配置项中的custom参数： hcloud configure set [--cli
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
