云服务商管理 API

管理员接口，用于管理多云资产服务商。仅在 selfhosted 部署模式下可用。

Phase 0：CRUD、凭证管理、区域/规格发现框架已就绪。testConnection、discoverRegions、discoverSpecs 等依赖各厂商 Provider 实现的接口需后续 Phase 接入后才可调用。

基础信息

• 基础路径: /admin/cloud-providers
• 认证方式: Bearer JWT Token
• 权限要求: site:admin
• 可用模式: selfhosted

云服务商

列出所有云服务商

GET /admin/cloud-providers

返回所有已配置的云服务商列表（凭证以脱敏形式展示）。

响应示例

{
  "data": [
    {
      "id": "uuid",
      "vendor": "alibaba",
      "label": "生产环境-阿里云",
      "credential_masks": {
        "access_key_id": "AKI****WXYZ",
        "access_key_secret": "abc****xyz"
      },
      "status": "connected",
      "enabled": true
    }
  ]
}

添加云服务商

POST /admin/cloud-providers

请求体

{
  "vendor": "alibaba",
  "label": "生产环境",
  "credentials": {
    "access_key_id": "AKID...",
    "access_key_secret": "..."
  },
  "metadata": {}
}

支持的 vendor: alibaba, tencent, huawei, volcengine, baidu, aws, azure, gcp

更新云服务商

PUT /admin/cloud-providers/:id

支持部分更新。凭证使用 merge 语义：传 null 删除字段，传新值覆盖。

删除云服务商

DELETE /admin/cloud-providers/:id

有活跃资产时无法删除（返回 409）。

测试连接

POST /admin/cloud-providers/:id/test

验证凭证有效性，更新连接状态。

发现区域

POST /admin/cloud-providers/:id/discover-regions

异步发现云厂商可用区域（返回 202）。

发现规格

POST /admin/cloud-providers/:id/discover-specs

异步发现所有已启用区域的实例规格（返回 202）。

区域管理

列出区域

GET /admin/cloud-providers/regions?providerId=<uuid>

启用/禁用区域

PATCH /admin/cloud-providers/regions/:id

配置 guacd 中继

PUT /admin/cloud-providers/regions/:id/relay

为区域配置远程桌面 guacd 中继节点。

测试中继

POST /admin/cloud-providers/regions/:id/relay/test

规格管理

列出规格

GET /admin/cloud-providers/specs?providerId=<uuid>&regionId=<uuid>

更新规格

PATCH /admin/cloud-providers/specs/:id

可设置平台分级（small/medium/large/gpu）和每小时积分消耗。