检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
试。“--cli-retry-count”的默认取值为0次，参数取值范围为0~5次： 若因网络连接问题导致请求失败，KooCLI会提示如下信息： hcloud RDS ListInstances --cli-region="cn-north-4" --Content-Type="application/json"
指定结果的输出格式 命令中使用“--cli-query”传入JMESPath表达式，对结果执行JMESPath查询，方便提炼原返回结果中的关键信息；“--cli-output”指定响应数据的输出格式；“--cli-output-num”指定当使用table格式输出时，是否打印行号。 输出顺序
结果为空，CLI不会打印相应返回体，用户无法确认是否调用成功。 解决步骤 在原命令中添加“--debug”参数，可打印命令调用过程中的调试信息。其中包含一行内容为“API response status code is xxx.”。用户可以根据该返回体的状态码判断命令是否成功调用。
新输出参数的使用方法请参考：指定结果的输出格式。 命令中使用“--cli-query”用于传入JMESPath表达式，对结果执行JMESPath查询，方便提炼原返回结果中的关键信息；“--cli-output”用于指定响应数据的输出格式；“--cli-output-num”用于指定当使用table格式输出时，是否打印行号。
概述 KooCLI将调用命令时出现的错误分为五种类型，在错误提示信息的起始位置声明其具体类型：[NETWORK_ERROR]，[CLI_ERROR]，[USE_ERROR]，[OPENAPI_ERROR]和[APIE_ERROR]。各类错误的定位方法如下： [NETWORK_ER
定其版本信息，方法请参考版本指定。其余在该云服务operation列表中只出现了一次的operation不必拼接版本号，KooCLI默认调用其唯一版本。 版本指定 手动添加版本信息 当调用多版本服务的API时，您可以手动在原API的operation后以“/”拼接版本信息。例如：
出格式，您也可以配合使用“--cli-query”选项传入JMESPath表达式，对json结果执行JMESPath查询，以过滤出您需要的信息。输出效果可参考此示例：指定结果的输出格式。构造JMESPath表达式，请参考如何定义JMESPath表达式。 父主题： 输出格式相关
函数参数有类型限制。如果函数的参数类型错误，KooCLI会提示错误告警信息并输出原json结果。有些函数可以进行类型转换（to_string、to_number）以帮助将参数转换为正确的类型。 函数参数有个数限制。如果调用函数时入参个数错误，KooCLI会提示错误告警信息并输出原json结果。 父主题： 如何定义JMESPath表达式
如何解决网络连接超时问题？ 问题背景 KooCLI调用云服务API的过程中，会对您输入参数的合法性进行校验，此校验过程可能需要远程获取该云服务和API的详情信息；在参数校验完成后，亦需要远程调用您的目标API。如在调用过程中因网络连接问题导致请求失败，会提示相关错误，例如： [NETWORK_ERROR]连接超时
KooCLI既可以使用配置项调用云服务API，也提供了无配置的操作方式，无配置方式使用是指在使用KooCLI时不通过已有配置项传入当前用户的认证信息，而是直接在命令中传入当前用户认证相关的参数。此方式可使用户免于添加配置项，方便快捷地使用KooCLI。用户可以通过如下认证方式直接调用云服务API：
您可以使用KooCLI进行如下操作，管理您OBS中的数据： 表1 KooCLI集成OBS功能 功能 说明 桶基本操作 指定区域创建不同存储类型的桶、删除桶以及获取桶列表、桶配置信息等。 对象基本操作 管理对象，包括上传、下载、删除和列举对象等。 支持上传单个或批量上传多个文件或文件夹。 支持分段上传大文件。 支持增量同步上传、下载和复制对象。
服务的服务名称/该系统命令的描述信息。 API 已输入的云服务/系统命令经校验无误后，会继续提示该服务的API列表/该系统命令的子命令（或参数）。 所提示的系统命令列表中，左列展示该系统命令的子命令（或参数），右列展示该子命令（或参数）的描述信息。 图2 交互式中提示云服务的API列表
KooCLI系统参数包括哪些？ 系统参数 KooCLI系统参数是指其内置参数，各系统参数的描述信息及其使用方式如下表所示： 表1 KooCLI新系统参数 参数 参数描述 使用方式 help 打印帮助信息 命令中直接使用 debug 打印调试信息 命令中直接使用 dryrun 执行校验后打印请求报文,跳过实际运行
如您未在命令中指定配置项，KooCLI会使用默认配置项来调用目标API。您可使用命令“hcloud configure show”查询默认配置项的详情信息； 如您需要使用其他配置项，您可通过“hcloud configure list”命令查看您已配置的所有配置项，然后使用“--cli-pr
常用选项 配置项管理 配置项用于存储一组调用云服务API时所需的公共信息，由用户通过调用KooCLI命令完成配置。各配置项组成配置文件，存储在用户本地。用户在调用云服务API时，可通过指定配置项，代替这组公共信息的输入。 KooCLI配置命令包含初始化配置、配置项的增删改查等。 发布区域：全部
配置项 配置项用于存储一组调用云服务API时所需的公共信息，由用户通过调用KooCLI命令完成配置。各配置项组成配置文件，存储在用户本地。用户在调用云服务API时，可通过指定配置项，代替这组公共信息的输入。 配置项支持配置的公共信息包括：访问密钥（AK/SK）、区域（cli-regi
参数与系统参数重名的情况。 解决方案 若提示的错误信息为上述第一种，则命令中可能存在重复的非系统参数，请您检查是否误输。此错误也可能与系统解析处理命令内容有关，若参数值有特殊符号，请使用双引号引起，避免解析错误。 若提示的错误信息为上述第二种，说明命令中存在重复的旧系统参数，您可使用“hcloud
相应的选项；KooCLI也提供多种能力，帮助您构建命令行。 常用命令 配置信息管理 查看帮助信息 元数据管理 查询当前版本 版本更新 日志管理 模板管理 常用选项 打印帮助信息 打印命令调用过程中的调试信息 检查命令正确性 指定输出格式 指定JSON文件传递API参数 指定请求超时时间
如KooCLI在执行命令的过程中未提示您如上所述的错误信息，但调用API的返回值显示region错误，可能是因您本地缓存cli-region列表的文件被修改，导致参数校验失其准确性。此时请您执行“hcloud meta clear”命令清理本地缓存文件后，重新调用； 如您的错误提示信息是英文，说明您此前已在配
”的系统参数，会提示相关错误信息。因为如上参数只支持被配置到配置项中使用，配置命令为“hcloud configure set --key1=value1 --key2=value2 ...”； 如KooCLI在命令执行过程中未提示您如上所述的错误信息，但调用API的返回值显示参
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
