检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
临时AK/SK和securitytoken是系统颁发给IAM用户的临时访问令牌,有效期可在15分钟至24小时范围内设置,过期后需要重新获取。临时AK/SK和securitytoken遵循权限最小化原则。请参见获取临时AK/SK和securitytoken。 父主题: 获取认证信息
初始化配置 KooCLI初始化命令用于将常用的永久AK/SK和区域信息存储在配置文件中,避免执行操作时频繁输入这些固定信息。可通过如下命令初始化配置: hcloud configure init 输入以上命令并按回车后,会逐步提示您输入Access Key ID(必填)、Secret
是否提示命令执行过程中的Warning信息。以自动化脚本执行命令时,关闭Warning提示信息,可以避免干扰解析命令执行的输出结果。取值范围: true(默认值,表示提示Warning信息) false(表示不提示Warning信息) cli-auth-encrypt 配置文件中的认证信息是否加密存储。取值范围:
新增或修改配置项 概述 设置配置项中的系统参数 设置配置项中的custom参数 父主题: 配置信息管理
子项目ID。 图1 账号ID、项目ID KooCLI可在API调用过程中, 根据当前用户认证信息自行获取请求头中需要的账号ID、项目ID,因此命令中可不输入该参数。 父主题: 获取认证信息
打印命令调用过程中的调试信息 KooCLI支持打印命令执行过程中的调试信息。在命令中添加“--debug”即可: hcloud VPC ShowVpc/v3 --cli-region="cn-north-4" --project_id="0dd8cb****************19b5a84546"
hcloud configure clear hcloud configure clear 是否删除所有配置信息(y/N): y 已删除所有配置信息 父主题: 配置信息管理
删除指定配置项 删除指定配置项及其custom参数 删除指定配置项中的custom参数 父主题: 配置信息管理
为快速检验本地配置文件的格式是否正确,可执行如下命令: hcloud configure test hcloud configure test 配置文件格式正确 父主题: 配置信息管理
configure delete --cli-profile=test 删除配置项test成功,默认配置项为default 删除配置项时,会同时删除其中的系统参数和custom参数。 父主题: 删除指定配置项
KooCLI与输出相关的系统参数有哪些,推荐使用哪些? KooCLI与输出相关的参数如下: 表1 KooCLI与输出相关的参数 参数分组 参数 参数用途 新输出参数 cli-output,cli-query,cli-output-num cli-output 响应数据的输出格式,取值可以为如下其一:
KooCLI提供日志记录和管理功能,会缓存API调用过程中产生的日志信息,日志文件保存目录如下: Windows系统: C:\Users\{您的Windows系统用户名}\.hcloud\log\ Linux系统: /home/{当前用户名}/.hcloud/log/ Mac系统: /Users/{当前用户名}/
--project_id="custom.projectId" 使用被加密存储的custom参数时,KooCLI会在可能显示其值的情况下(例如:debug信息中打印的request请求的url,或dryrun模式下打印的body体参数),对其值做匿名化处理。 父主题: 新增或修改配置项
步骤四:查看与执行云服务操作命令 本节以Windows系统为例介绍KooCLI的使用,Linux和Mac系统的使用基本相同,可参考。 完成初始化配置后,即可查询KooCLI支持的云服务列表,并执行相关命令。下文以弹性云服务器(ECS)的查询云服务器详情的API为例,说明如何查找与执行命令。
因此,当您构建KooCLI命令时,对于其中的系统参数,为避免出现参数冲突而引起错误或交互,推荐使用新系统参数。 新增系统参数将添加至新系统参数列表中。旧系统参数将仅维持其已有功能,不再持续升级。 旧系统参数 KooCLI旧系统参数的描述信息及其对应的新系统参数如下表所示: 表1 KooCLI旧系统参数 旧系统参数 参数描述
查询当前版本 查询KooCLI当前版本的命令为: hcloud version hcloud version 当前KooCLI版本:3.2.8 父主题: 常用命令
删除指定配置项中的custom参数 使用“--cli-profile”指定要删除的配置项的名称。删除指定配置项中的custom参数的命令可分为: 删除指定配置项中的指定custom参数: hcloud configure delete --cli-profile=${profileName}
KooCLI会记录您使用过程中产生的日志信息。日志记录功能暂不支持关闭。 日志文件名称为“hcloud.log”,日志文件的存放位置如下: Linux系统:/home/{当前用户名}/.hcloud/log/ Windows系统:C:\Users\{当前用户名}\.hcloud\log\ Mac系统:/Users/{当前用户名}/
hcloud/config.json Mac系统: /Users/{当前用户名}/.hcloud/config.json 完成初始化后,可通过如下命令查询配置信息。KooCLI1.2.7以前的版本密文显示查询结果中的敏感信息;1.2.7及以后的版本匿名化显示查询结果中的敏感信息。 hcloud configure
入门流程 本节以Windows系统为例介绍KooCLI的使用,Linux和MacOS系统的使用基本相同,可参考。 KooCLI最基础的入门操作包括:快速安装、初始化配置信息,查看与执行云服务操作命令。 图1为KooCLI大致的入门流程,本入门指导旨在帮助您对其操作有初步的认识。 图1