检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
auto-complete on 开启成功!自动补全仅支持bash,若未生效请执行`bash`命令 关闭自动补全功能: hcloud auto-complete off hcloud auto-complete off 关闭成功!若未生效请执行`bash`命令 自动补全功能仅支持bash。 自动补全提
值,填写完成后单击“切换为文本输入”,如下图所示,复制文本框中转为JSON格式的参数内容,将其粘贴在原始JSON文件的“body”Key之后,覆盖原“body”Key后对应的大括号; 图1 获取用于cli-jsonInput文件的body位置参数 各位置的参数填写完成后,若某个位
安装华为云命令行工具服务(KooCLI)后,入门操作包括:注册华为账号并获取访问密钥、初始化配置信息,查看与执行云服务操作命令。 入门流程 注册华为账号并获取访问密钥 初始化配置信息 查看与执行云服务操作命令 05 在线体验 华为云命令行工具服务(KooCLI)在线体验功能内嵌于华为云API
Explorer上查看。您可以在API Explorer上先填写好各参数的值,即可从“CLI示例”页签中直接获取命令。 KooCLI帮助信息查询 具体查询方法可参考查看与执行云服务操作命令,Mac和Linux系统下查询方法类似。 通过KooCLI调用云服务API。 输入完整的API调用命令后回车,即完成调用。
数都可作为选项使用。请查看选项列表。 元数据 KooCLI在命令执行过程中需要获取云服务及其API的详情信息,用于命令中参数的校验及解析,该数据称为元数据。远程获取的元数据会被保存在用户本地供后续使用,以减少命令执行过程中的网络IO,提高命令响应速度,保存元数据的文件称为元数据缓存文件。请查看如何管理元数据缓存文件。
hcloud/metaOrigin/ 如何清理元数据缓存文件 在线模式: 清理缓存文件时执行命令“hcloud meta clear”即可。元数据缓存文件清理后,调用API时会重新获取并写入新文件。 离线模式: 执行命令“hcloud meta clear”,会清理从已下载的离线元数据包中解
地缓存的元数据文件被修改,可能会导致KooCLI在执行过程中无法根据缓存文件正确解析到该API的版本信息。在此情形下,会提示如下错误: [USE_ERROR]服务为多版本,请指定API版本号 解决方案 如遇如上情形,您可通过执行“hcloud meta clear”命令清理当前的元数据缓存文件后,重新调用。
n结构体的名称时,各层级之间以“.”分隔,目标json结构体的内容必须为数组类型,KooCLI会将该json结构体的内容以表格化输出。例如执行命令“hcloud configure list --cli-output-rows=profiles”,会以表格输出所有配置项信息。若“
云服务API相关 提示不支持的operation时如何处理? 如何指定云服务的API和版本号? 云服务API的响应体为空时,如何判断命令是否执行成功?
--cli-offline=true 修改是否提示Warning信息 是否提示Warning信息修改后,将作用于所有配置项。以自动化脚本执行命令时,关闭Warning提示信息,可以避免干扰解析命令执行的输出结果。关闭Warning信息的命令为: hcloud configure set --cli-warning=false
configure set`配置cli-domain-id 解决方案 如果您在命令中通过“--cli-profile”选项指定了配置项,您可先执行“hcloud configure show --cli-profile=${profileName}”命令查看该配置项的具体内容,确认您指定的配置项是否合适;
[CLI_ERROR]参数*的位置不正确:* [USE_ERROR]不支持的参数类型:key=*,type=* 解决方案 如遇如上情况,您可执行“hcloud meta clear”命令清理当前的元数据缓存文件后,重新调用。 父主题: 参数相关
KooCLI提供由多条KooCLI命令组合而成的shell脚本模板,方便用户理清业务逻辑,完成复杂场景下的操作。用户可根据实际需要下载相应的模板,修改后执行即可。 发布区域:全部 模板管理 常用选项 KooCLI选项是指可以直接在调用API的命令中添加的KooCLI系统参数。 发布区域:全部 打印帮助信息
KooCLI新系统参数 参数 参数描述 使用方式 help 打印帮助信息 命令中直接使用 debug 打印调试信息 命令中直接使用 dryrun 执行校验后打印请求报文,跳过实际运行 命令中直接使用 interactive 进入交互式模式 命令中直接使用 cli-region 区域 配置于配置项后使用
清理元数据缓存文件的命令为: 在线模式: hcloud meta clear hcloud meta clear 缓存清理成功 离线模式: 执行命令“hcloud meta clear”,会清理从已下载的离线元数据包中解析出来的元数据缓存文件,离线元数据包仍然保留。之后调用API时
概述 针对不同的环境,您可以参考如下方式完成快速安装: 在Windows系统上安装KooCLI 在Linux系统上安装KooCLI 在MacOS系统上安装KooCLI 在Docker中配置和使用KooCLI 您也可以从下表中直接下载适配您目标系统的KooCLI到本地,再将其上传至您的目标机器,解压后即可使用:
PI的某参数与旧系统参数重名的情况。该场景可能会使命令中两个同名的参数用于不同的用途,即:其一作为目标API参数,另一作为系统参数。在命令执行过程中会对参数的合法性进行检查,若命令中存在重复参数,则会提示如下错误: [USE_ERROR]重复的参数*,如非误输,请以'cli-*'为key输入其中的KooCLI系统参数
cli-output-num table输出时,是否打印行号。取值为:true或者false cli-json-filter json输出时,对json结果执行JMESPath查询 与旧输出参数相比,新输出参数不仅新增了支持除table,json两种输出格式外的tsv输出格式,同时也使输出参数得以统一,方便用户使用。
ry”,“cli-output-num”,“cli-jsonInput”,“cli-endpoint”之外,其余选项支持被设置到配置项中。执行命令时,命令中的参数值优先于配置项中该参数值。 表1 KooCLI 选项列表 命令选项 说明 使用示例 help 选项 打印帮助信息 hcloud
示的参数名中有“{*}”,其含义为自定义参数名称,请使用任意不含“.”的字符串代替该字符。 切换至新命令行后可使用向上箭头和向下箭头浏览已执行命令的历史记录。 父主题: 常用命令