Tunnel Closed

tunnel-closed · 410

انتهى الـ tunnel ولن يعود، فرفضت الـ API الـ heartbeat الخاص به.

كل الصفحات

الـ reason يبين ما أنهاه، و openSeconds المدة التي بقي فيها مفتوحا، و keyName الـ API key الذي فتح به، و null دون مفتاح. والـ workspaceName لا يأتي عندما يكون الـ workspace قد حذف. والـ tunnel يعيش على lease مدته 90 ثانية، وكل heartbeat يجدده.

إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع tunnelId، reason، openSeconds، keyName و workspaceName.

الأسباب الشائعة

  • closed: أغلق الـ tunnel، مثلا بـ Ctrl-C.
  • connection_lost: لم يصل heartbeat قبل أن ينتهي الـ lease. والـ CLI يفتح tunnel جديدا مكانه.
  • key_revoked أو member_removed أو role_changed: المفتاح أو المقعد الذي فتح به لم يعد يسمح بالاتصال، والـ CLI يخرج بالرمز 3.
  • database_deleted أو environment_deleted: حذفت القاعدة أو بيئتها، والـ CLI يخرج بالرمز 4.
  • database_stopped: أوقفت القاعدة، والـ CLI يخرج بالرمز 5.
  • workspace_suspended: علق الـ workspace، والـ CLI يخرج بالرمز 7.

كيف تصلح الطلب

  • بعد closed أو connection_lost، افتح tunnel جديدا؛ والـ CLI يفعل ذلك وحده للذي انقطع.
  • وبعد أي reason آخر، أصلح ما يسميه قبل أن تفتح واحدا جديدا: مفتاح جديد، أو عودة المقعد، أو قاعدة تعمل.
  • لا ترسل heartbeats أخرى لهذا الـ tunnel: سيبقى مغلقا.

مثال على الرد

json
{
  "type": "tunnel-closed",
  "title": "Tunnel Closed",
  "detail": "The tunnel is closed: key_revoked.",
  "tunnelId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402",
  "reason": "key_revoked",
  "openSeconds": 1843,
  "keyName": "laptop",
  "workspaceName": "Acme",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/tunnels/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/heartbeat",
  "method": "POST",
  "instance": "POST /v1/tunnels/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/heartbeat",
  "status": 410,
  "docs": "https://ghaym.me/docs/errors/tunnel-closed"
}