区域

一个区域是您项目的存储和计算运行所在的物理位置。您在创建 项目时选择一次；该项目之下的每个分支和端点都继承 它。区域是项目的一个属性，而不是您之后会更改的东西。

区域目录

GET /v1/regions 返回您可以在其中创建项目的区域。它是经过身份验证的 —— 列出您项目的同一个 bearer 也列出该目录。响应是一个单一对象：

{
  "regions": [
    {
      "region_id": "home-proxmox",
      "name": "Kisenon Home (Proxmox)",
      "default": true,
      "geo_lat": 0,
      "geo_long": 0
    }
  ]
}

每个区域携带：

• region_id —— 您在创建项目时传入的稳定标识符。
• name —— 在控制台下拉菜单中显示的人类标签。
• default —— 当您不指定时所使用的区域是否就是这个。
• geo_lat / geo_long —— 用于基于距离选择的坐标。 对于家庭集群它们为 0，因为它是裸金属而非公有云区域。

在创建时选择一个区域

在 web 控制台中，New project 有一个 Region 下拉菜单。 它默认为 Auto (nearest)，这会把选择权留给控制平面 —— 如今那总是解析到单个家庭区域。要固定一个特定区域，从列表中选择它。

通过 API，在 POST /v1/projects 上传入可选的 region 字段：

{ "name": "my-app", "region": "home-proxmox" }

省略 region（或发送 null）以获得与控制台默认相同的"auto"行为： 控制平面分配默认区域。

Alpha 运行单个区域

在 alpha 期间，Kisenon 运行一个区域：home-proxmox（"Kisenon Home (Proxmox)"），一个美国裸金属集群。它是默认的，因此无论您是否设置 region，每个项目都落在那里。多区域在路线图上；目录和 region 字段都已经就位，因此当更多区域上线时，客户端上不会有任何变化。

相关

• 项目 —— 为之选择一个区域的容器。
• 分支 —— 继承它们项目的区域。