检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查看帮助信息 KooCLI支持在命令中添加“--help”参数查看帮助信息,例如: hcloud --help 查看KooCLI的使用方法及支持的云服务列表。 hcloud <service> --help 查看指定云服务的operation列表。例如查看“ECS”服务的operation列表:hcloud
求证书验证(不建议)。当用户已配置HTTP代理,KooCLI调用云服务的API时,可能会因证书校验失败,导致请求报错x509。用户可在命令中添加“--cli-skip-secure-verify=true”后执行原命令,在执行时会向用户交互以确认是否跳过https请求证书验证: hcloud
Interface,KooCLI,原名HCloud CLI)是为发布在API Explorer上的云服务API提供的命令行管理工具。您可以通过此工具调用API Explorer中各云服务开放的API,管理和使用您的各类云服务资源。 KooCLI只提供了一种通过CLI调用云服务API的方法。在使用KooCLI之前,您需
原命令中的旧系统参数。当命令中同时存在同一系统参数的新旧两种形式时,例如命令中存在“--cli-region=${regionValue1} --region=${regionValue2}”,KooCLI会根据当前API的参数列表自动识别各个参数的用途: 若目标API中存在“r
x509 的问题。其原因是您公司代理修改了https网站颁发的根证书,导致访问外网的https资源时报证书无效的错误。 您可以通过在命令中添加“--cli-skip-secure-verify=true”跳过证书校验(不建议)。推荐的做法是:将您公司颁发的证书导入到操作系统的可信任CA证书下。
--help”命令,查看当前支持的所有云服务,确认服务名称是否有误; 如您确认服务名无误,但是上一步执行“hcloud --help”命令的输出结果中,“可用服务”列表中不存在该云服务,可能是因为如下原因: 若您已使用在线模式,则该云服务未在KooCLI上线; 若您已使用离线模式,可能是您当前使用的
--key2=value2 ...”命令配置到配置项后再使用。使用时在命令中通过“--cli-profile=${profileName}”指定配置项名称,KooCLI即会在运行过程中解析并使用该配置项中配置的各项参数值。 若在命令中直接使用该类参数,会提示如下错误: [USE_ERROR]不正确的参数:*
息存储在配置文件中,如下表所示,避免使用时频繁输入这些固定信息: 表1 初始化时的参数 参数 说明 Access Key ID 访问密钥(永久AK/SK)中的访问密钥ID,简称AK,初始化时必填。 Secret Access Key 访问密钥(永久AK/SK)中的密码访问密钥,简称SK,初始化时必填。
KooCLI既可以使用配置项调用云服务API,也提供了无配置的操作方式,无配置方式使用是指在使用KooCLI时不通过已有配置项传入当前用户的认证信息,而是直接在命令中传入当前用户认证相关的参数。此方式可使用户免于添加配置项,方便快捷地使用KooCLI。用户可以通过如下认证方式直接调用云服务API: 无配置方式AKSK
加密传输(https) KooCLI与华为云API Gateway之间的通信传输采用https协议,有效防止数据被篡改,保护用户数据在网络中的传输安全。加密协议为业界公认安全性较高的TLS1.2、TLS1.3。 敏感数据保护 用户使用KooCLI配置的认证凭据(如AK/SK)、自定义变量支持加密方式存储。
创建IAM用户并授权 使用KooCLI管理和使用您的各类云服务资源时,需提供调用者(IAM用户)的身份信息用于认证鉴权。 IAM用户是由华为帐号在IAM中创建的用户,是云服务的使用人员,具有独立的身份凭证,根据华为帐号授予的权限使用资源,可以确保华为帐号及资源的安全性。IAM用户不进行独立的计费,由所属华为帐号统一付费。
请查看选项列表。 元数据 KooCLI在命令执行过程中需要获取云服务及其API的详情信息,用于命令中参数的校验及解析,该数据称为元数据。远程获取的元数据会被保存在用户本地供后续使用,以减少命令执行过程中的网络IO,提高命令响应速度,保存元数据的文件称为元数据缓存文件。请查看如何管理元数据缓存文件。
JSON文件中的参数调用目标API。 使用方式 cli-jsonInput的使用方式请参考:以JSON文件的方式传递API参数。 注意事项 “--cli-jsonInput”选项传入的JSON文件中目前只支持写入云服务的API参数,不支持写入系统参数。若目标API中存在与新系统参
其左侧的图标可获取对应区域下的子项目ID。 图1 账号ID、项目ID KooCLI可在API调用过程中, 根据当前用户认证信息自行获取请求头中需要的账号ID、项目ID,因此命令中可不输入该参数。 父主题: 获取认证信息
择“属性”。单击“高级系统设置”链接,然后单击“环境变量”。 进入环境变量图形界面,在“用户变量”列表中,选中变量名为“Path”的环境变量,单击“编辑”。 在编辑环境变量界面中单机“新建”,输入hcloud.exe文件所在目录的路径。 单击三次“确定”,即可保存该修改。 (可选
新增或修改配置项 概述 设置配置项中的系统参数 设置配置项中的custom参数 父主题: 配置信息管理
查询指定配置项 查询指定配置项中的系统参数 查询指定配置项中的custom参数 父主题: 配置信息管理
查询配置项列表 查询配置项列表中的系统参数 查询配置项列表中的custom参数 父主题: 配置信息管理
相应的认证参数: 若配置项的认证模式为“AKSK”,则配置时命令中“--cli-access-key”和“--cli-secret-key”的值不能为空; 若配置项的认证模式为“ecsAgency”,则配置时命令中需指定“--cli-mode=ecsAgency”; 父主题: 选项说明
当前可调用的区域.若命令中未输入,将使用当前配置项中的cli-region --project_id required string path 项目ID。若命令中未输入,将根据认证信息获取指定区域的父级项目ID,或使用当前配置项中的cli-project-id