Laravel Cloud

通过您已连接 OOMOL 的账户来操作 Laravel Cloud。本能力调用 laravel_cloud 连接器，并通过 oo CLI 执行；OOMOL 在服务端注入凭据，因此您无需直接处理原始 token。

执行操作

假设用户已安装 oo CLI、完成登录并成功连接 Laravel Cloud。请勿主动执行 oo auth login 或打开连接 URL — 直接运行目标操作即可。仅当某条命令因认证或连接错误而实际失败时，才回退至“首次设置”流程。

1. 检查契约（schema）：在构建请求载荷前，先获取该操作权威的输入/输出结构定义：

oo connector schema "laravel_cloud" --action ""

2. 执行操作：传入符合输入结构定义的 JSON 载荷：

oo connector run "laravel_cloud" --action "" --data '' --json

• --data 接收一个 JSON 对象字符串，或以 @path/to/file.json 形式指定本地文件路径；若省略该参数，则默认发送空对象 {}。
• 响应格式为 { "data": ..., "meta": { "executionId": "..." } }；其中执行 ID 位于 meta.executionId 字段下。

以下列出了所有可用操作，每项附有一行简要说明；对状态产生变更的操作将标注 [write] 或 [destructive] 标签。在构造 --data 前，请务必使用 oo connector schema 获取该操作最新的实时 schema，以确认其权威的输入字段。

可用操作

• get_application — 获取指定的 Laravel Cloud 应用程序。
• get_deployment — 获取指定的 Laravel Cloud 部署。
• get_environment — 获取指定的 Laravel Cloud 环境。
• get_organization — 获取与当前 API token 关联的 Laravel Cloud 组织。
• list_applications — 列出已认证组织下的所有 Laravel Cloud 应用程序。
• list_deployments — 列出指定环境下的所有 Laravel Cloud 部署。
• list_environments — 列出指定应用程序下的所有 Laravel Cloud 环境。
• list_regions — 列出 Laravel Cloud 当前支持的云区域（regions）。

安全性

• 未标注标签的操作均为只读操作（get / list / search），可安全直接执行。
• 标注 [write] 的操作会修改 Laravel Cloud 状态 — 执行前须向用户明确确认载荷内容及预期影响。
• 标注 [destructive] 的操作将删除或覆盖数据 — 执行前必须明确确认目标对象，并获得用户的显式批准。

首次设置

以下为一次性步骤 — 不应在每次调用时重复执行。仅当某条命令因对应原因失败时，才运行相应步骤。

• oo: command not found — 安装 oo CLI（其他平台安装指南：https://cli.oomol.com/install-guide.md）：

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux
  

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell
  

• 未登录 / 认证错误 — 一次性登录您的 OOMOL 账户：

  oo auth login
  

• scope_missing / credential_expired / app_not_ready / app_not_found — Laravel Cloud 尚未连接，或连接已过期、缺少必要权限范围（scope）。请通过以下链接一次性完成连接（认证类型：API key）：

  https://console.oomol.com/app-connections?provider=laravel_cloud
  

• HTTP 402 / OOMOL_INSUFFICIENT_CREDIT — 账户余额不足导致服务暂停。请前往 https://console.oomol.com/billing/token-recharge 充值后重试。

资源

• Laravel Cloud 主页：https://cloud.laravel.com