检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
您可以通过下表了解KooCLI支持的所有OBS操作命令,各命令的参数与obsutil一致,参数详情可参考OBS服务桶相关命令,对象相关命令,辅助命令相关章节。 表2 KooCLI支持的所有OBS操作命令 类别 命令 功能 功能说明 命令结构 桶相关命令 mb 创建桶 在按照用户指定的桶名创建
参数相关 KooCLI系统参数包括哪些? 提示不正确的参数时如何处理? 为什么会有新旧KooCLI系统参数,如cli-region与region,推荐使用哪个? 提示重复的参数时如何处理? 如何使用cli-jsonInput?注意事项有哪些? 使用cli-jsonInput的场景有哪些?
KooCLI系统参数包括哪些? 系统参数 KooCLI系统参数是指其内置参数,各系统参数的描述信息及其使用方式如下表所示: 表1 KooCLI新系统参数 参数 参数描述 使用方式 help 打印帮助信息 命令中直接使用 debug 打印调试信息 命令中直接使用 dryrun 执行校验后打印请求报文
提示不正确的参数时如何处理? 问题背景 通过KooCLI管理和使用您的各类云服务资源时,在调用云服务API的过程中,会对您输入参数的合法性进行校验。若您在命令中输入了当前API不支持的参数,或将只允许配置在配置项中使用的参数在命令直接传入,会提示如下错误: [USE_ERROR]不正确的参数:*
请您检查是否误输。若存在,则您可能需要将同名的两个参数用于不同用途,即:其一作为目标API参数,另一作为系统参数。您可根据提示信息,使用新系统参数替换原命令中的旧系统参数。当命令中同时存在同一系统参数的新旧两种形式时,例如命令中存在“--cli-region=${regionValue1}
KooCLI执行过程中会校验参数值是否匹配,若将不适合的空值传给参数,会提醒错误信息。例如给实际为map类型的参数“os-stop”赋值数组类型的空值“[]”,则提示如下错误: [USE_ERROR]map类型参数os-stop的值不正确 父主题: 参数相关
提示不支持的参数位置/类型时如何处理? 问题背景 通过KooCLI管理和使用您的各类云服务资源,在调用云服务API的过程中,KooCLI会对您输入参数的合法性进行校验。在此校验过程中,KooCLI会获取该API中所有参数的详情信息,其中包括每个参数的类型、在request中的位置
支持新系统参数,是因为在KooCLI上开放的云服务中,存在部分API的某参数与旧系统参数重名的情况。该场景可能会使命令中两个同名的参数用于不同的用途,即:其一作为目标API参数,另一作为系统参数。在命令执行过程中会对参数的合法性进行检查,若命令中存在重复参数,则会提示如下错误: [USE_ERROR]重复的参数*
以JSON文件的方式传递API参数 KooCLI调用云服务的API时,如果API的参数过多,不便直接在命令中传入,用户可通过“--cli-jsonInput”将云服务API的部分或全部参数以JSON文件的形式输入。剩余的其他参数,例如KooCLI系统参数、未通过JSON文件传入的云服务API参数等,仍可在命令中传入,例如:
命令中服务名、operation、参数的value值是否需要使用双引号引起? 需要视参数value的具体内容而定。 一般情况下,命令中的服务名、operation、参数的value值可不必使用双引号引起。但若您命令中的服务名、operation、参数的value值中有特殊符号、空
云服务的API参数名称中带有“.”,KooCLI可能无法正确解析该参数,此时需通过cli-jsonInput传入该API的参数; 云服务的API在不同位置中有同名的参数时,KooCLI无法正确解析该API的参数,此时需通过cli-jsonInput传入该API的参数; 用户输入的
如何使用cli-jsonInput?注意事项有哪些? 问题背景 命令提示符(cmd.exe)等工具对使用时输入的字符串的最大长度有限制。当需要执行的命令的参数过多或参数值过长时,可能会因为其长度限制导致命令输入不完整。因此KooCLI除了支持参数在命令中直接输入之外,也支持使用“--cli-jso
设置配置项中的custom参数 KooCLI支持向配置项中设置custom参数,方便用户集中管理命令中高频使用,参数值过长,或需要对其值加密处理的参数。使用如下命令进入交互模式,根据提示新增或修改配置项中的custom参数: hcloud configure set [--cli
设置配置项中的系统参数 设置配置项中的系统参数的示例如下: 增加配置项 新增配置项时,以“--cli-profile”声明配置项的名称,示例如下: 新增认证模式为AK/SK的配置项,其中认证参数为访问密钥,即永久AK(cli-access-key)和SK(cli-secret-key):
"EcsName": "ecs-8f88" } ] “--cli-json-filter”也可以用于系统命令,例如查询名称为test的配置项的所有custom参数: hcloud configure list --cli-custom=true --cli-json-filter="profiles[
删除指定配置项及其custom参数 使用“--cli-profile”指定要删除的配置项的名称。删除指定配置项的命令为: hcloud configure delete --cli-profile=${profileName} hcloud configure delete --cli-profile=test
e} --cli-region=${regionValue}”命令将其配置到目标配置项中。后续使用该配置项调用API时,命令中可以不必输入cli-region;但若目标API不支持该cli-region,则您仍需在命令中通过“--cli-region=${regionValue}”传入支持的cli-region。
查询指定配置项中的custom参数 使用“--cli-profile”指定要查询的配置项的名称,支持以table,json或tsv格式输出,默认为json格式。查看指定配置项中的custom参数的命令为: hcloud configure show [--cli-profile=${profileName}]
步骤四:查看与执行云服务操作命令 本节以Windows系统为例介绍KooCLI的使用,Linux和Mac系统的使用基本相同,可参考。 完成初始化配置后,即可查询KooCLI支持的云服务列表,并执行相关命令。下文以弹性云服务器(ECS)的查询云服务器详情的API为例,说明如何查找与执行命令。 查询云服务的operation列表
KooCLI与输出相关的系统参数有哪些,推荐使用哪些? KooCLI与输出相关的参数如下: 表1 KooCLI与输出相关的参数 参数分组 参数 参数用途 新输出参数 cli-output,cli-query,cli-output-num cli-output 响应数据的输出格式,取值可以为如下其一: