检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
--cli-output-cols:table输出时,指定需要打印的字段; --cli-output-rows:table输出时,指定需要打印的层级。例如希望表格化一个json结构体,则参数值填写该json结构体的名称。 --cli-output-num:table输出时,是否打印表格的行号。取值为true或false,默认为true。
以table输出调用结果时,“--cli-output-rows”指定json结构体的层级,即表格的数据来源;“--cli-output-cols”指定表格的列名,需要与json结构体中的字段相对应;“--cli-output-num”指定是否打印表格行号,默认值为true,如下图所示: hcloud ECS NovaListServers
在使用时的注意事项有哪些? 新输出参数的使用方法请参考:指定结果的输出格式。 命令中使用“--cli-query”用于传入JMESPath表达式,对结果执行JMESPath查询,方便提炼原返回结果中的关键信息;“--cli-output”用于指定响应数据的输出格式;“--cli-
KooCLI与输出相关的系统参数有哪些,推荐使用哪些? KooCLI与输出相关的参数如下: 表1 KooCLI与输出相关的参数 参数分组 参数 参数用途 新输出参数 cli-output,cli-query,cli-output-num cli-output 响应数据的输出格式,取值可以为如下其一:
如遇如上情形,您可以通过执行“hcloud <service> <operation> --help”命令,对比输出结果中“Params”的内容,即当前API的参数列表,若其中不存在该参数,可能是因为如下原因: 若您已使用在线模式,则该API不支持该参数,请根据输出结果中“Params”的内容修改该参数;
突而引起错误或交互,推荐使用新系统参数。 新增系统参数将添加至新系统参数列表中。旧系统参数将仅维持其已有功能,不再持续升级。 旧系统参数 KooCLI旧系统参数的描述信息及其对应的新系统参数如下表所示: 表1 KooCLI旧系统参数 旧系统参数 参数描述 其对应的新系统参数 region
jsonInput=${JSON文件名}”传入。 方法二 在API Explorer页面获取API参数,并写入JSON文件: 在原命令末尾加“--help”,从结果中的“Params”中查看目标API各参数的位置信息。 创建JSON文件,建议其名称为“${服务名}_${API名}
"type": { "Required": true, "ParamType": "string", "Usage": "数据库引擎,不区分大小写:\n- MySQL\n- PostgreSQL\n- SQLServer\n- MariaDB", "EnumValue":
如果返回结果中包含“Bucket number :”,表明配置正确。 如果返回结果中包含“Http status [403]”,表明访问密钥配置有误,或没有获取桶列表的权限,需要视具体场景进一步确认根因。 如果返回结果中包含“A connection attempt failed”,表明无法连接OBS服务,请检查网络环境是否正常。
status的值达到期待结果ACTIVE ACTIVE cli-waiter的取值中,每个字段的含义如下: - expr required string 使用JMESPath表达式指定被轮询字段 - to required string 被轮询字段的目标值 - timeout optional int 轮询的超时时间(秒)
ESPath表达式不同,输出的结果中各参数的排列顺序可能不同。部分表达式的输出结果不会带有输出数据的属性名(即参数的key值),故用户需对输出数据的顺序有所把握,以便于数据处理。不同类型的JMESPath表达式,输出结果的顺序如下表所示: 表1 不同JMESPath表达式的数据输出顺序
"up" ] ] 在上面的表述中,[name,state.name]部分是多选列表。该表达式表示要创建两个元素的列表,第一个元素是针对列表元素评估name表达式的结果,第二个元素是评估state.name的结果。因此,每个列表元素都会创建一个双元素列表,整个表达式的最终结果是一个包含两个元素列表的列表。
--help”命令,查看该云服务的operation列表。若在查询结果的“Available Operations”中某operation出现多次,且以“/”拼接了不同的版本号,则调用该API时需要指定其版本信息,方法请参考版本指定。其余在该云服务operation列表中只出现了一次的operatio
信息中支持的cli-region列表,修改命令中的cli-region值,重新调用; 命令中未指定cli-region值,KooCLI会在运行过程中解析并使用当前配置项中的cli-region值。您可根据错误提示中支持的cli-region列表,在当前命令中添加“--cli-re
--help”命令,查看该云服务支持的operation列表,确认operation是否误输; 如您确认operation无误,但是在执行上一步“hcloud <service> --help”命令的输出结果中,“Available Operations”列表中不存在该operation,可能是因为如下原因:
object(键值对的无序集合) expression(用&expression表示的表达式) null 各内置函数支持的数据类型不同。具体如下表。函数参数中一个特殊字符“@”代表将当前结果作为入参传递给函数: 表1 JMESPath表达式支持的内置函数 内置函数 入参数据类型 出参数据类型 用途
[APIE_ERROR]:一般是调用API Explorer获取元数据时发生的错误,请联系API Explorer云服务oncall协助处理。 您也可以根据下表常见问题概览查找所需内容。 表1 常见问题概览 常见问题分类 相关链接 认证相关 如何获取永久AK/SK? 如何获取账号ID、项目ID? 如何获取区域?
KooCLI版本:2.1.6 优化表格化输出:“cli-output-rows”指定的数组类参数支持其索引以“:”拼接起始位至结束位;优化表格化输出相关错误提示信息。 公测 使用cli-output-rows,cli-output-cols,cli-output-num指定表格化输出的内容 2020年12月
--cli-profile=default operation operation是指云服务在API Explorer上发布的API的英文名称,可唯一表达某API。云服务的operation列表可从API Explorer上查询,或执行“hcloud <service> --help”命令获取。 配置项 配置项
--help”命令,查看当前支持的所有云服务,确认服务名称是否有误; 如您确认服务名无误,但是上一步执行“hcloud --help”命令的输出结果中,“可用服务”列表中不存在该云服务,可能是因为如下原因: 若您已使用在线模式,则该云服务未在KooCLI上线; 若您已使用离线模式,可能是您当前使用的离线数据