检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
版本更新 KooCLI支持本地更新， 运行更新命令经交互确认后可将其升级至最新版本。 更新命令如下： hcloud update hcloud update KooCLI将更新到最新版本,请您确认是否继续(y/N): y 更新成功 执行版本更新命令时，在命令中添加“-y”参数，可跳过交互确认，直接更新：
cli-connect-timeout 请求连接超时时间(秒)，默认值5秒，参数最小取值为1秒 配置于配置项后使用 / 命令中直接使用 cli-read-timeout I/O超时时间(秒)，默认值10秒，参数最小取值为1秒 配置于配置项后使用 / 命令中直接使用 cli-retry-count 请求连接重试次数，默认取值为0次，参数取值范围为0~5次
指定用户所属账号ID 指定配置项 指定配置项的认证模式 指定结果的输出格式 以JSON文件的方式传递API参数 指定请求超时时间 指定请求连接重试次数 跳过https请求证书验证 自定义请求域名 结果轮询
查看指定云服务的operation列表。例如查看“ECS”服务的operation列表：hcloud ECS --help hcloud <service> <operation> --help 查看指定云服务API的详情信息。例如查看“ECS”服务中，operation为“ShowServer”的API详情：hcloud
connect-timeout 请求连接超时时间(秒)，默认值5秒，参数最小取值为1秒 cli-connect-timeout read-timeout I/O超时时间(秒)，默认值10秒，参数最小取值为1秒 cli-read-timeout retry-count 请求连接重试次数，默认取值为0次，参数取值范围为0~5次
元数据管理 清理元数据缓存 KooCLI会缓存API调用过程中获取并保存在用户本地的元数据缓存文件，放置在如下目录下： 在线模式： Windows系统： C:\Users\{您的Windows系统用户名}\.hcloud\metaRepo\ Linux系统: /home/{当前用户名}/
如何卸载KooCLI？ KooCLI无需安装，下载解压后即可使用。因此您在卸载时仅需要删除该工具及相关本地缓存文件即可。请参考如下步骤： 执行“hcloud auto-complete off”命令关闭自动补全； 删除缓存文件，配置文件及日志文件： Linux系统： /home/{当前用户名}/
审计与日志 由于KooCLI是部署在用户本地的客户端工具，工具本身记录的日志可以作为审计目的使用，但是需要用户对日志进行访问权限控制以达到审计日志不可篡改的目的。此外， 同使用SDK一样，KooCLI将用户命令解析成https请求发送到API Gateway后，API Gateway记录的相关信息也可用作审计目的。
sync 增量同步上传对象 将本地源路径下的所有内容同步到OBS指定目标桶，使两边内容保持一致。这里的增量同步有两层含义： 增量，依次比较源文件和目标对象，只上传存在变化的源文件； 同步，命令执行完成后，保证本地源路径是OBS指定目标桶的子集，即本地源路径下的所有文件均能在OBS指定目标桶中找到对应对象。
并执行相关命令。下文以弹性云服务器（ECS）的查询云服务器详情的API为例，说明如何查找与执行命令。 查询云服务的operation列表 hcloud <service> --help 如下所示，“Available Operations”中返回了ECS服务支持的operation列表。
在调用云服务API的时候，大多数场景需要填入项目ID。项目ID获取步骤如下： 注册并登录管理控制台。 单击右上角用户名，在下拉列表中单击“我的凭证”，查看“账号ID（cli-domain-id）”、“项目ID（cli-project-id）”，如下图。 项目用于对云服务器资源进行物理隔离，默认有区域级别的隔离，也可在
控制权限和用户在相关服务里的权限保持一致。 对配置文件及运行日志的访问控制 KooCLI是运行在用户本地的一款客户端工具， KooCLI使用的相关配置文件及运行日志都保存在用户本地，此类文件的访问控制权限需要用户自己管控。 父主题： 安全
configure set --cli-offline=false”可切换至在线模式。 离线模式适用场景 可将KooCLI最新的离线元数据打包下载到用户本地，该元数据缓存文件长期有效。后续执行KooCLI命令时将读取文件内容完成命令校验及解析。此模式下，已打包下载的元数据缓存文件不会自动更新，
sername:password@proxyServer:port" 其中，proxyServer为代理服务器的域名（如果能解析）或者IP。port为端口号。如果你的代理服务器需要用户名和密码才能访问，需要填写上面的username和password部分，否则的话，可以省略这两部分，如下：
创建新的访问密钥 如您尚未生成过或未能找到本地的AK/SK文件，可创建新的访问密钥： 登录控制台。 在顶部导航栏单击用户名，并选择“我的凭证”。 进入“我的凭证”页面，单击“管理访问密钥”页签下方的“新增访问密钥”。 在弹出的“新增访问密钥”对话框中，输入登录密码和对应验证码。 用户如果未绑定邮箱和手机，则只需输入登录密码。
用户可以在命令中直接输入永久AK（cli-access-key）和SK（cli-secret-key）调用云服务API： hcloud ECS NovaListServers --cli-region="cn-north-4" --project_id="4ff018c3****
法性进行校验。在此校验过程中，KooCLI会获取该API中所有参数的详情信息，其中包括每个参数的类型、在request中的位置等信息。若您本地缓存的元数据文件被修改，可能会使KooCLI在运行过程中无法根据缓存文件正确解析到该API的参数详情，导致校验时提示如下错误： [CLI_ERROR]参数*的位置不正确:*
li-access-key”和“--cli-secret-key”的值不能为空； 若配置项的认证模式为“ecsAgency”，则配置时命令中需指定“--cli-mode=ecsAgency”； 父主题： 选项说明
在Linux系统上安装KooCLI 在MacOS系统上安装KooCLI 在Docker中配置和使用KooCLI 您也可以从下表中直接下载适配您目标系统的KooCLI到本地，再将其上传至您的目标机器，解压后即可使用： 表1 下载地址 操作系统 下载地址 隐私声明 Windows 64位 KooCLI-windows-amd64
n）用于认证； 已添加配置项的情况下，命令中直接指定配置项或使用默认配置项； 委托给云服务（目前仅支持通过IAM委托给弹性云服务器，以委托认证的方式在弹性云服务器中使用KooCLI的场景）。 若在解析某认证方式的过程中出现异常，不会尝试使用低于该优先级的方式进行认证。 父主题： 认证相关
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
