检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
入门流程 本节以Windows系统为例介绍KooCLI的使用，Linux和MacOS系统的使用基本相同，可参考。 KooCLI最基础的入门操作包括：快速安装、初始化配置信息，查看与执行云服务操作命令。 图1为KooCLI大致的入门流程，本入门指导旨在帮助您对其操作有初步的认识。 图1
"version": 4 } ] }, "OS-EXT-STS:task_state": null, "OS-DCF:diskConfig": "AUTO", "OS-EXT-AZ:availability_zone": "cn-north-4g"
件，配置文件保存地址如下： Windows系统： C:\Users\{您的Windows系统用户名}\.hcloud\config.json Linux系统: /home/{当前用户名}/.hcloud/config.json Mac系统： /Users/{当前用户名}/.hcloud/config
configure delete --cli-profile=test 删除配置项test成功,默认配置项为default 删除配置项时，会同时删除其中的系统参数和custom参数。 父主题： 删除指定配置项
获取临时AK/SK和securitytoken 临时AK/SK和securitytoken是系统颁发给IAM用户的临时访问令牌，有效期可在15分钟至24小时范围内设置，过期后需要重新获取。临时AK/SK和securitytoken遵循权限最小化原则。请参见获取临时AK/SK和securitytoken。
风险防范 我们强烈建议您： 在.hcloud目录及其子目录和文件上配置适当的文件系统权限，仅限授权用户访问。 在使用敏感变量时对变量值进行加密，以防止敏感信息泄露。 尽可能使用临时认证凭据以降低认证凭据泄露时带来的风险。 父主题： 安全
查询指定配置项 查询指定配置项中的系统参数 查询指定配置项中的custom参数 父主题： 配置信息管理
单一可执行文件，绿色免安装，下载解压后即可使用。 多操作系统支持，包括Linux、Windows、Mac。 扩展性强，您可基于此工具对云服务API进行封装，扩展出您想要的功能，实现脚本化管理云服务资源。 下载KooCLI，请参考《快速入门》。 您也可以在线体验KooCLI。 在Windows系统使用KooCLI时，请勿双击执行hcloud
新增或修改配置项 概述 设置配置项中的系统参数 设置配置项中的custom参数 父主题： 配置信息管理
配置命令简介 KooCLI配置命令包含初始化配置、配置项的增删改查等，具体命令如下表： 系统命令 功能简介 hcloud configure init 初始化配置 hcloud configure set 新增/修改配置项 hcloud configure sso SSO登录 hcloud
时，设置其中的系统参数；当“--cli-custom=true”时，设置其中的custom（即用户自定义）参数。 设置配置项中的系统参数时，若该配置项不存在则新增配置项，否则修改该配置项。 不支持向不存在的配置项中设置custom参数；不支持在同一命令中同时设置系统参数和custom参数。
查询配置项列表 查询配置项列表中的系统参数 查询配置项列表中的custom参数 父主题： 配置信息管理
传入，用户可通过“--cli-jsonInput”将云服务API的部分或全部参数以JSON文件的形式输入。剩余的其他参数，例如KooCLI系统参数、未通过JSON文件传入的云服务API参数等，仍可在命令中传入，例如： hcloud ECS CreateServers --cli-region="cn-north-4"
ws 64位、Linux AMD 64位、Linux ARM 64位、macOS AMD 64位、macOS ARM 64位，请根据您本地系统下载对应的版本。 配置KooCLI环境。 环境配置请参考快速初始化配置。 获取云服务API调用命令。 获取云服务API调用命令有两种方式：
某参数与系统参数重名的情况。 解决方案 若提示的错误信息为上述第一种，则命令中可能存在重复的非系统参数，请您检查是否误输。此错误也可能与系统解析处理命令内容有关，若参数值有特殊符号，请使用双引号引起，避免解析错误。 若提示的错误信息为上述第二种，说明命令中存在重复的旧系统参数，您可使用“hcloud
run”时仅支持KooCLI相关命令。 创建临时容器，向容器共享宿主机文件（以Linux系统的宿主机为例），并执行命令： 通过宿主机系统目录和容器目录的挂载，将宿主机文件共享到容器： 示例1：通过将宿主机系统的/root/.hcloud/目录挂载到容器的/root/.hcloud/目录下，将宿主机配置文件共享到容器：
元数据缓存文件的存放位置 在线模式： Windows系统： C:\Users\{您的Windows系统用户名}\.hcloud\metaRepo\ Linux系统: /home/{当前用户名}/.hcloud/metaRepo/ Mac系统： /Users/{当前用户名}/.hcloud/metaRepo/
标左键单击“CLI示例”方框中的图标按钮即可启动。 图1 在API Explorer上启动在线体验功能 启动时会自动为您分配一个Linux系统的容器（以下称之为实例）供您使用，该实例上已预装最新版的KooCLI。在线体验功能具有以下优点： 实例启动后默认将当前CLI示例内容复制到实例窗口并执行。
AMD 64位、macOS ARM 64位，请根据您本地系统下载对应的版本。 Windows系统 在Windows系统上安装KooCLI Linux系统 在Linux系统上安装KooCLI MacOS系统 在MacOS系统上安装KooCLI Docker容器 在Docker中配置和使用KooCLI
参数可分为API参数和KooCLI系统参数。API参数是指云服务的API中定义的参数；系统参数是指KooCLI的内置参数，具有其固定的使用方式和特定含义。请查看系统参数列表。 选项 KooCLI选项是指可以直接在调用API的命令中添加的KooCLI系统参数，并非所有的系统参数都可作为选项使用。请查看选项列表。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
