检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
8及以后的版本在首次使用时,请您根据交互提示信息,选择是否同意其互联网连接及隐私政策声明。 对于不方便交互的场景,如以自动化脚本执行KooCLI命令,可通过如下命令,配置同意隐私声明: hcloud configure set --cli-agree-privacy-statement=true
打印命令调用过程中的调试信息 KooCLI支持打印命令执行过程中的调试信息。在命令中添加“--debug”即可: hcloud VPC ShowVpc/v3 --cli-region="cn-north-4" --project_id="0dd8cb****************19b5a84546"
认证方式优先级 KooCLI在命令解析过程中,依照如下优先级使用其认证方式,完成调用API时的认证流程: 无配置方式AKSK认证: 无配置方式AKSK:命令中直接输入访问密钥(永久AK/SK,即cli-access-key和cli-secret-key)或临时安全凭证(临时AK/
检查命令正确性 dryrun选项用于检查所传入命令的正确性。在命令中添加“--dryrun”选项,执行校验后打印请求报文,跳过实际运行,不调用目标API: hcloud RDS CreateConfiguration --cli-region="cn-north-4" --pro
e} --cli-region=${regionValue}”命令将其配置到目标配置项中。后续使用该配置项调用API时,命令中可以不必输入cli-region;但若目标API不支持该cli-region,则您仍需在命令中通过“--cli-region=${regionValue}”传入支持的cli-region。
期有效。后续执行KooCLI命令时将读取文件内容完成命令校验及解析。此模式下,已打包下载的元数据缓存文件不会自动更新,故不会因元数据文件内容修改,导致已有命令中参数校验不通过而报错。可保证KooCLI命令一旦构建,长期可用。适用于用户以KooCLI命令构建固定脚本并定期执行,管理云服务和云资源的场景。
指定区域 KooCLI除了可以从配置项读取区域信息外,还可以在命令中传入cli-region值,如下: hcloud EVS DeleteVolume --cli-region="cn-north-4" --volume_id="aed9****-****-****-****-****0e3219cf"
<service> --help”命令获取。 配置项 配置项用于存储一组调用云服务API时所需的公共信息,由用户通过调用KooCLI命令完成配置。各配置项组成配置文件,存储在用户本地。用户在调用云服务API时,可通过指定配置项,代替这组公共信息的输入。 配置项支持配置的公共信息包括:访问密钥
环境配置请参考快速初始化配置。 获取云服务API调用命令。 获取云服务API调用命令有两种方式: (推荐)API Explorer上获取 云服务的API可在API Explorer上查看。您可以在API Explorer上先填写好各参数的值,即可从“CLI示例”页签中直接获取命令。 KooCLI帮助信息查询
快速安装。 使用KooCLI时,需要获取调用者的身份信息用以认证鉴权。如您不是以无配置方式使用,那么您需要先配置相关的认证信息,具体配置方法请参见步骤三:初始化配置。 完成配置后,即可使用KooCLI管理和使用您的各类云服务资源,方法请参见步骤四:查看与执行云服务操作命令。
KooCLI支持本地更新, 运行更新命令经交互确认后可将其升级至最新版本。 更新命令如下: hcloud update hcloud update KooCLI将更新到最新版本,请您确认是否继续(y/N): y 更新成功 执行版本更新命令时,在命令中添加“-y”参数,可跳过交互确认,直接更新:
t”,“cli-endpoint”之外,其余选项支持被设置到配置项中。执行命令时,命令中的参数值优先于配置项中该参数值。 表1 KooCLI 选项列表 命令选项 说明 使用示例 help 选项 打印帮助信息 hcloud RDS ListCollations --cli-region="cn-north-1"
KooCLI开启自动补全后,在输入命令时使用“Tab”键,会根据已有命令提示其待补全的内容。 开启自动补全功能: hcloud auto-complete on hcloud auto-complete on 开启成功!自动补全仅支持bash,若未生效请执行`bash`命令 关闭自动补全功能:
常用命令 查看帮助信息 自动补全 交互式提示 元数据管理 查询当前版本 版本更新 日志管理 模板管理 管理OBS中的数据
查询当前版本 查询KooCLI当前版本的命令为: hcloud version hcloud version 当前KooCLI版本:3.2.8 父主题: 常用命令
验。若您在命令中输入了当前API不支持的参数,或将只允许配置在配置项中使用的参数在命令直接传入,会提示如下错误: [USE_ERROR]不正确的参数:* 解决步骤 如遇如上情形,您可以通过执行“hcloud <service> <operation> --help”命令,对比输出
过指定配置项,代替这组公共信息的输入。 KooCLI配置命令包含初始化配置、配置项的增删改查等。 发布区域:全部 初始化配置 新增或修改配置项 查询配置项列表 查询指定配置项 删除指定配置项 检查配置文件格式 删除所有配置项 自动补全 KooCLI开启自动补全后,在输入命令时使用
查看帮助信息 KooCLI支持在命令中添加“--help”参数查看帮助信息,例如: hcloud --help 查看KooCLI的使用方法及支持的云服务列表。 hcloud <service> --help 查看指定云服务的operation列表。例如查看“ECS”服务的operation列表:hcloud
如何卸载KooCLI? KooCLI无需安装,下载解压后即可使用。因此您在卸载时仅需要删除该工具及相关本地缓存文件即可。请参考如下步骤: 执行“hcloud auto-complete off”命令关闭自动补全; 删除缓存文件,配置文件及日志文件: Linux系统: /home/{当前用户名}/
跳过https请求证书验证(不建议)。当用户已配置HTTP代理,KooCLI调用云服务的API时,可能会因证书校验失败,导致请求报错x509。用户可在命令中添加“--cli-skip-secure-verify=true”后执行原命令,在执行时会向用户交互以确认是否跳过https请求证书验证: