检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
问题背景 KooCLI调用云服务API的过程中,会对您输入参数的合法性进行校验,此校验过程可能需要远程获取该云服务和API的详情信息;在参数校验完成后,亦需要远程调用您的目标API。如在调用过程中因网络连接问题导致请求失败,会提示相关错误,例如: [NETWORK_ERROR]连接超时,请检查网络连通性
入参数的合法性进行校验。在此校验过程中,KooCLI会获取该API中所有参数的详情信息,其中包括每个参数的类型、在request中的位置等信息。若您本地缓存的元数据文件被修改,可能会使KooCLI在运行过程中无法根据缓存文件正确解析到该API的参数详情,导致校验时提示如下错误:
cli-skip-secure-verify选项用于指定是否跳过https请求证书验证(不建议)。当用户已配置HTTP代理,KooCLI调用云服务的API时,可能会因证书校验失败,导致请求报错x509。用户可在命令中添加“--cli-skip-secure-verify=true”后执行原命令,在执行时会向用户交
中目标云服务及其API的详情信息。为减少远程调用次数,提高响应速度,KooCLI引入了缓存机制,在运行过程中将云服务及其API的相关信息保存在本地缓存文件中,该文件称为元数据缓存文件。在元数据缓存文件过期前,会使用该文件中的信息对命令中的参数进行校验和组装。 元数据缓存文件的存放位置
打印帮助信息 KooCLI支持查看命令的帮助信息,例如查看“RDS”服务operation为“ListCollations”的API的帮助信息: hcloud RDS ListCollations --cli-region="cn-north-1" --help 父主题: 选项说明
定其版本信息,方法请参考版本指定。其余在该云服务operation列表中只出现了一次的operation不必拼接版本号,KooCLI默认调用其唯一版本。 版本指定 手动添加版本信息 当调用多版本服务的API时,您可以手动在原API的operation后以“/”拼接版本信息。例如:
查看帮助信息 KooCLI支持在命令中添加“--help”参数查看帮助信息,例如: hcloud --help 查看KooCLI的使用方法及支持的云服务列表。 hcloud <service> --help 查看指定云服务的operation列表。例如查看“ECS”服务的operation列表:hcloud
获取认证信息 获取永久AK/SK 获取账号ID、项目ID 获取区域 获取临时AK/SK和securitytoken
获取认证信息 获取永久AK/SK 请参考获取永久AK/SK。 获取账号ID、项目ID 请参考获取账号ID、项目ID。 获取区域 请参考终端节点及区域说明。 获取临时AK/SK和securitytoken 请参考获取临时AK/SK和securitytoken。 父主题: 认证相关
访问外网的https资源时报证书无效的错误。 您可以通过在命令中添加“--cli-skip-secure-verify=true”跳过证书校验(不建议)。推荐的做法是:将您公司颁发的证书导入到操作系统的可信任CA证书下。 父主题: 使用HTTP代理
是否提示命令执行过程中的Warning信息。以自动化脚本执行命令时,关闭Warning提示信息,可以避免干扰解析命令执行的输出结果。取值范围: true(默认值,表示提示Warning信息) false(表示不提示Warning信息) cli-auth-encrypt 配置文件中的认证信息是否加密存储。取值范围:
SSO登录 KooCLI的SSO登录命令通过完成SSO登录,将用户的认证信息存储在配置文件中,避免执行操作时频繁输入这些固定信息。可通过如下命令进行SSO登录: hcloud configure sso 输入以上命令并回车后,会逐步提示您输入SSO profile name(此S
配置信息管理 配置命令简介 初始化配置 新增或修改配置项 SSO登录 查询配置项列表 查询指定配置项 删除指定配置项 检查配置文件格式 删除所有配置项
“取消”,则不会下载密钥,后续也将无法重新下载。如果需要使用访问密钥,可以重新创建新的访问密钥。 访问密钥(AK和SK)需定期更新。 打开下载下来的“credentials.csv”文件即可获取到访问密钥(AK和SK)。 父主题: 获取认证信息
获取区域 请参见终端节点及区域说明。 父主题: 获取认证信息
初始化配置 KooCLI初始化命令用于将常用的永久AK/SK和区域信息存储在配置文件中,避免执行操作时频繁输入这些固定信息。可通过如下命令初始化配置: hcloud configure init 输入以上命令并按回车后,会逐步提示您输入Access Key ID(必填)、Secret
本,导致参数校验不通过。您可先执行“hcloud meta download”命令,更新离线数据包后,再重新执行1中的命令。若结果中仍不存在该operation,则该API未在KooCLI离线模式中上线,请等待离线数据包更新,或切换至在线模式尝试; 如您的错误提示信息是英文,说明
”的系统参数,会提示相关错误信息。因为如上参数只支持被配置到配置项中使用,配置命令为“hcloud configure set --key1=value1 --key2=value2 ...”; 如KooCLI在命令执行过程中未提示您如上所述的错误信息,但调用API的返回值显示参
检查命令正确性 dryrun选项用于检查所传入命令的正确性。在命令中添加“--dryrun”选项,执行校验后打印请求报文,跳过实际运行,不调用目标API: hcloud RDS CreateConfiguration --cli-region="cn-north-4" --pro
hcloud configure test 检查配置文件格式 hcloud configure clear 删除所有配置项 父主题: 配置信息管理