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