检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
其他 无配置方式使用KooCLI需要注意什么? 命令中服务名、operation、参数的value值是否需要使用双引号引起? 在线/离线模式分别适用什么场景? 如何卸载KooCLI?
交互式/自动补全相关 使用交互式/自动补全需要注意什么?
输出格式相关 KooCLI支持的输出格式有哪些? 如何定义JMESPath表达式 KooCLI与输出相关的系统参数有哪些,推荐使用哪些? 新输出参数cli-output,cli-query,cli-output-num在使用时的注意事项有哪些? 旧输出参数cli-output-r
步骤二:快速安装 概述 在Windows系统上安装KooCLI 在Linux系统上安装KooCLI 在MacOS系统上安装KooCLI 在Docker中配置和使用KooCLI
NovaAttachVolume NovaShowServerMetadata ... 命令执行时,会使用您配置的认证信息执行请求,部分接口调用涉及云产品计费,请谨慎操作。 云服务支持的operation,也可在API Explorer界面查找。 可使用“hcloud
在此校验过程中,KooCLI会获取该API中所有参数的详情信息,其中包括每个参数的类型、在request中的位置等信息。若您本地缓存的元数据文件被修改,可能会使KooCLI在运行过程中无法根据缓存文件正确解析到该API的参数详情,导致校验时提示如下错误: [CLI_ERROR]参数*的位置不正确:*
Key”进行了匿名化处理。在您输入过程中不会显示输入的字符,在输入结束回车至下一行时,会以“*”回显您的输入内容。在配置完成后,KooCLI会在本地加密保存配置项中的认证相关的敏感信息。 如果重新执行初始化命令,则会在删除原配置文件后重新生成新的配置文件,配置文件保存地址如下: Windows系统: C:\
对于非body位置的参数,请在原始JSON文件对应Key的大括号中,以"参数名称":"参数值"的格式成对填入各参数及其值,同一大括号中每对数据之间以","隔开,最后一对数据与“}”之间不需要再加","; 对于body位置的参数,在API Explorer页面填写其“Body”中各参数的值,
cli-domain-id project-id 项目ID cli-project-id profile 指定配置项 cli-profile mode 认证模式[AKSK|ecsAgency] cli-mode jsonInput 通过JSON文件方式传入API参数 cli-jsonInput
id=value1 ... --project_id required string path 项目ID。若命令中未输入,将根据认证信息获取指定区域的父级项目ID,或使用当前配置项中的cli-project-id --os-stop.type optional
式。 离线模式适用场景 可将KooCLI最新的离线元数据打包下载到用户本地,该元数据缓存文件长期有效。后续执行KooCLI命令时将读取文件内容完成命令校验及解析。此模式下,已打包下载的元数据缓存文件不会自动更新,故不会因元数据文件内容修改,导致已有命令中参数校验不通过而报错。可保
元数据 KooCLI在命令执行过程中需要获取云服务及其API的详情信息,用于命令中参数的校验及解析,该数据称为元数据。远程获取的元数据会被保存在用户本地供后续使用,以减少命令执行过程中的网络IO,提高命令响应速度,保存元数据的文件称为元数据缓存文件。请查看如何管理元数据缓存文件。
若您已使用离线模式,可能是您当前使用的离线数据包并非最新版本,导致参数校验不通过。您可先执行“hcloud meta download”命令,更新离线数据包后,再重新执行1中的命令。若结果中仍不存在该参数,则该API数据未在KooCLI离线模式中更新,请等待离线数据包更新,或切换至在线模式尝试;
若您已使用离线模式,可能是您当前使用的离线数据包并非最新版本,导致参数校验不通过。您可先执行“hcloud meta download”命令,更新离线数据包后,再重新执行1中的命令。若结果中仍不存在该云服务,则该云服务未在KooCLI离线模式中上线,请等待离线数据包更新,或切换至在线模式尝试;
若您已使用离线模式,可能是您当前使用的离线数据包并非最新版本,导致参数校验不通过。您可先执行“hcloud meta download”命令,更新离线数据包后,再重新执行1中的命令。若结果中仍不存在该operation,则该API未在KooCLI离线模式中上线,请等待离线数据包更新,或切换至在线模式尝试;
证书验证会导致您的隐私数据暴露在公网,有被外部窃取的风险,请确认是否跳过(y/N): y { "servers": [] } 需要注意的是,因为使用“--cli-skip-secure-verify=true”跳过https请求证书验证会导致您的隐私数据暴露在公网,有被外部窃
若您已使用离线模式,可能是您当前使用的离线数据包并非最新版本,导致参数校验不通过。您可先执行“hcloud meta download”命令,更新离线数据包后,再重新执行原命令;若仍提示如上错误,则该cli-region值未在KooCLI离线模式中上线,请等待离线数据包更新,或切换至在线模式尝试;
cli-output,cli-query,cli-output-num cli-output 响应数据的输出格式,取值可以为如下其一: json table tsv cli-query 筛选响应数据的JMESPath路径 cli-output-num table输出时,是否打印行号。取值为:true或者false
为该版本即是该API的最新版本)。 扩展问题及其解决方案 扩展问题 当您使用默认版本信息的方式调用多版本云服务的API时,若您本地缓存的元数据文件被修改,可能会导致KooCLI在执行过程中无法根据缓存文件正确解析到该API的版本信息。在此情形下,会提示如下错误: [USE_ERROR]服务为多版本
参数值中可使用“[n]”或“[m:n]”指定其中要打印的数组元素的索引位。指定“[n]”时会打印索引为n的值;指定“[m:n]”时会打印原数据m ~(n-1)索引位置的值。例如执行命令“hcloud configure list --cli-output-rows=profiles[0:2]