检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
输出格式相关 KooCLI支持的输出格式有哪些？ 如何定义JMESPath表达式 KooCLI与输出相关的系统参数有哪些，推荐使用哪些？ 新输出参数cli-output，cli-query，cli-output-num在使用时的注意事项有哪些？ 旧输出参数cli-output-r
入门流程 本节以Windows系统为例介绍KooCLI的使用，Linux和MacOS系统的使用基本相同，可参考。 KooCLI最基础的入门操作包括：快速安装、初始化配置信息，查看与执行云服务操作命令。 图1为KooCLI大致的入门流程，本入门指导旨在帮助您对其操作有初步的认识。 图1
在线体验 在线体验KooCLI 在线体验功能特性
在线体验功能特性 重启 在“重启”单击左键，当前实例将会重启。重启实例将会终止所有会话并创建一个新的会话，任何正在进行中的进程都会被终止，非持久化存储的数据将被清空。 设置 在“设置”单击左键，可设置当前实例的字体大小和样式。 上传下载 可以将文件上传到工作空间中的用户目录下。反之，也可以把工作空间的文件下载到本地。
指定区域 KooCLI除了可以从配置项读取区域信息外，还可以在命令中传入cli-region值，如下： hcloud EVS DeleteVolume --cli-region="cn-north-4" --volume_id="aed9****-****-****-****-****0e3219cf"
审计与日志 由于KooCLI是部署在用户本地的客户端工具，工具本身记录的日志可以作为审计目的使用，但是需要用户对日志进行访问权限控制以达到审计日志不可篡改的目的。此外， 同使用SDK一样，KooCLI将用户命令解析成https请求发送到API Gateway后，API Gateway记录的相关信息也可用作审计目的。
什么是KooCLI 华为云命令行工具服务（Koo Command Line Interface，KooCLI，原名HCloud CLI）是为发布在API Explorer上的云服务API提供的命令行管理工具。您可以通过此工具调用API Explorer中各云服务开放的API，管理和使用您的各类云服务资源。
如何指定云服务的API和版本号？ 问题背景 KooCLI调用云服务API的过程中，会对您输入参数的合法性进行校验。若您当前调用的云服务是多版本服务，即意味着该服务中的部分或全部API有多个版本。因同一API不同版本的参数、使用场景等可能存在差异，故须获取多版本服务API的版本信息。
认证相关 获取认证信息 认证方式优先级
日志相关 日志文件存于何处？
区域相关 提示缺少cli-region参数时如何处理？ 提示不支持的cli-region时如何处理？
获取认证信息 获取永久AK/SK 获取账号ID、项目ID 获取区域 获取临时AK/SK和securitytoken
风险防范 我们强烈建议您： 在.hcloud目录及其子目录和文件上配置适当的文件系统权限，仅限授权用户访问。 在使用敏感变量时对变量值进行加密，以防止敏感信息泄露。 尽可能使用临时认证凭据以降低认证凭据泄露时带来的风险。 父主题： 安全
交互式/自动补全相关 使用交互式/自动补全需要注意什么？
自定义请求域名 cli-endpoint用于自定义请求云服务的域名。KooCLI默认会请求对应区域的目标云服务，您也可以针对该云服务指定Endpoint： hcloud IoTDA UpdateDevice --cli-region="cn-north-4" --description="test
配置信息管理 配置命令简介 初始化配置 新增或修改配置项 SSO登录 查询配置项列表 查询指定配置项 删除指定配置项 检查配置文件格式 删除所有配置项
如何使用KooCLI 下载KooCLI。 KooCLI绿色免安装，下载到本地后解压即可使用。KooCLI支持Windows 64位、Linux AMD 64位、Linux ARM 64位、macOS AMD 64位、macOS ARM 64位，请根据您本地系统下载对应的版本。 配置KooCLI环境。
常用命令 查看帮助信息 自动补全 交互式提示 元数据管理 查询当前版本 版本更新 日志管理 模板管理 管理OBS中的数据
已有命令中参数校验不通过而报错。可保证KooCLI命令一旦构建，长期可用。适用于用户以KooCLI命令构建固定脚本并定期执行，管理云服务和云资源的场景。 在线模式适用场景 会在KooCLI命令执行过程中获取元数据并缓存在用户本地，该元数据缓存文件具有时效性。后续执行KooCLI命
交互式提示 KooCLI支持功能强大的多平台支持的交互式提示，方便命令构建，在命令中添加“--interactive”参数即可进入交互式提示。交互式中根据用户当前输入的内容，提示云服务名称，API的operation，参数及其描述信息，也提供部分参数值的补全功能。 交互式的使用方式如下：
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
