检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
无配置方式ecsAgency 在用户已成功建立向弹性云（ECS）服务器的委托的前提下，在ECS服务器中使用KooCLI时，可以在命令中指定“--cli-mode=ecsAgency”，KooCLI将基于ECS委托，自动获取临时的AK/SK和SecurityToken用于认证。
您可通过直接在API Explorer上获取CLI示例，避免在命令中手动输入参数。 父主题： 其他
问题背景 KooCLI调用云服务API的过程中，会对您输入参数的合法性进行校验，此校验过程可能需要远程获取该云服务和API的详情信息；在参数校验完成后，亦需要远程调用您的目标API。
因同一API不同版本的参数、使用场景等可能存在差异，故须获取多版本服务API的版本信息。 云服务API的版本查询与指定 版本查询 您可以通过“hcloud <service> --help”命令，查看该云服务的operation列表。
在此校验过程中，KooCLI会获取该API中所有参数的详情信息，其中包括每个参数的类型、在request中的位置等信息。
通过KooCLI管理和使用您的各类云服务资源时，会远程获取您命令中目标云服务及其API的详情信息。为减少远程调用次数，提高响应速度，KooCLI引入了缓存机制，在运行过程中将云服务及其API的相关信息保存在本地缓存文件中，该文件称为元数据缓存文件。
获取访问密钥（AK/SK） 使用KooCLI管理和使用您的各类云服务资源时，需提供调用者（IAM用户）的身份信息用于认证鉴权。为完成初始化配置，您可点此了解和获取访问密钥。
更多 认证相关 如何获取永久AK/SK？ 如何获取账号名、账号ID、项目ID？ 如何获取区域？ 如何获取临时AK/SK和securitytoken？ 各认证方式的优先级是什么？ 更多 云服务API相关 提示不支持的operation时如何处理？ 如何指定云服务的API和版本号？
表1 常见问题概览 常见问题分类 相关链接 认证相关 如何获取永久AK/SK？ 如何获取账号ID、项目ID？ 如何获取区域？ 如何获取临时AK/SK和securitytoken？ 各认证方式的优先级是什么？ 配置项相关 命令中未指定配置项时默认使用哪个配置项？
元数据 KooCLI在命令执行过程中需要获取云服务及其API的详情信息，用于命令中参数的校验及解析，该数据称为元数据。远程获取的元数据会被保存在用户本地供后续使用，以减少命令执行过程中的网络IO，提高命令响应速度，保存元数据的文件称为元数据缓存文件。
待上传的文件可以是任何类型：文本文件、图片、视频等等。
若未在命令中传入该值，KooCLI会根据用户认证信息自动获取；但若缺少cli-access-key或cli-secret-key参数，或自动获取cli-domain-id失败，会提示如下错误： [USE_ERROR]参数cli-access-key,cli-secret-key必须同时输入
图1 入门流程 注册华为帐号，创建IAM用户并授权，获取访问密钥等，请参见步骤一：准备工作。 使用KooCLI调用API Explorer中各云服务开放的API，管理和使用您的各类云服务资源前，需要先下载对应操作系统的KooCLI，请参见步骤二：快速安装。
如下所示，命令中输入cli-region（调用的区域），project_id（项目ID）和server_id（云服务器ID）的参数值，按回车执行后，界面返回获取的云服务器信息。
hcloud configure init 开始初始化配置,其中"Secret Access Key"输入内容匿名化处理,获取参数可参考'https://support.huaweicloud.com/usermanual-hcli/hcli_09.html' Access Key
若目标API中不存在“region”同名参数，也不可自定义参数名称，KooCLI会在命令执行过程中自动将“--cli-region”识别为系统参数，其值用于获取目标API的详情信息，同时会忽略命令中传入的“--region”参数。
方法二 在API Explorer页面获取API参数，并写入JSON文件： 在原命令末尾加“--help”，从结果中的“Params”中查看目标API各参数的位置信息。
帮助 在“帮助”单击鼠标左键，您可以获取更多支持信息或查看隐私声明。 父主题： 在线体验
在线模式适用场景 会在KooCLI命令执行过程中获取元数据并缓存在用户本地，该元数据缓存文件具有时效性。后续执行KooCLI命令时，若文件已过期，会先更新文件内容，再以其完成命令校验及解析。
若目标API中存在与新系统参数或旧系统参数重名的参数，被写入jsonInput文件中的默认将被识别为该API的参数； “--cli-jsonInput”选项传入的JSON文件中，KooCLI会根据JSON最外层的Key获取并解析其的参数值，目前支持的Key包括：path、query
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
