如何使用CLI

安装KooCLI

在使用KooCLI前，您需要先安装KooCLI。KooCLI支持Windows、Linux和macOS三种操作系统，请根据您机器所使用的操作系统，安装对应版本的工具。

• 在Windows系统上安装KooCLI
• 在Linux系统上安装KooCLI
• 在MacOS系统上安装KooCLI
• 在Docker中配置和使用KooCLI

配置KooCLI初始化

使用KooCLI调用API时，需要获取调用者的身份信息用于认证鉴权。通过配置KooCLI初始化，可以把永久AK/SK信息存储在配置文件中，避免在调用API时频繁输入这些固定信息。

如果您不希望通过配置文件传入认证信息，而是直接在命令中传入认证相关参数，可跳过此步骤，具体操作可参见以无配置方式使用KooCLI。

此处以Windows系统为例介绍如何配置KooCLI的初始化，Linux和macOS系统的操作类似。在配置初始化前，您需要提前获取AK/SK信息，具体操作请参见新增访问密钥。

1. 打开命令行窗口。
2. 执行以下命令进行初始化配置。

   hcloud configure init

3. 根据界面提示输入各参数值。

   Access Key ID [required]:      //必填，输入AK 
   Secret Access Key [required]:      //必填，输入SK，输入内容时系统会匿名化处理 
   Secret Access Key (again):      //必填，再次输入SK，输入内容时系统会匿名化处理 
   Region:      //选填，输入Region

   完成后，界面提示“初始化配置成功”。

生成和执行CLI命令

KooCLI支持两种命令生成方式：

• 通过API Explorer快速生成并获取调用API的CLI命令。推荐通过API Explorer获取CLI命令，更方便快捷。
• 通过CLI命令查询API的操作命令和相关参数信息，然后手动拼接调用API的CLI命令，具体操作可参见查看与执行云服务操作命令。

此处以制品仓库（CodeArts Artifact）的查询发布库版本列表API为例，介绍如何从API Explorer生成CLI命令，然后执行CLI命令调用API。

1. 在API Explorer的制品仓库服务页面，选择要生成CLI命令的API。
2. 在中间的参数配置界面中，填写调用API所需的参数。
3. 在右侧界面选择“CLI示例”页签，可查看生成的CLI命令。

   查询发布库版本列表API的CLI命令示例如下。

   hcloud CodeArtsArtifact ShowVersionList --cli-region="cn-north-1" --project_id="8e467d4c679c4519ac2d582e316a8aa0"

4. 复制生成的CLI命令，并粘贴到命令行窗口中执行。

   查询发布库版本列表API的CLI命令执行结果示例如下。

    {
    "status": "success",
    "trace_id": "508960-1789008687410-4030",
    "result": [
     {
      "category": "--",
      "build_version": "latest",
      "files_count": 3
     },
     {
      "category": "test",
      "build_version": "1.0",
      "files_count": 16
     }
    ]
   }