Plan Limit Exceeded

plan-limit-exceeded · 402

خطة الحساب لا تسمح بواحد آخر من هذا النوع، فلم تنشئ الـ API أي شيء.

كل الصفحات

الـ limit يسمي الحد، و limitValue ما تسمح به الخطة، و currentCount ما لدى الحساب أصلا. والحل تغيير الخطة أو إزالة واحد، وليس بطاقة أبدا.

إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع planKey، limit، limitValue و currentCount.

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

  • لدى الحساب من المشاريع أو الخدمات أو buckets أو الأعضاء أقصى ما تسمح به الخطة، أو لدى المشروع من البيئات أقصى ما تسمح به، أو تحمل buckets الحساب من GB أقصى ما تسمح به الخطة. ومع الـ buckets، يكون الـ code هو CAP_BLOCKED.
  • استعلام سجلات يعود إلى الوراء أبعد مما تحفظه الخطة، أو النداء يطلب نسخا أو نسخا احتياطية يدوية أكثر مما تسمح به الخطة.

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

  • أخبر المستخدم أي حد انتهى، من limit و limitValue و currentCount.
  • أزل واحدا لم تعد له حاجة، إذا وافق المستخدم، ثم أعد المحاولة.
  • أو انتقل إلى خطة فيها مجال أكبر: ghaym cloud billing set-plan --plan <key>. وتغيير الخطة قرار المستخدم.
  • لا تعد المحاولة دون تغيير، فالعدد لا ينخفض وحده. والـ CLI يخرج بالرمز 7 عند الـ 402.

مثال على الرد

json
{
  "type": "plan-limit-exceeded",
  "title": "Plan Limit Exceeded",
  "detail": "The solo plan allows 2 environments-per-project, and this account already has 2. Move to a plan with more headroom with PUT /v1/billing/account/plan, or remove one first.",
  "planKey": "solo",
  "limit": "environments-per-project",
  "limitValue": 2,
  "currentCount": 2,
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments",
  "method": "POST",
  "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments",
  "status": 402,
  "docs": "https://ghaym.me/docs/errors/plan-limit-exceeded"
}