检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
在Linux系统上安装KooCLI KooCLI支持Linux AMD 64位 和 ARM 64位操作系统,您可以根据需要选择一键式安装或分步安装。分步安装时请根据您的操作系统选择相应的安装命令。执行如下命令可查看您主机的操作系统: echo $HOSTTYPE 若执行如上命令的输出值是“x86_64”,请使用AMD
在MacOS系统上安装KooCLI KooCLI支持MacOS AMD 64位 和 ARM 64位操作系统,您可以根据需要选择一键式安装或分步安装。分步安装时请根据您的操作系统选择相应的安装命令。执行如下命令查看您主机的操作系统: echo $HOSTTYPE 若执行如上命令的输出值是“x86_64”,请使用AMD
在Windows系统上安装KooCLI 点此下载适配Windows系统的KooCLI。 解压后得到hcloud.exe文件,如下图所示。 图1 在Windows系统下载并解压后的hcloud.exe文件 (可选)将KooCLI所在目录加入到系统环境变量Path中,方便在cmd窗口的任意目录下使用hcloud命令。
查询指定配置项中的系统参数 使用“--cli-profile”指定要查询的配置项的名称,缺省时查询默认配置项。支持以table,json或tsv格式输出,默认以json格式输出。查看指定配置项中的系统参数的命令为: hcloud configure show [--cli-pro
因此,当您构建KooCLI命令时,对于其中的系统参数,为避免出现参数冲突而引起错误或交互,推荐使用新系统参数。 新增系统参数将添加至新系统参数列表中。旧系统参数将仅维持其已有功能,不再持续升级。 旧系统参数 KooCLI旧系统参数的描述信息及其对应的新系统参数如下表所示: 表1 KooCLI旧系统参数 旧系统参数 参数描述
用户在使用KooCLI管理和使用云服务的资源时,可能会因为用户所在公司的内网访问限制,导致调用云服务API失败。此时,用户可使用HTTP代理访问。使用HTTP代理需要配置环境变量http_proxy和https_proxy。 配置http_proxy环境变量 请根据您系统选择并执行如下命令,配置http_proxy环境变量。
标左键单击“CLI示例”方框中的图标按钮即可启动。 图1 在API Explorer上启动在线体验功能 启动时会自动为您分配一个Linux系统的容器(以下称之为实例)供您使用,该实例上已预装最新版的KooCLI。在线体验功能具有以下优点: 实例启动后默认将当前CLI示例内容复制到实例窗口并执行。
--help”命令,查看当前支持的所有云服务,确认服务名称是否有误; 如您确认服务名无误,但是上一步执行“hcloud --help”命令的输出结果中,“可用服务”列表中不存在该云服务,可能是因为如下原因: 若您已使用在线模式,则该云服务未在KooCLI上线; 若您已使用离线模式
如命令中含有特殊字符,如&、<、>以及空格等,则需要加引号转义(macOS/Linux操作系统使用单引号,Windows操作系统使用双引号)。 您可以通过下表了解KooCLI支持的所有OBS操作命令,各命令的参数与obsutil一致,参数详情可参考OBS服务桶相关命令,对象相关命令,辅助命令相关章节。 表2 KooCLI支持的所有OBS操作命令
cli-security-token:临时安全凭证。在使用临时AK/SK认证身份时,需同时使用此参数。 可用于以无配置方式AKSK调用云服务API。 以无配置方式AKSK调用云服务API: 使用访问密钥(永久AK/SK): hcloud RDS ListApiVersion --cli-region="cn-north-4"
步骤二:快速安装 概述 在Windows系统上安装KooCLI 在Linux系统上安装KooCLI 在MacOS系统上安装KooCLI 在Docker中配置和使用KooCLI
参数相关 KooCLI系统参数包括哪些? 提示不正确的参数时如何处理? 为什么会有新旧KooCLI系统参数,如cli-region与region,推荐使用哪个? 提示重复的参数时如何处理? 如何使用cli-jsonInput?注意事项有哪些? 使用cli-jsonInput的场景有哪些?
参数可分为API参数和KooCLI系统参数。API参数是指云服务的API中定义的参数;系统参数是指KooCLI的内置参数,具有其固定的使用方式和特定含义。请查看系统参数列表。 选项 KooCLI选项是指可以直接在调用API的命令中添加的KooCLI系统参数,并非所有的系统参数都可作为选项使用。请查看选项列表。
交互式可提示和补全如下内容: 云服务 初次进入交互模式后,会自动提示云服务及系统命令列表。 图1 交互式中提示云服务和系统命令列表 所提示的云服务列表中,左列展示云服务短名/系统命令,右列展示该云服务的服务名称/该系统命令的描述信息。 API 已输入的云服务/系统命令经校验无误后,会继续提示该服务的API列表/该系统命令的子命令(或参数)。
configure delete --cli-profile=test 删除配置项test成功,默认配置项为default 删除配置项时,会同时删除其中的系统参数和custom参数。 父主题: 删除指定配置项
持两种参数名,是因为在KooCLI上开放的云服务中,存在部分API的某参数与系统参数重名的情况。 解决方案 若提示的错误信息为上述第一种,则命令中可能存在重复的非系统参数,请您检查是否误输。此错误也可能与系统解析处理命令内容有关,若参数值有特殊符号,请使用双引号引起,避免解析错误。
输出格式相关 KooCLI支持的输出格式有哪些? 如何定义JMESPath表达式 KooCLI与输出相关的系统参数有哪些,推荐使用哪些? 新输出参数cli-output,cli-query,cli-output-num在使用时的注意事项有哪些? 旧输出参数cli-output-r
run”时仅支持KooCLI相关命令。 创建临时容器,向容器共享宿主机文件(以Linux系统的宿主机为例),并执行命令: 通过宿主机系统目录和容器目录的挂载,将宿主机文件共享到容器: 示例1:通过将宿主机系统的/root/.hcloud/目录挂载到容器的/root/.hcloud/目录下,将宿主机配置文件共享到容器:
查询当前版本 版本更新 日志管理 模板管理 常用选项 配置项管理 配置项用于存储一组调用云服务API时所需的公共信息,由用户通过调用KooCLI命令完成配置。各配置项组成配置文件,存储在用户本地。用户在调用云服务API时,可通过指定配置项,代替这组公共信息的输入。 KooCLI配置命令包含初始化配置、配置项的增删改查等。
KooCLI系统参数包括哪些? 系统参数 KooCLI系统参数是指其内置参数,各系统参数的描述信息及其使用方式如下表所示: 表1 KooCLI新系统参数 参数 参数描述 使用方式 help 打印帮助信息 命令中直接使用 debug 打印调试信息 命令中直接使用 dryrun 执行校验后打印请求报文