branches

## 概述 本文档概述了使用 Neon API 管理 Neon 项目中分支的规则。 ## 管理分支 ### 创建分支 1. 操作：在指定项目中创建一个新分支。默认情况下，分支是基于项目的默认分支创建的，但您可以指定父分支、时间点（LSN 或时间戳）并附加计算端点。 2. 端点：`POST /projects/{project_id}/branches` 3. 路径参数： - `project_id` (string, 必填): 将要创建分支的项目唯一标识符。 4. 请求体参数：请求体是可选的。如果提供，可以包含 `endpoints` 和/或 `branch` 对象。 `endpoints` (对象数组, 可选): 要创建并附加到新分支的计算端点列表。 - `type` (string, 必填): 端点类型。允许的值：`read_write`, `read_only`。 - `autoscaling_limit_min_cu` (number, 可选): 最小计算单元 (CU)。最小值为 `0.25`。 - `autoscaling_limit_max_cu` (number, 可选): 最大计算单元 (CU)。最小值为 `0.25`。 - `provisioner` (string, 可选): 计算资源配置器。指定 `k8s-neonvm` 以启用自动扩缩容。允许的值：`k8s-pod`, `k8s-neonvm`。 - `suspend_timeout_seconds` (integer, 可选): 计算资源挂起前的非活动持续时间（秒）。范围从 -1（从不挂起）到 604800（1 周）。值为 `0` 使用默认值 300 秒（5 分钟）。 `branch` (object, 可选): 指定新分支的属性。 - `name` (string, 可选): 分支名称（最大 256 个字符）。如果省略，将自动生成名称。 - `parent_id` (string, 可选): 父分支 ID。如果省略，则使用项目的默认分支作为父分支。 - `parent_lsn` (string, 可选): 来自父分支的日志序列号 (LSN)，用于从特定时间点创建新分支。 - `parent_timestamp` (string, 可选): ISO 8601 时间戳（例如 `2025-08-26T12:00:00Z`），用于从特定时间点创建分支。 - `protected` (boolean, 可选): 如果为 `true`，则该分支被创建为受保护分支。 - `init_source` (string, 可选): 分支初始化的源。`parent-data`（默认）复制模式和数据。`schema-only` 创建一个仅包含指定父分支模式的新根分支。 - `expires_at` (string, 可选): RFC 3339 时间戳，用于设置过期时间