Environment Conflict

environment-conflict · 409

توجد بيئة أخرى في هذا المشروع لها قيمة name نفسها، فلم يكتب أي شيء.

كل الصفحات

الـ conflictField يسمي الحقل، والـ conflictValue القيمة التي رفضت.

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

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

  • توجد بيئة أخرى في هذا المشروع تستعمل قيمة name نفسها.
  • أرسل طلب الإنشاء نفسه مرتين ونجح الأول، فوجد الثاني نتيجته.

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

  • اقرأ conflictField و conflictValue، فهما يذكران أي قيمة رفضت.
  • اختر قيمة name أخرى، أو اجلب البيئة التي لها هذه القيمة واستعملها.
  • وإذا كان التكرار من إعادة محاولتك أنت، فاعتبر النداء منجزا، لا فاشلا.
  • وأرسل header اسمه Idempotency-Key مع نداءات الكتابة، فتعيد المحاولة الثانية جواب الأولى بدل أن تصطدم بها.

مثال على الرد

json
{
  "type": "environment-conflict",
  "title": "Environment Conflict",
  "detail": "A environment with name 'staging' already exists",
  "resourceType": "Environment",
  "conflictField": "name",
  "conflictValue": "staging",
  "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": 409,
  "docs": "https://ghaym.me/docs/errors/environment-conflict"
}