Domain Conflict

domain-conflict · 409

يوجد domain خاص آخر على المنصة له قيمة hostname نفسها، فلم يكتب أي شيء.

كل الصفحات

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

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

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

  • يوجد domain خاص آخر على المنصة يستعمل قيمة hostname نفسها.
  • أرسل طلب الإنشاء نفسه مرتين ونجح الأول، فوجد الثاني نتيجته.
  • الـ hostname على خدمة أخرى، وربما في workspace آخر: الـ hostname ملك لخدمة واحدة على المنصة كلها.

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

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

مثال على الرد

json
{
  "type": "domain-conflict",
  "title": "Domain Conflict",
  "detail": "A domain with hostname 'app.example.com' already exists",
  "resourceType": "Domain",
  "conflictField": "hostname",
  "conflictValue": "app.example.com",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/domains",
  "method": "POST",
  "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/domains",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/domain-conflict"
}