用途：通过 Aeon REST API 以编程方式管理 YugabyteDB Managed 云集群，适合脚本与自动化运维。它是独立的 API，不同于 YBA（YugabyteDB Anywhere）API，二者的基础 URL、认证机制与资源模型均不相同。
基础信息：基础 URL 为 https://cloud.yugabyte.com/api/v1，API 参考（Swagger UI）位于 https://cloud.yugabyte.com/swagger，端点在 Aeon 版本演进中会变化，应以此为准。
认证：所有请求需将 API 密钥作为 Bearer token 发送：Authorization: Bearer <api-key>。密钥在 Aeon 控制台右上角个人资料 → API Keys → Create API Key 生成，作用于账号范围，除非被撤销否则不过期。
资源层级：Account（accountId）→ Project（projectId）→ Cluster（clusterId），集群下包含 Nodes、Backups、Database users、Network allowlists、Metrics。多数端点形如 /api/v1/accounts/{accountId}/projects/{projectId}/clusters/{clusterId}/...。accountId、projectId、clusterId 的获取方式见 references/auth-and-discovery.md。
参考资料：references/auth-and-discovery.md 覆盖获取 API 密钥、发现各类 ID、curl 与 Python/PowerShell 调用模式及分页；references/recipes.md 提供现成操作，如集群信息、扩缩容、节点列表、数据库用户、白名单、备份、指标。
覆盖范围：集群生命周期（创建、修改规格/扩缩容、暂停、恢复、删除）、数据库用户管理（创建、列出、修改密码）、网络白名单（增删 IP 范围）、备份计划与按需备份及恢复、VPC peering 与私有端点配置、集群指标（精选集合，见 recipes.md）、告警配置。
不覆盖部分及替代方案：完整 Prometheus 指标面 → 在 Aeon 控制台配置指标导出（Settings → Metrics Export to Datadog / Grafana Cloud / Prometheus）；SQL 层查询分析 → 通过 YSQL 连接并使用 yb-query-analysis 技能；Performance Advisor / Insights → 仅限 Aeon 控制台，当前无 API 端点；GFlag 变更 → 通过支持工单，不通过 API 暴露。
限制：具体端点清单与字段以官方 Swagger 为准；本资料未提供更细的价格、配额或性能数据。