检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
结果为空,CLI不会打印相应返回体,用户无法确认是否调用成功。 解决步骤 在原命令中添加“--debug”参数,可打印命令调用过程中的调试信息。其中包含一行内容为“API response status code is xxx.”。用户可以根据该返回体的状态码判断命令是否成功调用。
新输出参数的使用方法请参考:指定结果的输出格式。 命令中使用“--cli-query”用于传入JMESPath表达式,对结果执行JMESPath查询,方便提炼原返回结果中的关键信息;“--cli-output”用于指定响应数据的输出格式;“--cli-output-num”用于指定当使用table格式输出时,是否打印行号。
配置项 配置项用于存储一组调用云服务API时所需的公共信息,由用户通过调用KooCLI命令完成配置。各配置项组成配置文件,存储在用户本地。用户在调用云服务API时,可通过指定配置项,代替这组公共信息的输入。 配置项支持配置的公共信息包括:访问密钥(AK/SK)、区域(cli-regi
出格式,您也可以配合使用“--cli-query”选项传入JMESPath表达式,对json结果执行JMESPath查询,以过滤出您需要的信息。输出效果可参考此示例:指定结果的输出格式。构造JMESPath表达式,请参考如何定义JMESPath表达式。 父主题: 输出格式相关
函数参数有类型限制。如果函数的参数类型错误,KooCLI会提示错误告警信息并输出原json结果。有些函数可以进行类型转换(to_string、to_number)以帮助将参数转换为正确的类型。 函数参数有个数限制。如果调用函数时入参个数错误,KooCLI会提示错误告警信息并输出原json结果。 父主题: 如何定义JMESPath表达式
服务的服务名称/该系统命令的描述信息。 API 已输入的云服务/系统命令经校验无误后,会继续提示该服务的API列表/该系统命令的子命令(或参数)。 所提示的系统命令列表中,左列展示该系统命令的子命令(或参数),右列展示该子命令(或参数)的描述信息。 图2 交互式中提示云服务的API列表
目的。此外, 同使用SDK一样,KooCLI将用户命令解析成https请求发送到API Gateway后,API Gateway记录的相关信息也可用作审计目的。 详情请见日志管理。 父主题: 安全
时AK/SK和SecurityToken)两种。 其中,临时安全凭证(临时AK/SK和SecurityToken)具有时效性。 初始化配置信息时,配置项的名称为“default”,且初始化时配置项中只允许配置永久AK/SK。如果您要使用其他认证方式,或修改初始化的配置项中的参数值,可使用“hcloud
无配置方式使用KooCLI需要注意什么? 无配置方式使用是指在使用KooCLI时不通过已有配置项传入当前用户的认证信息,而是直接在命令中传入当前用户认证相关的参数。此方式可使用户免于添加配置项,方便快捷。具体使用方式请参考:无配置方式使用KooCLI。 无配置方式使用KooCLI时,需要注意如下事项:
KooCLI系统参数包括哪些? 系统参数 KooCLI系统参数是指其内置参数,各系统参数的描述信息及其使用方式如下表所示: 表1 KooCLI新系统参数 参数 参数描述 使用方式 help 打印帮助信息 命令中直接使用 debug 打印调试信息 命令中直接使用 dryrun 执行校验后打印请求报文,跳过实际运行
如KooCLI在执行命令的过程中未提示您如上所述的错误信息,但调用API的返回值显示region错误,可能是因您本地缓存cli-region列表的文件被修改,导致参数校验失其准确性。此时请您执行“hcloud meta clear”命令清理本地缓存文件后,重新调用; 如您的错误提示信息是英文,说明您此前已在配
实例启动后默认将当前CLI示例内容复制到实例窗口并执行。 图2 实例启动后默认复制当前CLI示例内容到实例窗口 实例启动时,默认将已登录账号的认证信息配置到名为“default”的配置项中,实现自动授权。用户无需额外配置即可使用KooCLI管理云资源,方便快捷。 每个实例可使用时长为60
hcloud命令(完成本步骤之前,请确保PATH系统变量值中存在“/usr/local/bin/”路径)。 您可在该命令执行过程中根据交互信息修改文件下载目录等。如执行过程中提示权限不足,您可切换至root用户重新执行安装命令。 若您希望使用其默认配置且跳过交互模式,可在该命令末尾添加“-y”,如下:
hcloud命令(完成本步骤之前,请确保PATH系统变量值中存在“/usr/local/bin/”路径)。 您可在该命令执行过程中根据交互信息修改文件下载目录等。如执行过程中提示权限不足,您可切换至root用户重新执行该安装命令。 若您希望使用其默认配置且跳过交互模式,可在该命令末尾添加“-y”,如下:
Explorer上获取CLI示例 在API Explorer界面上,已填写值的参数,才会体现在CLI示例中。 CLI示例会携带项目ID,区域等信息,如果您在其他项目或区域中使用,请注意替换成对应的项目ID与区域。
云服务的API可在API Explorer上查看。您可以在API Explorer上先填写好各参数的值,即可从“CLI示例”页签中直接获取命令。 KooCLI帮助信息查询 具体查询方法可参考查看与执行云服务操作命令,Mac和Linux系统下查询方法类似。 通过KooCLI调用云服务API。 输入完整的API调用命令后回车,即完成调用。
通过“--cli-jsonInput”选项传入API参数时,首先需要编写一个JSON文件,在该文件中,各API参数需要根据其在request中的位置信息被放在对应的Key下。 构造JSON文件的方法有如下两种: 方法一 使用“--skeleton”生成并填写JSON格式API入参骨架文件,
例的数量不会因为您打开新的终端而增加。 在“新建终端”单击鼠标左键,即可创建一个新终端。 帮助 在“帮助”单击鼠标左键,您可以获取更多支持信息或查看隐私声明。 父主题: 在线体验
--project_id required string path 项目ID。若命令中未输入,将根据认证信息获取指定区域的父级项目ID,或使用当前配置项中的cli-project-id --os-stop.type optional
中的命令。若结果中仍不存在该云服务,则该云服务未在KooCLI离线模式中上线,请等待离线数据包更新,或切换至在线模式尝试; 如您的错误提示信息是英文,说明您此前已在配置中将KooCLI语言设置为英文,或KooCLI判断您的系统语言为英文。目前英文环境下KooCLI中上线的云服务与