检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 KooCLI将调用命令时出现的错误分为五种类型，在错误提示信息的起始位置声明其具体类型：[NETWORK_ERROR]，[CLI_ERROR]，[USE_ERROR]，[OPENAPI_ERROR]和[APIE_ERROR]。各类错误的定位方法如下： [NETWORK_ER
的身份凭证，根据华为帐号授予的权限使用资源，可以确保华为帐号及资源的安全性。IAM用户不进行独立的计费，由所属华为帐号统一付费。 您注册华为云后，系统自动创建华为帐号对应的IAM用户，该用户在IAM中标识为“企业管理员”，其权限无法修改。出于业务需要，您可以另外创建IAM用户，并根据实际需要给IAM用户授权。
更新管理 开源第三方软件更新 KooCLI采用可信流水线构建，有完善的开源第三方软件管理流程，在每次版本发布时确保使用的开源第三方软件都是没有高危漏洞的。 高危漏洞修复 当业界公布最新的高危漏洞软件时， KooCLI如果涉及会发布修复后的相关版本供用户下载或更新。 详情请见版本更新。
成长地图 | 华为云 华为云命令行工具服务 华为云命令行工具服务（Koo Command Line Interface，KooCLI），是为发布在API Explorer上的华为云服务API提供的命令行管理工具。您可以通过此工具调用API Explorer中各云服务开放的API，管理和使用您的各类云服务资源。
以json输出格式为例，示范不同JMESPath表达式的数据输出顺序： 示例1： 指定至对象层级，KooCLI会以该对象各属性名的字典顺序，输出其对应的值。在此示例中指定至对象"items[0]"，该对象中各属性按字典顺序排序后为：apiVersion，kind，metadata，spec，status。因此输出结果如下：
什么是KooCLI 华为云命令行工具服务（Koo Command Line Interface，KooCLI，原名HCloud CLI）是为发布在API Explorer上的云服务API提供的命令行管理工具。您可以通过此工具调用API Explorer中各云服务开放的API，管理和使用您的各类云服务资源。
获取区域 请参见终端节点及区域说明。 父主题： 获取认证信息
旧输出参数cli-json-filter如何使用，注意事项有哪些？ 旧输出参数cli-json-filter如何使用？ 旧输出参数cli-json-filter使用时的注意事项有哪些？ 父主题： 输出格式相关
结果轮询 cli-waiter用于结果轮询，参数应为JSON格式且使用双引号包裹。您可以使用此参数进行结果轮询： hcloud ECS NovaShowServer --cli-region="cn-north-4" --server_id="e6b99563-xxxx-xxxx-xxxx-1820d4fd2a6"
KooCLI相关概念 在KooCLI指导中常用到的词语，以下做出详细介绍，方便您的阅读理解。 命令 KooCLI提供的各项操作指令，用于配置工作环境，或者调用云各服务开放的API。 API调用命令格式如下： hcloud [options] <service> <operation>
指定区域 KooCLI除了可以从配置项读取区域信息外，还可以在命令中传入cli-region值，如下： hcloud EVS DeleteVolume --cli-region="cn-north-4" --volume_id="aed9****-****-****-****-****0e3219cf"
审计与日志 由于KooCLI是部署在用户本地的客户端工具，工具本身记录的日志可以作为审计目的使用，但是需要用户对日志进行访问权限控制以达到审计日志不可篡改的目的。此外， 同使用SDK一样，KooCLI将用户命令解析成https请求发送到API Gateway后，API Gateway记录的相关信息也可用作审计目的。
list { "count": 6, "templates": [ { "description": "基于华为云CLI，以shell脚本模板形式集成CLI调用命令，对弹性云服务器进行管理，覆盖从弹性云服务器的创建（购买）到变更规格、再到删除的整个生命周期。"
如何卸载KooCLI？ KooCLI无需安装，下载解压后即可使用。因此您在卸载时仅需要删除该工具及相关本地缓存文件即可。请参考如下步骤： 执行“hcloud auto-complete off”命令关闭自动补全； 删除缓存文件，配置文件及日志文件： Linux系统： /home/{当前用户名}/
自动补全 KooCLI开启自动补全后，在输入命令时使用“Tab”键，会根据已有命令提示其待补全的内容。 开启自动补全功能： hcloud auto-complete on hcloud auto-complete on 开启成功!自动补全仅支持bash,若未生效请执行`bash`命令
版本更新 KooCLI支持本地更新， 运行更新命令经交互确认后可将其升级至最新版本。 更新命令如下： hcloud update hcloud update KooCLI将更新到最新版本,请您确认是否继续(y/N): y 更新成功 执行版本更新命令时，在命令中添加“-y”参数，可跳过交互确认，直接更新：
日志管理 KooCLI提供日志记录和管理功能，会缓存API调用过程中产生的日志信息，日志文件保存目录如下： Windows系统： C:\Users\{您的Windows系统用户名}\.hcloud\log\ Linux系统: /home/{当前用户名}/.hcloud/log/ Mac系统：
指定配置项 KooCLI支持多配置项，用户可将常用的AK/SK，区域等信息保存到配置项中，使用时通过“--cli-profile”指定目标配置项的名称即可。如下： hcloud EVS ListSnapshots --cli-profile=test 父主题： 选项说明
打印帮助信息 KooCLI支持查看命令的帮助信息，例如查看“RDS”服务operation为“ListCollations”的API的帮助信息： hcloud RDS ListCollations --cli-region="cn-north-1" --help 父主题： 选项说明
身份认证与访问控制 KooCLI通过华为云API Gateway对华为云OpenAPI进行调用，其身份认证与访问控制与华为云OpenAPI保持一致。 身份认证 KooCLI的API调用分两种模式，一种是无身份认证的调用，当调用华为云OpenAPI中不需认证的API时用户不需要设置
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
