检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
} ] } 用户可根据查询结果中的模板的“description”了解模板的用途；单击其“detail_url”链接，可跳转至Codelabs页面查看模板详情；“id”是模板的唯一标识，用户可根据id值下载对应的模板至本地。 当前KooCLI模板示例持续开发中，敬请期待。 下载指定模板：
修改已初始化的配置项 KooCLI目前支持在配置项中以如下组合方式配置认证参数：访问密钥（永久AK/SK），临时安全凭证（临时AK/SK和SecurityToken）两种。 其中，临时安全凭证（临时AK/SK和SecurityToken）具有时效性。 初始化配置信息时，配置项的名
认证方式优先级 KooCLI在命令解析过程中，依照如下优先级使用其认证方式，完成调用API时的认证流程： 无配置方式AKSK认证： 无配置方式AKSK：命令中直接输入访问密钥（永久AK/SK，即cli-access-key和cli-secret-key）或临时安全凭证（临时AK/
KooCLI管理和使用云服务的资源，用户在配置了HTTP代理的情况下，可能会出现调用云服务API时报错 x509 的问题。其原因是您公司代理修改了https网站颁发的根证书，导致访问外网的https资源时报证书无效的错误。 您可以通过在命令中添加“--cli-skip-secur
储在配置文件中，如下表所示，避免使用时频繁输入这些固定信息： 表1 初始化时的参数 参数 说明 Access Key ID 访问密钥（永久AK/SK）中的访问密钥ID，简称AK，初始化时必填。 Secret Access Key 访问密钥（永久AK/SK）中的密码访问密钥，简称SK，初始化时必填。
获取账号ID、项目ID 在调用云服务API的时候，大多数场景需要填入项目ID。项目ID获取步骤如下： 注册并登录管理控制台。 单击右上角用户名，在下拉列表中单击“我的凭证”，查看“账号ID（cli-domain-id）”、“项目ID（cli-project-id）”，如下图。 项
息。 SSO：开通IAM身份中心并完成配置后，允许用户使用特定用户名和密码登录统一的用户门户网站，访问为其分配的多个账号下的资源。认证信息有效期内，无需多次登录。 cli-region 区域。 cli-access-key 访问密钥ID（Access Key ID，简称AK），此参数必须和SK同步修改。
本模板，方便用户理清业务逻辑，完成复杂场景下的操作。用户可根据实际需要下载相应的模板，修改后执行即可。 发布区域：全部 模板管理 常用选项 KooCLI选项是指可以直接在调用API的命令中添加的KooCLI系统参数。 发布区域：全部 打印帮助信息 打印命令调用过程中的调试信息 检查命令正确性
--key2=value2 ...”命令配置到配置项后再使用。使用时在命令中通过“--cli-profile=${profileName}”指定配置项名称，KooCLI即会在运行过程中解析并使用该配置项中配置的各项参数值。 若在命令中直接使用该类参数，会提示如下错误： [USE_ERROR]不正确的参数:*
如何解决网络连接超时问题？ 问题背景 KooCLI调用云服务API的过程中，会对您输入参数的合法性进行校验，此校验过程可能需要远程获取该云服务和API的详情信息；在参数校验完成后，亦需要远程调用您的目标API。如在调用过程中因网络连接问题导致请求失败，会提示相关错误，例如： [NETWORK_ERROR]连接超时
另外，若云服务的API中存在（或可自定义）与旧系统参数同名的参数，则若该参数出现在命令中，KooCLI将无法确认该参数作何种用途。故在解析该命令的过程中，会通过交互向信息向用户确认该参数的实际用途，避免解析错误。例如： 目标API中存在与KooCLI系统参数%s同名的参数,无法识别命令中%s的位置
请查看选项列表。 元数据 KooCLI在命令执行过程中需要获取云服务及其API的详情信息，用于命令中参数的校验及解析，该数据称为元数据。远程获取的元数据会被保存在用户本地供后续使用，以减少命令执行过程中的网络IO，提高命令响应速度，保存元数据的文件称为元数据缓存文件。请查看如何管理元数据缓存文件。
图1为KooCLI大致的入门流程，本入门指导旨在帮助您对其操作有初步的认识。 图1 入门流程 注册华为帐号，创建IAM用户并授权，获取访问密钥等，请参见步骤一：准备工作。 使用KooCLI调用API Explorer中各云服务开放的API，管理和使用您的各类云服务资源前，需要先下载对应操作系统的KooCLI，请参见步骤二：快速安装。
KooCLI调用云服务的API时，如果API的参数过多，不便直接在命令中传入，用户可通过“--cli-jsonInput”将云服务API的部分或全部参数以JSON文件的形式输入。剩余的其他参数，例如KooCLI系统参数、未通过JSON文件传入的云服务API参数等，仍可在命令中传入，例如： hcloud ECS CreateServers
指定请求超时时间 cli-connect-timeout，cli-read-timeout 选项用于设置请求超时时间。其中请求连接超时时间“--cli-connect-timeout”默认值为5秒，I/O超时时间“--cli-read-timeout”默认值为10秒： hcloud
[NETWORK_ERROR]：一般是HTTP请求异常，请检查网络连接； [CLI_ERROR]：一般是因KooCLI处理命令过程中本身的异常导致的错误，请联系KooCLI的oncall协助处理； [USE_ERROR]：一般是因命令中参数不正确造成的错误，请根据错误提示做相应修改； [OP
L：清除屏幕 若用户尚未添加配置项，或默认配置项中的区域不被命令中的API所支持，用户需先根据提示，从目标API支持的cli-region列表中选择合适的区域值。确定区域后，KooCLI会继续提示该API的参数列表。 交互式提示参数时，除自定义map类型的参数（即：参数名中包含“{*}
通过KooCLI管理和使用您的各类云服务资源时，会远程获取您命令中目标云服务及其API的详情信息。为减少远程调用次数，提高响应速度，KooCLI引入了缓存机制，在运行过程中将云服务及其API的相关信息保存在本地缓存文件中，该文件称为元数据缓存文件。在元数据缓存文件过期前，会使用该文件中的信息对命令中的参数进行校验和组装。
KooCLI会缓存API调用过程中获取并保存在用户本地的元数据缓存文件，放置在如下目录下： 在线模式： Windows系统： C:\Users\{您的Windows系统用户名}\.hcloud\metaRepo\ Linux系统: /home/{当前用户名}/.hcloud/metaRepo/
会在KooCLI命令执行过程中获取元数据并缓存在用户本地，该元数据缓存文件具有时效性。后续执行KooCLI命令时，若文件已过期，会先更新文件内容，再以其完成命令校验及解析。此模式下，仅保存用户已执行命令相关的元数据，并支持用户通过KooCLI调用新上线的云服务或API。适用于用户即时执行任意K
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
