检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
删除指定配置项及其custom参数 使用“--cli-profile”指定要删除的配置项的名称。删除指定配置项的命令为： hcloud configure delete --cli-profile=${profileName} hcloud configure delete --cli-profile=test
开源第三方软件更新 KooCLI采用可信流水线构建，有完善的开源第三方软件管理流程，在每次版本发布时确保使用的开源第三方软件都是没有高危漏洞的。 高危漏洞修复 当业界公布最新的高危漏洞软件时， KooCLI如果涉及会发布修复后的相关版本供用户下载或更新。 详情请见版本更新。 父主题：
本节以Windows系统为例介绍KooCLI的使用，Linux和MacOS系统的使用基本相同，可参考。 KooCLI最基础的入门操作包括：快速安装、初始化配置信息，查看与执行云服务操作命令。 图1为KooCLI大致的入门流程，本入门指导旨在帮助您对其操作有初步的认识。 图1 入门流程 注册华为
通过KooCLI管理和使用您的各类云服务资源时，会远程获取您命令中目标云服务及其API的详情信息。为减少远程调用次数，提高响应速度，KooCLI引入了缓存机制，在运行过程中将云服务及其API的相关信息保存在本地缓存文件中，该文件称为元数据缓存文件。在元数据缓存文件过期前，会使用该文件中的信息对命令中的参数进行校验和组装。
参数可分为API参数和KooCLI系统参数。API参数是指云服务的API中定义的参数；系统参数是指KooCLI的内置参数，具有其固定的使用方式和特定含义。请查看系统参数列表。 选项 KooCLI选项是指可以直接在调用API的命令中添加的KooCLI系统参数，并非所有的系统参数都可作为选项使用。请查看选项列表。
本节以Windows系统为例介绍KooCLI的使用，Linux和Mac系统的使用基本相同，可参考。 完成初始化配置后，即可查询KooCLI支持的云服务列表，并执行相关命令。下文以弹性云服务器（ECS）的查询云服务器详情的API为例，说明如何查找与执行命令。 查询云服务的operation列表 hcloud
指定用户所属账号ID KooCLI以AKSK模式调用全局服务的API时，需添加账号ID（即cli-domain-id）。KooCLI会在调用全局服务的API的过程中，根据用户认证信息自动获取账号ID，用户也可在命令中添加“--cli-domain-id”选项，如下： hcloud
通过KooCLI管理和使用您的各类云服务资源，在调用云服务的API时，KooCLI优先使用命令中“--cli-profile”选项指定的配置项。 如您未在命令中指定配置项，会使用默认配置项来调用目标API。 若该配置项的内容与目标API不匹配，或缺少访问目标API时需要的某参数，会提示相关错误，例如：
Gateway之间的通信传输采用https协议，有效防止数据被篡改，保护用户数据在网络中的传输安全。加密协议为业界公认安全性较高的TLS1.2、TLS1.3。 敏感数据保护 用户使用KooCLI配置的认证凭据（如AK/SK）、自定义变量支持加密方式存储。 KooCLI的加密密钥在首次
由于KooCLI是部署在用户本地的客户端工具，工具本身记录的日志可以作为审计目的使用，但是需要用户对日志进行访问权限控制以达到审计日志不可篡改的目的。此外， 同使用SDK一样，KooCLI将用户命令解析成https请求发送到API Gateway后，API Gateway记录的相关信息也可用作审计目的。
使用？ 通过KooCLI调用云服务API，默认会返回json格式的调用结果。KooCLI支持使用“--cli-json-filter”对json结果执行JMESPath查询，方便提炼其中的关键信息，如下： 以默认的json格式输出原调用结果： hcloud ECS NovaListServers
隐私声明 详见《隐私政策声明》。 KooCLI的3.2.8及以后的版本在首次使用时，请您根据交互提示信息，选择是否同意其互联网连接及隐私政策声明。 对于不方便交互的场景，如以自动化脚本执行KooCLI命令，可通过如下命令，配置同意隐私声明： hcloud configure set
自定义请求域名 cli-endpoint用于自定义请求云服务的域名。KooCLI默认会请求对应区域的目标云服务，您也可以针对该云服务指定Endpoint： hcloud IoTDA UpdateDevice --cli-region="cn-north-4" --description="test
} 以table输出调用结果时，“--cli-output-rows”指定json结构体的层级，即表格的数据来源；“--cli-output-cols”指定表格的列名，需要与json结构体中的字段相对应；“--cli-output-num”指定是否打印表格行号，默认值为true，如下图所示:
int 轮询的超时时间(秒),min=1,max=600,默认值180 - interval optional int 轮询的间隔时间(秒),min=2,max=10,默认值5 需要注意的是，因为使用“--cli-waiter”可能会导致调用接口幂等性的问题，有重复调用的风险，请您谨慎使用。建议查询类接口使用此参数。
SSO登录 KooCLI的SSO登录命令通过完成SSO登录，将用户的认证信息存储在配置文件中，避免执行操作时频繁输入这些固定信息。可通过如下命令进行SSO登录： hcloud configure sso 输入以上命令并回车后，会逐步提示您输入SSO profile name（此S
[CLI_ERROR]：一般是因KooCLI处理命令过程中本身的异常导致的错误，请联系KooCLI的oncall协助处理； [USE_ERROR]：一般是因命令中参数不正确造成的错误，请根据错误提示做相应修改； [OPENAPI_ERROR]：一般是调用云服务API时发生的错误，请联系相关云服务oncall协助处理；
API Explorer上开放的各云服务API，除了支持在线调试，还能生成KooCLI命令示例（以下简称CLI示例）。您在API Explorer界面上填写API参数，在其对应的“CLI示例”中可直接拷贝使用。 下图为API Explorer上CDN服务的创建加速域名API。在API
指定配置项 KooCLI支持多配置项，用户可将常用的AK/SK，区域等信息保存到配置项中，使用时通过“--cli-profile”指定目标配置项的名称即可。如下： hcloud EVS ListSnapshots --cli-profile=test 父主题： 选项说明
Access Key”的值需要二次确认。为保障您的账号安全，对您输入的“Secret Access Key”进行了匿名化处理。在您输入过程中不会显示输入的字符，在输入结束回车至下一行时，会以“*”回显您的输入内容。在配置完成后，KooCLI会在本地加密保存配置项中的认证相关的敏感信息。 如
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
