检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
置项组成配置文件,存储在用户本地。用户在调用云服务API时,可通过指定配置项,代替这组公共信息的输入。 KooCLI配置命令包含初始化配置、配置项的增删改查等。 发布区域:全部 初始化配置 新增或修改配置项 查询配置项列表 查询指定配置项 删除指定配置项 检查配置文件格式 删除所有配置项
AKSK:分为访问密钥和临时安全凭证。访问密钥即为永久AK/SK,临时安全凭证即为临时AK,SK和SecurityToken。 ecsAgency:当委托给ECS服务器时,在ECS服务器中使用KooCLI调用云服务API时自动获取临时认证信息。 SSO:开通IAM身份中心并完成配置后,允许用户使用
I入参骨架。在命令中添加“--skeleton”选项,则在当前目录生成该API的JSON格式的入参文件,用户可填写文件中的参数值,以“--cli-jsonInput=${JSON文件名}”传入参数,调用API: hcloud RDS CreateConfiguration --c
时AK/SK,否则为永久AK/SK。 新增认证模式为ecsAgency的配置项,无需添加认证参数: hcloud configure set --cli-profile=testEcsAgency --cli-mode=ecsAgency --cli-region=cn-north-4
SK:secretAccessKey}" cli-jsonInput 选项 指定JSON文件的方式传递API参数。当云服务API的参数过多时,可将参数定义在一个JSON文件中,KooCLI会解析该文件中的参数内容。 hcloud ECS CreateServers --cli-region="cn-north-4"
华为云命令行工具服务(KooCLI)绿色免安装,下载到本地后解压即可使用。CLI支持Windows 64位、Linux AMD 64位、Linux ARM 64位、macOS AMD 64位、macOS ARM 64位,请根据您本地系统下载对应的版本。 Windows系统 在Windows系统上安装KooCLI
在Windows系统上安装KooCLI 点此下载适配Windows系统的KooCLI。 解压后得到hcloud.exe文件,如下图所示。 图1 在Windows系统下载并解压后的hcloud.exe文件 (可选)将KooCLI所在目录加入到系统环境变量Path中,方便在cmd窗口的任意目录下使用hcloud命令。
Dockerfile文件名带有大写字母D,且没有文件扩展名,每个目录只能保存一个。 hcloud_install.sh文件为一键式安装KooCLI的脚本文件,其对应的软件包校验文件为hcloud_install.sh.sha256 可在上述Dockerfile文件中追加如下内容,指定启动容器时运行的程序为KooCLI:
华为云上某资源的访问控制权限和用户在相关服务里的权限保持一致。 对配置文件及运行日志的访问控制 KooCLI是运行在用户本地的一款客户端工具, KooCLI使用的相关配置文件及运行日志都保存在用户本地,此类文件的访问控制权限需要用户自己管控。 父主题: 安全
KooCLI灵活性高且易于扩展: 单一可执行文件,绿色免安装,下载解压后即可使用。 多操作系统支持,包括Linux、Windows、Mac。 扩展性强,您可基于此工具对云服务API进行封装,扩展出您想要的功能,实现脚本化管理云服务资源。 下载KooCLI,请参考《快速入门》。 您也可以在线体验KooCLI。
hcloud_install.sh文件为一键式安装KooCLI的脚本文件,其对应的软件包校验文件为hcloud_install.sh.sha256 分步安装 若您希望分步骤安装KooCLI,请参考以下步骤: 请您使用以下命令之一下载KooCLI。 使用curl命令下载: AMD 64位操作系统下载命令: curl
使用AMD 64位系统的下载命令;若执行该命令输出结果为空,请使用如下命令查看您主机的操作系统: uname -a 执行如上命令的输出值结尾是“x86_64”,请使用AMD 64位系统的下载命令;若输出值结尾是“arm64”,请使用ARM 64位系统的下载命令。 一键式安装 请使用如下命令一键式安装KooCLI:
入结束回车至下一行时,会以“*”回显您的输入内容。在配置完成后,KooCLI会在本地加密保存配置项中的认证相关的敏感信息。 如果重新执行初始化命令,则会在删除原配置文件后重新生成新的配置文件,配置文件保存地址如下: Windows系统: C:\Users\{您的Windows系统用户名}\
风险防范 我们强烈建议您: 在.hcloud目录及其子目录和文件上配置适当的文件系统权限,仅限授权用户访问。 在使用敏感变量时对变量值进行加密,以防止敏感信息泄露。 尽可能使用临时认证凭据以降低认证凭据泄露时带来的风险。 父主题: 安全
en作为认证参数。 无配置方式ecsAgency 此认证方式仅支持在弹性云服务器中使用KooCLI的场景。 用户必须已在IAM对该弹性云服务器进行云服务委托授权,并在相应的弹性云服务器的详情页面“管理信息 > 委托”栏目中添加向弹性云(ECS)服务器的委托。详细操作请参考委托其他云服务管理资源。
)。 扩展问题及其解决方案 扩展问题 当您使用默认版本信息的方式调用多版本云服务的API时,若您本地缓存的元数据文件被修改,可能会导致KooCLI在执行过程中无法根据缓存文件正确解析到该API的版本信息。在此情形下,会提示如下错误: [USE_ERROR]服务为多版本,请指定API版本号
持被配置到配置项中使用,配置命令为“hcloud configure set --key1=value1 --key2=value2 ...”; 如KooCLI在命令执行过程中未提示您如上所述的错误信息,但调用API的返回值显示参数有误,可能是因您本地缓存API详情的文件被修改,
N格式的文件,且文件扩展名必须为“.json”,支持传入的最大文件为5MB;使用“--cli-jsonInput”时,会校验JSON文件的格式及文件中参数的类型。若JSON文件的格式有误,会提示: [USE_ERROR]cli-jsonInput参数的文件解析失败,文件中参数有误
安全合规认证,用户可自行申请下载合规资质证书。 图1 合规证书下载 资源中心 华为云还提供以下资源来帮助用户满足合规性要求,具体请查看资源中心。 图2 资源中心 销售许可证&软件著作权证书 另外,华为云还提供了以下销售许可证及软件著作权证书,供用户下载和参考。具体请查看合规资质证书。
上所述的错误信息,但调用API的返回值显示region错误,可能是因您本地缓存cli-region列表的文件被修改,导致参数校验失其准确性。此时请您执行“hcloud meta clear”命令清理本地缓存文件后,重新调用; 如您的错误提示信息是英文,说明您此前已在配置中将Koo