Runtime API

运行时 API 由创建、详情或 connect 响应里的 envdUrl 提供，用于操作该沙箱运行时。

鉴权

X-Access-Token: <envdAccessToken>

健康检查接口公开可访问：

GET {envdUrl}/health
GET {envdUrl}/
OPTIONS *

执行命令

POST {envdUrl}/run

curl -sS "$ENVD_URL/run" \
  -H "X-Access-Token: $ENVD_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
    "cmd": "python --version",
    "cwd": "/root",
    "timeoutMs": 30000
  }'

流式输出和后台进程建议使用 SDK 或 CLI：

seacloud sandbox exec <sandbox_id> "python --version"
seacloud sandbox exec --background <sandbox_id> "python server.py"

文件辅助接口

Method	Path	用途
GET	{envdUrl}/files?path=/root	列目录。
GET	{envdUrl}/file?path=/root/app.py	读文件。
POST	{envdUrl}/file	写文件。
POST	{envdUrl}/files	上传或写入文件。
POST	{envdUrl}/files/batch	批量文件操作。
POST	{envdUrl}/files/compose	多段内容合成文件。

写文件示例：

curl -sS -X POST "$ENVD_URL/file" \
  -H "X-Access-Token: $ENVD_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
    "path": "/root/workspace/hello.txt",
    "content": "hello sandbox"
  }'

RPC 分组

高级 SDK 调用使用运行时 RPC：

分组	路由前缀
Filesystem	POST {envdUrl}/filesystem.Filesystem/*
Process	POST {envdUrl}/process.Process/*

除非在调试底层集成，否则优先使用 SDK。

运行时指标

GET {envdUrl}/metrics

返回沙箱内部运行时指标快照。Dashboard 指标使用 GET /sandboxes/:sandboxID/metrics。