projects

## 概述 本文档概述了以编程方式管理 Neon 项目的规则。涵盖了创建、检索、更新和删除。 ## 管理项目 ### 列出项目 1. 动作: 检索与 API 密钥关联的账户可访问的所有项目列表。这是获取其他 API 调用所需的 `project_id` 值的主要方法。 2. 端点: `GET /projects` 3. 查询参数: - `limit` (可选，整数，默认: 10): 指定要返回的项目数量，从 1 到 400。 - `cursor` (可选，字符串): 用于分页。提供来自先前响应的 `cursor` 值以获取下一组项目。 - `search` (可选，字符串): 通过项目 `name` 或 `id` 的部分匹配来过滤项目。 - `org_id` (可选，字符串): 按特定组织 ID 过滤项目。 4. 遍历所有项目时，请结合使用 `limit` 和 `cursor` 参数以正确处理分页。 请求示例: bash # 检索前 10 个项目 curl 'https://console.neon.tech/api/v2/projects?limit=10' -H 'Accept: application/json' -H "Authorization: Bearer $NEON_API_KEY" 响应示例: { "projects": [ { "id": "old-fire-32990194", "platform_id": "aws", "region_id": "aws-ap-southeast-1", "name": "old-fire-32990194", "provisioner": "k8s-neonvm", "default_endpoint_settings": { "autoscaling_limit_min_cu": 0.25, "autoscaling_limit_max_cu": 2, "suspend_timeout_seconds": 0 }, "settings": { "allowed_ips": { "ips": [], "protected_branches_only": false }, "enable_logical_replication": false, "maintenance_window": { "weekdays": [5], "start_time": "19:00", "end_time": "20:00" }, "block_public_connections": false, "block_vpc_connections": false, "hipaa": false }, "pg_version": 17, "proxy_host": "ap-southeast-1.aws.neon.tech", "branch_logical_size_limit": 512, "branch_logical_size_limit_bytes": 536870912, "store_passwords": true, "active_time": 0, "cpu_used_sec": 0, "creation_source": "console", "created_at": "2025-09-10T06:58:33Z", "updated_at": "2025-09-10T06:58:39Z", "synthetic_storage_size": 0, "quota_reset_at": "2025-10-01T00:00:00Z", "owner_id": "org-royal-sun-91776391", "