检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
约束和限制 每个用户最多可以创建两个有效的访问密钥，其一旦生成永久有效。 查找已下载的访问密钥 若您已生成且下载过访问密钥（AK和SK），可在本地查找已下载的AK/SK文件，文件名一般为：credentials.csv。 如下图所示，文件包含了用户名称（User Name），AK（Access
Value}”，重新调用； 如您有常用的区域，可使用“hcloud configure set --cli-profile=${profileName} --cli-region=${regionValue}”命令将其配置到目标配置项中。后续使用该配置项调用API时，命令中可以不
数不正确造成的错误，请根据错误提示做相应修改； [OPENAPI_ERROR]：一般是调用云服务API时发生的错误，请联系相关云服务oncall协助处理； [APIE_ERROR]：一般是调用API Explorer获取元数据时发生的错误，请联系API Explorer云服务oncall协助处理。
在Linux系统上安装KooCLI 在MacOS系统上安装KooCLI 在Docker中配置和使用KooCLI 您也可以从下表中直接下载适配您目标系统的KooCLI到本地，再将其上传至您的目标机器，解压后即可使用： 表1 下载地址 操作系统 下载地址 隐私声明 Windows 64位 KooCLI-windows-amd64
密钥等，请参见步骤一：准备工作。 使用KooCLI调用API Explorer中各云服务开放的API，管理和使用您的各类云服务资源前，需要先下载对应操作系统的KooCLI，请参见步骤二：快速安装。 使用KooCLI时，需要获取调用者的身份信息用以认证鉴权。如您不是以无配置方式使用
检查配置文件格式 为快速检验本地配置文件的格式是否正确，可执行如下命令： hcloud configure test hcloud configure test 配置文件格式正确 父主题： 配置信息管理
选项说明 选项概述 打印帮助信息 打印命令调用过程中的调试信息 生成JSON格式API入参骨架 检查命令正确性 指定区域 以无配置方式AKSK调用云服务API 指定用户所属账号ID 指定配置项 指定配置项的认证模式 指定结果的输出格式 以JSON文件的方式传递API参数 指定请求超时时间
动跳转至您的个人信息界面。 完成个人实名认证或企业实名认证。 创建IAM用户并授权 使用KooCLI管理和使用您的各类云服务资源时，需提供调用者（IAM用户）的身份信息用于认证鉴权。 IAM用户是由华为帐号在IAM中创建的用户，是云服务的使用人员，具有独立的身份凭证，根据华为帐号
Explorer页面填写完成各项请求参数后，CLI示例会及时刷新命令内容。您可以将填写好请求参数的CLI示例保存，后续在KooCLI中直接调用，或集成到脚本中调用。 图1 在API Explorer上获取CLI示例 在API Explorer界面上，已填写值的参数，才会体现在CLI示例中。
打印命令调用过程中的调试信息 KooCLI支持打印命令执行过程中的调试信息。在命令中添加“--debug”即可： hcloud VPC ShowVpc/v3 --cli-region="cn-north-4" --project_id="0dd8cb****************19b5a84546"
版本更新 KooCLI支持本地更新， 运行更新命令经交互确认后可将其升级至最新版本。 更新命令如下： hcloud update hcloud update KooCLI将更新到最新版本,请您确认是否继续(y/N): y 更新成功 执行版本更新命令时，在命令中添加“-y”参数，可跳过交互确认，直接更新：
int 轮询的间隔时间(秒),min=2,max=10,默认值5 需要注意的是，因为使用“--cli-waiter”可能会导致调用接口幂等性的问题，有重复调用的风险，请您谨慎使用。建议查询类接口使用此参数。 父主题： 选项说明
{jsonFileName}”传入JSON文件，向KooCLI传递云服务API参数。KooCLI会在运行时解析并使用该JSON文件中的参数调用目标API。 使用方式 cli-jsonInput的使用方式请参考：以JSON文件的方式传递API参数。 注意事项 “--cli-json
令非法，或已输入的参数名非法，则不再提示任何信息。 参数值 在交互式中，在部分参数名后输入等号，会提示该参数的可取值或默认值列表。例如：若调用API的命令中当前输入的参数是“--cli-region=”时，会提示该API的可选区域列表。 图7 交互式中提示已输入云服务API的可选区域列表
查看指定云服务的operation列表。例如查看“ECS”服务的operation列表：hcloud ECS --help hcloud <service> <operation> --help 查看指定云服务API的详情信息。例如查看“ECS”服务中，operation为“ShowServer”的API详情：hcloud
指定用户所属账号ID KooCLI以AKSK模式调用全局服务的API时，需添加账号ID（即cli-domain-id）。KooCLI会在调用全局服务的API的过程中，根据用户认证信息自动获取账号ID，用户也可在命令中添加“--cli-domain-id”选项，如下： hcloud
如何卸载KooCLI？ KooCLI无需安装，下载解压后即可使用。因此您在卸载时仅需要删除该工具及相关本地缓存文件即可。请参考如下步骤： 执行“hcloud auto-complete off”命令关闭自动补全； 删除缓存文件，配置文件及日志文件： Linux系统： /home/{当前用户名}/
name和permission set name时，请使用键盘上下箭头移动，可键入筛选列表内容，按Enter键即可选中当前内容。 SSO登录完成后，仅支持调用此列表中服务的API。 登录完成后，可使用命令查看登录后保存的认证信息及其过期时间： hcloud configure show --cl
审计与日志 由于KooCLI是部署在用户本地的客户端工具，工具本身记录的日志可以作为审计目的使用，但是需要用户对日志进行访问权限控制以达到审计日志不可篡改的目的。此外， 同使用SDK一样，KooCLI将用户命令解析成https请求发送到API Gateway后，API Gateway记录的相关信息也可用作审计目的。
检查命令正确性 dryrun选项用于检查所传入命令的正确性。在命令中添加“--dryrun”选项，执行校验后打印请求报文，跳过实际运行，不调用目标API： hcloud RDS CreateConfiguration --cli-region="cn-north-4" --pro
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
