文档首页/ 云应用引擎 CAE/ CLI参考/ 如何使用CLI
更新时间：2026-09-15 GMT+08:00
查看PDF
分享

如何使用CLI

华为云命令行工具服务（Koo Command Line Interface，KooCLI，原名HCloud CLI）是为发布在API Explorer上的云服务API提供的命令行管理工具。您可以通过此工具调用API Explorer中云应用引擎（Cloud Application Engine，以下简称CAE）开放的API，管理和使用您的CAE资源。关于KooCLI的详细信息，请参见什么是KooCLI。

安装KooCLI

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

配置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命令，具体操作可参见查看与执行云服务操作命令。

此处以CAE的获取环境列表API为例，介绍如何从API Explorer生成CLI命令，然后执行CLI命令调用API。

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

    获取环境列表API的CLI命令示例如下。

    hcloud CAE ListEnvironments --cli-region="cn-north-4"
  4. 复制生成的CLI命令，并粘贴到命令行窗口中执行。

    获取环境列表API的CLI命令执行结果示例如下。

    {
 "api_version": "v1",
 "kind": "Environment",
 "items": [
  {
   "id": "13eb5a22-7dfb-4c3f-a3cf-2f2c8993a3b7",
   "name": "test6066",
   "version": "1.2.9",
   "job_id": "1dcae2e2-ad0a-4b51-a02b-1711db5b5a62",
   "status": "hibernation",
   "annotations": {
    "cluster_id": "",
    "egress_subnet_id": "",
    "elb_id": "",
    "engine_id": "7aab991a-4880-4cbd-b901-90e83171f0e7",
    "enterprise_project_id": "0",
    "env_category": "v2",
    "group_name": "XXX",
    "inbound_eip_addr": "XX.XX.XX.XX",
    "namespace": "0f1d63462100f3242f31c00a4a1d35ea-test6066",
    "public_elb_id": "",
    "runtime_platform": "",
    "security_group_id": "20015894-ae6a-4b0d-b133-61c05847a906",
    "subnet_id": "37198c18-e568-4e89-acaa-1778bc4e3c5c",
    "type": "exclusive",
    "vpc_id": "25513e23-4d2d-4316-9b1c-583c957af282"
   },
   "created_at": "2025-01-09T12:10:35.824816Z",
   "updated_at": "2025-03-24T21:06:18.875448Z"
  }
 ]
}