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"
}