operations

## 概述 本文档概述了在 Neon 中管理和监控长时运行操作的规则，包括分支创建和计算管理。 ## 操作 操作是由 Neon 控制平面执行的动作（例如 `create_branch`，`start_compute`）。以编程方式使用 API 时，监控长时运行操作的状态至关重要，以确保在启动依赖于该操作的下一个操作之前，当前操作已完成。超过 6 个月的操作可能会从 Neon 系统中删除。 ### 列出操作 1. 动作: 检索指定 Neon 项目的操作列表。操作数量可能很大，因此建议使用分页。 2. 端点: `GET /projects/{project_id}/operations` 3. 路径参数: - `project_id` (字符串，必需): 您要列出其操作的项目唯一标识符。 4. 查询参数: - `limit` (整数，可选): 响应中返回的操作数量。必须在 1 到 1000 之间。 - `cursor` (字符串，可选): 来自先前响应的游标值，用于获取下一页操作。 5. 流程: - 使用 `limit` 发起初始请求以获取第一页结果。 - 响应将包含一个 `pagination.cursor` 值。 - 要获取下一页，请发起后续请求，同时包含来自先前响应的 `limit` 和 `cursor`。 请求示例 bash curl 'https://console.neon.tech/api/v2/projects/hidden-river-50598307/operations' -H 'Accept: application/json' -H "Authorization: Bearer $NEON_API_KEY" 响应示例 { "operations": [ { "id": "639f7f73-0b76-4749-a767-2d3c627ca5a6", "project_id": "hidden-river-50598307", "branch_id": "br-long-feather-adpbgzlx", "endpoint_id": "ep-round-morning-adtpn2oc", "action": "apply_config", "status": "finished", "failures_count": 0, "created_at": "2025-09-10T12:15:23Z", "updated_at": "2025-09-10T12:15:23Z", "total_duration_ms": 87 }, { "id": "b5a7882b-a5b3-4292-ad27-bffe733feae4", "project_id": "hidden-river-50598307", "branch_id": "br-super-wildflower-adniii9u", "endpoint_id": "ep-ancient-brook-ad5ea04d", "action": "apply_config", "status": "finished", "failures_count": 0, "created_at": "2025-09-10T12:15:23Z", "updated_at": "2025-09-10T12:15:23Z", "total_duration_ms": 49 }, { "id": "36a1cba0-97f1-