检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
ISSION_01 进行SSO登录，若第一步中未配置cli-sso-account-name与cli-sso-permission-set-name参数，登录过程中需按照提示选择账号名与权限集名称： hcloud configure sso --cli-profile=testSSO
另外，若云服务的API中存在（或可自定义）与旧系统参数同名的参数，则若该参数出现在命令中，KooCLI将无法确认该参数作何种用途。故在解析该命令的过程中，会通过交互向信息向用户确认该参数的实际用途，避免解析错误。例如： 目标API中存在与KooCLI系统参数%s同名的参数,无法识别命令中%s的位置
”直接在命令中使用。对于同一参数，KooCLI会在运行过程中优先使用命令中指定的该参数值。未在命令中指定的参数，则使用当前配置项中其值。 与新系统参数相关的KooCLI旧系统参数参见下表。 父主题： 参数相关
双方身份的正确性： AK（Access Key ID）：访问密钥ID，是与私有访问密钥关联的唯一标识符。访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。
当命令中使用了“--cli-json-filter”时，将以json格式输出调用结果。 在同一命令中，“--cli-json-filter”不可以与“--cli-output-rows”，“--cli-output-cols”，“--cli-output-num”同时使用，会因无法判断输出格式而导致错误。
调用云服务API时，支持设置网络请求连接超时时间。 公测 指定请求连接超时时间 2 体验优化 KooCLI版本：1.2.4 支持带“cli-”前缀的新系统参数，处理旧系统参数与华为云API参数重名的的问题。 公测 系统参数 2020年9月 序号 功能名称 功能描述 阶段 相关文档 1 体验优化 KooCLI版本：1
在线/离线模式分别适用什么场景？ 查看/切换当前模式 KooCLI支持在线/离线模式。默认为在线模式。添加配置项之后，您可以执行“hcloud configure list --cli-query=offline”命令查看当前是否已使用离线模式。 执行命令“hcloud configure
提示不正确的参数时如何处理？ 问题背景 通过KooCLI管理和使用您的各类云服务资源时，在调用云服务API的过程中，会对您输入参数的合法性进行校验。若您在命令中输入了当前API不支持的参数，或将只允许配置在配置项中使用的参数在命令直接传入，会提示如下错误： [USE_ERROR]不正确的参数:*
提示不支持的参数位置/类型时如何处理？ 问题背景 通过KooCLI管理和使用您的各类云服务资源，在调用云服务API的过程中，KooCLI会对您输入参数的合法性进行校验。在此校验过程中，KooCLI会获取该API中所有参数的详情信息，其中包括每个参数的类型、在request中的位置
注意事项 “--cli-jsonInput”选项传入的JSON文件中目前只支持写入云服务的API参数，不支持写入系统参数。若目标API中存在与新系统参数或旧系统参数重名的参数，被写入jsonInput文件中的默认将被识别为该API的参数； “--cli-jsonInput”选项传入
指定结果的输出格式 命令中使用“--cli-query”传入JMESPath表达式，对结果执行JMESPath查询，方便提炼原返回结果中的关键信息；“--cli-output”指定响应数据的输出格式；“--cli-output-num”指定当使用table格式输出时，是否打印行号。
跳过https请求证书验证 cli-skip-secure-verify选项用于指定是否跳过https请求证书验证(不建议)。当用户已配置HTTP代理，KooCLI调用云服务的API时，可能会因证书校验失败，导致请求报错x509。用户可在命令中添加“--cli-skip-secu
-region”和“--region”。之所以同一系统参数同时支持两种参数名，是因为在KooCLI上开放的云服务中，存在部分API的某参数与系统参数重名的情况。 解决方案 若提示的错误信息为上述第一种，则命令中可能存在重复的非系统参数，请您检查是否误输。此错误也可能与系统解析处理
新输出参数cli-output，cli-query，cli-output-num在使用时的注意事项有哪些？ 新输出参数的使用方法请参考：指定结果的输出格式。 命令中使用“--cli-query”用于传入JMESPath表达式，对结果执行JMESPath查询，方便提炼原返回结果中的
图3 交互式中提示系统命令的子命令 图4 交互式中提示系统命令的参数 若已输入的云服务/系统命令非法，则不再提示任何信息。 参数 已输入服务名与API的operation，或已输入系统命令及其子命令经校验无误后，会继续提示该API/系统命令子命令的参数列表。 图5 交互式中提示云服务API的参数列表
在线体验功能特性 重启 在“重启”单击左键，当前实例将会重启。重启实例将会终止所有会话并创建一个新的会话，任何正在进行中的进程都会被终止，非持久化存储的数据将被清空。 设置 在“设置”单击左键，可设置当前实例的字体大小和样式。 上传下载 可以将文件上传到工作空间中的用户目录下。反之，也可以把工作空间的文件下载到本地。
在线体验KooCLI 在线体验功能内嵌于API Explorer页面中，您可以在除IE之外的任意浏览器上在线体验KooCLI，如下图所示，鼠标左键单击“CLI示例”方框中的图标按钮即可启动。 图1 在API Explorer上启动在线体验功能 启动时会自动为您分配一个Linux系
生成JSON格式API入参骨架 skeleton选项用于生成JSON格式API入参骨架。在命令中添加“--skeleton”选项，则在当前目录生成该API的JSON格式的入参文件，用户可填写文件中的参数值，以“--cli-jsonInput=${JSON文件名}”传入参数，调用API：
hcloudcli 运行如下命令查看已启动的Docker容器： docker ps 运行如下命令进入Docker容器，进入到容器后KooCLI的使用方式与直接在宿主机上使用相同： docker exec -it hcloudcli /bin/bash 使用完成后，执行如下命令退出“hcloudcli”容器：
旧输出参数cli-output-rows，cli-output-cols，cli-output-num如何使用？ 通过KooCLI调用云服务API，默认会返回json格式的调用结果。KooCLI支持使用“--cli-output-rows”，“--cli-output-cols”
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
