Invalid Instance State Transition

invalid-instance-state-transition · 409

طلب مشغل من instance انتقالا لا يستطيع إجراءه من حالته، فلم يتغير شيء.

كل الصفحات

الـ instances يشغلها مشغلو غيم عبر المسارات الإدارية. والـ from هي حالة الـ instance الفعلية، و to الحالة التي طلبها النداء.

إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع instanceId، from و to.

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

  • هدم الـ instance، ثم طلب تشغيله. والـ instance الذي هدم لا يعود.
  • طلب تشغيل أو إيقاف، وانتقال سابق لم يستقر بعد.

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

  • أعد قراءة الـ instance واعمل على أساس from.
  • انتظر حتى يستقر الانتقال قبل أن تطلب الانتقال التالي.
  • ولكي يكون لديك instance يعمل بعد أن هدم، أنشئ واحدا جديدا.

مثال على الرد

json
{
  "type": "invalid-instance-state-transition",
  "title": "Invalid Instance State Transition",
  "detail": "Instance '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' cannot move from 'destroyed' to 'starting'",
  "instanceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "from": "destroyed",
  "to": "starting",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/admin/instances/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/start",
  "method": "POST",
  "instance": "POST /v1/admin/instances/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/start",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/invalid-instance-state-transition"
}