Dry Run Not Supported

dry-run-unsupported · 400

طلب النداء dry run على مسار لا يستطيع التخطيط له، فرفضته الـ API بدل أن تجري التغيير فعلا.

كل الصفحات

الـ supportedRoutes يعدد المسارات التي ترد على dry run؛ و POST /v1/agent-sessions/<id>/rollback يقبل واحدا أيضا، مع أن القائمة لا تذكره. والـ dryRun=false، أو أي قيمة غير true أو 1 أو عدم وجود قيمة، لا يطلب dry run، وينفذ النداء فعلا. ولا فرق بين الأحرف الكبيرة والصغيرة: dryRun=TRUE هو dry run أيضا.

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

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

  • أضاف النداء dryRun=true إلى مسار لا تسميه القائمة، مثل إنشاء بيئة.
  • عميل يضيف dryRun إلى كل نداء لكي يفحص كل واحد أولا.

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

  • احذف dryRun لكي تجري التغيير فعلا، بعد أن يوافق المستخدم.
  • أو افحص التغيير بطريقة أخرى: اقرأ الموارد التي سيمسها أولا.
  • لا تعد المحاولة مع dryRun على المسار نفسه: فهو لا يخطط أبدا.

مثال على الرد

json
{
  "type": "dry-run-unsupported",
  "title": "Dry Run Not Supported",
  "detail": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments does not support dryRun. Drop the parameter to perform the operation, or dry-run one of the supported routes instead.",
  "method": "POST",
  "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments",
  "supportedRoutes": [
    "POST /v1/projects/:projectId/services",
    "POST /v1/admin/instances",
    "POST /v1/services/:serviceId/domains"
  ],
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments",
  "status": 400,
  "docs": "https://ghaym.me/docs/errors/dry-run-unsupported"
}