Source: https://ghaym.me/docs/getting-started.md # انشر أول خدمة انشر repo من GitHub على رابط HTTPS يعمل، من الـ console أو من الـ CLI. ## نشر مستودع 1. افتح الـ console واضغط `⌘K` واختر **مشروع جديد › مستودع GitHub**. - لا يوجد حساب GitHub مربوط؟ اختر **ربط حساب GitHub**. - الـ repo ليس في القائمة؟ اختر **إدارة الوصول إلى المستودعات** واسمح لغيم بقراءته. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud git install ``` 2. اختر الـ repo، واكتب اسم [المشروع](/ar/docs/projects-and-services) أو اترك اسم الـ repo، واضغط Enter. ينشئ غيم المشروع، ويتابع الـ branch الأساسي للـ repo، ويبدأ أول [بناء](/ar/docs/builds). ثم اختر [الموقع](/ar/docs/countries-and-sites) الذي تعمل فيه الخدمة، ولا يتغير لاحقا، ثم حجمها. في الـ CLI: ```sh ghaym cloud projects create --name ghaym cloud services create --project --type git --repo --size --site ``` 3. انتظر حتى تصبح الخدمة **يعمل**. تستجيب على رابط ينتهي بـ `ghaym.app`. في الـ CLI، تابع البناء: ```sh ghaym cloud deployments list --service ``` ## نشر تعديل نفذ push على الـ branch الذي تتابعه الخدمة. كل push عليه يبني الخدمة وينشرها من جديد. Source: https://ghaym.me/docs/install-the-cli.md # ثبت الـ CLI وسجل الدخول ثبت أمر `ghaym`، وسجل الدخول فيه بمفتاح API، وتأكد باسم من يعمل. ## التثبيت 1. نزل Node.js 24 أو أحدث، ثم نزل الـ CLI من npm: ```sh npm install -g @ghaymjo/cli ``` 2. تحقق من النسخة التي لديك. [مرجع الـ CLI](/ar/docs/cli) يذكر النسخة التي تصفها هذه الصفحات. في الـ CLI: ```sh ghaym --version ``` 3. إذا كانت نسختك أقدم، أو كان هناك أمر من هذه الصفحات لا تعرفه، فحدثها: ```sh npm install -g @ghaymjo/cli@latest ``` ## تسجيل الدخول 1. [أنشئ مفتاح API](/ar/docs/create-an-api-key). يبدأ المفتاح بـ `ghk_`. 2. شغل `ghaym login` والصق المفتاح. لا يظهر وأنت تلصقه، ويتحقق منه الـ CLI قبل أن يحفظه. في الـ CLI: ```sh ghaym login ``` 3. في البيئات غير التفاعلية، حيث لا يمكن تشغيل `ghaym login`، ضع المفتاح في متغير بيئة اسمه `GHAYM_TOKEN`. عندما يكون موجودا، يستعمله الـ CLI بدلا من المفتاح المحفوظ. في الـ CLI: ```sh export GHAYM_TOKEN= ``` ## التحقق من الحساب يطبع أمر `ghaym whoami` البريد الإلكتروني للحساب، ومصدر المفتاح، وما يسمح له أن يفعله. ويمسح أمر `ghaym logout` المفتاح المحفوظ من هذا الجهاز، لكن المفتاح نفسه يبقى صالحا حتى تلغيه. ```sh ghaym whoami ``` Source: https://ghaym.me/docs/agents.md # جهز الـ coding agent أعط Claude Code أو Codex أو Cursor كل ما يلزمه لكي ينشر عنك: الـ CLI، والقواعد، والصفحات التي يقرؤها. ## التجهيز 1. [ثبت الـ CLI وسجل الدخول](/ar/docs/install-the-cli) حيث يعمل الـ agent. يستعمل الـ agent تسجيل دخولك. 2. أضف [ملفات الـ agent](/ar/docs/harness) إلى الـ repo الخاص بك، لكي يقرأ الـ agent هذه القواعد في كل مرة. 3. دع الـ agent يتعلم كل الأوامر والـ flags من [مرجع الـ CLI](/ar/docs/cli)، أو بنداء واحد في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym help all --json ``` ## قواعد للـ agents - **سجل الدخول عبر صاحب الحساب.** يستعمل الـ CLI تسجيل دخول من يشغله. إذا فشل `ghaym whoami`، فاطلب منه أن يشغل `ghaym login` في التيرمينال الخاص به، ولا تطلب منه أبدا أن يلصق مفتاحا في المحادثة. - **استعمل الـ CLI، لا نداءات API تكتبها بيدك.** - **الـ push يبدأ النشر.** الـ push على الـ branch الذي تتابعه الخدمة يبنيها وينشرها. ولا ينجح النشر إلا عندما يقول سجل البناء ذلك. - **استمع على كل العناوين، وعلى الـ port الذي يحدده غيم.** اربط التطبيق على `0.0.0.0` لا على localhost، واقرأ الـ port من `PORT`. وإلا فلن يصل فحص الجاهزية إلى التطبيق ويفشل النشر. - **كل تغيير ينتظر حتى يطبق.** المتغيرات وإعدادات البناء والحجم والنسخ والتوزيع والوصول تبقى [تغييرات مجهزة](/ar/docs/staged-changes) حتى `ghaym cloud changes apply`، أو `--apply` على الأمر الذي جهزها. وتطبيق تغيير على متغير أو على ربط مخزن أو على الـ branch أو على إعداد بناء ينشر الخدمة. - **جرب التغيير أولا.** كل أمر يغير شيئا يأخذ `--dry-run`، ولا يغير عندها شيئا. أوامر `services create` و`domains add` و`sessions rollback` تعيد الخطة مع سعرها الشهري التقريبي؛ والباقي يطبع الطلب الذي كان سيرسله. - **تعتمد الأسعار على الموقع.** اقرأها بالأمر `ghaym cloud regions sizes `. - **الطلبات المتتالية تبقي الخدمة مستيقظة.** الخدمات خارج الـ production [تنام](/ar/docs/sleep) عندما لا يصلها شيء، ولا يحسب الـ compute إلا وهي مستيقظة. - **الترافيك الخارج الذي يتجاوز الكمية الشهرية مدفوع**. - **التسجيل يحتاج إلى شخص.** والنشر يفتح بعد أن تعتمد غيم الحساب. ## أي أمر لأي مهمة - **نشر الكود:** `ghaym cloud projects create`، ثم `ghaym cloud services create --project --type git --repo --size --site `، ثم push على الـ branch الذي تتابعه الخدمة، كما تقول صفحة [انشر أول خدمة](/ar/docs/getting-started). `ghaym cloud regions list` يعرض المواقع. - **تجربة تغيير بعيد عن الـ production:** `ghaym cloud environments create` مع branch خاص بها، ثم push على هذا الـ branch. - **معرفة سبب فشل البناء:** `ghaym cloud deployments logs `، لا نتيجة الـ push. - **تغيير الإعدادات:** `ghaym cloud vars set`. لا تحفظ في الـ repo ملف إعدادات فيه قيم. - **انتظار موافقة أحد:** الأمر الذي يحتاج إلى موافقة يخرج بالرمز `6` ومعه رقم الموافقة. شغل `ghaym cloud approvals wait ` بدلا من إعادة المحاولة. - **معرفة ما حدث:** `ghaym cloud audit list` و `ghaym cloud sessions list`، مع `--json`. ## صفحات يقرؤها الـ agent - [/docs/errors](/ar/docs/errors): صفحة لكل نوع خطأ في الـ API. رابط `docs` في الخطأ يشير إلى هنا. - [/docs/verified-prompts](/ar/docs/verified-prompts): prompts تجهز repo موجودا للنشر. - [/llms.txt](/llms.txt): فهرس موقع غيم بصيغة llms.txt. - كل صفحة تحت `/docs` موجودة أيضا بصيغة Markdown: أضف `.md` إلى المسار، مثل [/docs/agents.md](/docs/agents.md). - أضف `?lng=en` إلى أي رابط لتحصل على النسخة الإنجليزية. ومن دونه، تظهر الصفحات بالعربية. Source: https://ghaym.me/docs/deploy-from-github.md # انشر من GitHub اربط GitHub مرة واحدة، وبعدها كل push على الـ branch الخاص بالخدمة يبنيها وينشرها. ## ربط GitHub 1. اضغط `⌘K` واختر **مشروع جديد › مستودع GitHub**، كما تفعل عندما [تنشر أول خدمة](/ar/docs/getting-started). - إذا لم يكن هناك حساب GitHub مربوط، اختر **ربط حساب GitHub**. في الـ [CLI](/ar/docs/install-the-cli)، اطبع الرابط الذي يثبت تطبيق غيم على GitHub: ```sh ghaym cloud git install ``` 2. على GitHub، ثبت التطبيق على حسابك أو على الـ organization الخاصة بك، واختر أي repos يراها. - وإذا لم يظهر repo في القائمة لاحقا، اختر **إدارة الوصول إلى المستودعات** تحت **مستودع GitHub**. يسمح التطبيق لغيم بأمرين: أن يقرأ كودك وقت [البناء](/ar/docs/builds)، وأن يعرف متى تعمل push لكي ينشر. تستطيع تغيير قائمة الـ repos، أو إزالة التطبيق، من إعدادات GitHub في أي وقت. عندما تزيله، يتوقف النشر الجديد. لكن الخدمات العاملة تستمر في العمل. ## ما الذي يبدأ النشر أي push على الـ branch الذي تتابعه الخدمة يبنيها وينشرها، في كل بيئة تتابع هذا الـ branch. لا توجد أي خطوة أخرى. > [!SOON] > معاينة الـ pull requests. وحتى ذلك الحين، لكي تجرب تغييرا بعيدا عن الإنتاج، [انشر branch في بيئة مستقلة](/ar/docs/branch-environments). Source: https://ghaym.me/docs/build-settings.md # غير طريقة بناء الخدمة وتشغيلها اضبط كيف تبنى الخدمة وكيف تعمل: طريقة البناء، والمجلد، والأوامر، والـ port، ومسار الفحص. ## غير الإعدادات 1. افتح الخدمة واضغط `⌘K` واختر **الإعدادات › البناء والتشغيل**. 2. عدل الحقل الذي تريده: **أمر البناء** أو **أمر التشغيل** أو **منفذ التطبيق** أو **المجلد الجذري** أو **مسار فحص الجاهزية** أو **أداة البناء** أو **الفرع**. اختر **تجهيز التغيير**، ويبقى التعديل منتظرا [كتغيير مجهز](/ar/docs/staged-changes). في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud services set web rootDirectory=apps/web port=8080 ``` 3. اضغط `⌘K`، واختر **مراجعة التغييرات**، ثم اضغط `⌘↵` لكي [تطبقه](/ar/docs/apply-changes). وتطبيقه ينشر الخدمة بالإعدادات الجديدة. في الـ CLI: ```sh ghaym cloud changes apply --project shop ``` ## ماذا يفعل كل إعداد - **أمر البناء** يعمل قبل التشغيل في كل نشر، و**أمر التشغيل** يشغل التطبيق بعد البناء. إذا تركت أيا منهما فارغا، [البناء](/ar/docs/builds) يستنتجه من الـ repo الخاص بك. - دون `Dockerfile` يكتشف البناء الـ framework. وأي stack يبنى بـ `Dockerfile`: أضف `Dockerfile` إلى الـ repo واترك **أداة البناء** على **Dockerfile**. والـ repo الذي فيه `Dockerfile` عند إضافة الخدمة يأخذ هذه الأداة من البداية. - **المجلد الجذري** هو المجلد في الـ repo الذي يبنى منه التطبيق. - **منفذ التطبيق** هو الـ port الذي يستمع عليه التطبيق، وهو 3000 إذا لم تغيره. - **مسار فحص الجاهزية** يجب أن يرد بنجاح قبل أن يستقبل النشر الزوار. إذا تركته فارغا، يفحص غيم `/`. - **الفرع** هو الـ branch الذي تنشر منه الخدمة. لكل بيئة إعدادات بناء خاصة بها، نسخت من الإنتاج عند إنشائها. والقيمة التي تضبطها تطبق على البيئة التي أنت فيها فقط. Source: https://ghaym.me/docs/branch-environments.md # انشر branch في بيئة مستقلة أنشئ بيئة مثل staging تنشر من branch خاص بها، بعيدا عن الإنتاج. ## أنشئ البيئة 1. افتح [المشروع](/ar/docs/projects-and-services)، وافتح قائمة البيئات الخاصة به واختر **إدارة البيئات**، ثم **بيئة جديدة**. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud environments create --project shop --name staging --branch staging ``` 2. اكتب **اسم البيئة**، واختر **الـ branch** الذي تنشر منه، واختر **إنشاء البيئة**. لكل خدمة في المشروع مكان في البيئة الجديدة، وتنسخ إليه إعدادات الإنتاج والوصول مرة واحدة. وإذا أردت أن تبنيها بطريقة أخرى، غير إعداداتها هناك؛ فالتغيير في بيئة لا يصل إلى غيرها. وكل قاعدة بيانات فيها تبدأ فارغة: البيئات لا تتشارك البيانات. 3. نفذ push على الـ branch. وإذا أردت أن تنشر قبل الـ push القادم، افتح خدمة في البيئة واضغط `⌘K` واختر **نشر**. كل push عليه [يبني وينشر](/ar/docs/deploy-from-github) خدمات البيئة. > [!SOON] > معاينة الـ pull requests. وحتى ذلك الحين، تنشر البيئة من الـ branch الذي تختاره، لا من pull request. ## تأكد اختر البيئة من القائمة نفسها لكي تفتحها. وعلى عكس الإنتاج، هي [تنام](/ar/docs/sleep) بعد 15 دقيقة دون أي طلب. محركات البحث لا تفهرسها: ردودها تحمل `X-Robots-Tag: noindex`. وإذا أردت أن تظهر في نتائج البحث، أرسل الـ header `X-Robots-Tag` الخاص بك من التطبيق. ## احذفها من **إدارة البيئات**، اختر **حذف** بجانبها، واكتب اسمها واختر **حذف البيئة**. تحذف معها النشرات والمتغيرات وقواعد البيانات التي فيها. ```sh ghaym cloud environments delete staging --project shop --confirm ``` Source: https://ghaym.me/docs/rollback.md # ارجع إلى نشر سابق أعد تشغيل نشرة سابقة ناجحة، دون أن تبنى من جديد. ## ارجع إلى النشر 1. افتح الخدمة واضغط `⌘K` واختر **إعادة نشر نشرة سابقة**. في القائمة النشرات الناجحة للخدمة، الأحدث أولا، والنشرة العاملة معلمة. في الـ [CLI](/ar/docs/install-the-cli)، اعرض النشرات وخذ الـ id الخاص بالنشرة التي تريدها: ```sh ghaym cloud deployments list --service web ``` 2. اختر نشرة، ثم **إعادة نشر**. يعيد غيم تشغيل الـ image الخاصة بهذه النشرة، مع المتغيرات التي كانت معها، ودون [بناء](/ar/docs/builds). في الـ CLI: ```sh ghaym cloud deployments rollback ``` ## تقدم مرة أخرى ارجع إلى النشرة الأحدث بالطريقة نفسها، أو اعمل push على الـ branch الذي تتابعه الخدمة: كل push يبنيها وينشرها من جديد. Source: https://ghaym.me/docs/variables.md # اضبط المتغيرات والأسرار أضف متغيرات الخدمة وعدلها واحذفها، وشاركها مع البيئة كلها، وعلم المتغيرات السرية. ## اضبط متغيرا 1. افتح الخدمة واضغط `⌘K` واختر **انتقال › المتغيرات**. تعرض الصفحة متغيرات الخدمة **خاصة**، ثم **مشتركة وموفرة**. 2. اختر **إضافة متغير**، واكتب الاسم والقيمة، واضغط Enter. وإذا أردت تعديل الكثير دفعة واحدة، بدل العرض من **قائمة** إلى **.env**، وعدل أسطر `NAME=value` واختر **تجهيز التغييرات**. في الحالتين، ينتظر التعديل [كتغيير مجهز](/ar/docs/staged-changes). 3. اضغط `⌘K`، واختر **مراجعة التغييرات**، ثم اضغط `⌘↵` لكي [تطبقه](/ar/docs/apply-changes). وتطبيقه ينشر كل خدمة ويب يصل إليها المتغير. كل متغير يصل إلى [البناء](/ar/docs/builds) وإلى الخدمة وهي تعمل معا، فلا يوجد ما تختاره. في الـ [CLI](/ar/docs/install-the-cli)، يجهز أمر `vars set` المتغير أيضا، ويطبقه `--apply` في المرة نفسها: ```sh ghaym cloud vars set API_URL https://api.example.com --project shop --env production --service web --apply ``` ## شارك متغيرا مع البيئة كلها يصل المتغير المشترك إلى كل خدمة في البيئة. يظهر عليه **من البيئة** في صفحة الخدمة. وإذا كان للخدمة متغير خاص بها بالاسم نفسه، فهو الذي يعمل، ويكتب على المشترك **متجاوز**. وعبر الـ CLI، لا تضع `--service`: ```sh ghaym cloud vars set LOG_LEVEL info --project shop --env production ``` ## أبق القيمة سرية شغل **سرية** وأنت تضيف المتغير، أو اختر **اجعل القيمة سرية** من قائمة متغير موجود. لا تعرض قيمته مرة أخرى، ولا حتى لك، ولا يعود المتغير السري عاديا أبدا. ويصل المتغير السري إلى البناء وإلى الخدمة وهي تعمل كأي متغير آخر. - في سجلات البناء، يخفي غيم قيمته فتظهر `••••••••` أينما طبعت، متى كانت القيمة 4 أحرف أو أكثر. - في أسطر الأوامر التي يشغلها غيم للبناء، تحل محله قيمة بديلة، ولا تظهر قيمته أبدا. - المتغير الذي تشير قيمته إلى متغير سري، أو إلى كلمة مرور قاعدة بيانات، أو إلى المفتاح السري لمخزن، هو متغير سري أيضا. - ما تفعله خطوات البناء الخاصة بك وكودك بالقيمة أمر يخصك: لا يخفي غيم شيئا من الأسطر التي يكتبها تطبيقك في سجلاته. ```sh ghaym cloud vars set STRIPE_KEY --project shop --env production --service web --secret ``` ## اقرأ المتغيرات في Dockerfile الخدمة التي تبنى بـ `Dockerfile` تأخذ كل متغير عادي كـ build arg، وكل متغير سري كـ build secret. اقرأ المتغير العادي بـ `ARG`، واربط المتغير السري بالخطوة التي تحتاجه: ```dockerfile ARG VITE_API_URL RUN --mount=type=secret,id=STRIPE_KEY,env=STRIPE_KEY npm run build ``` المتغير السري لا يكون build arg أبدا، فلا يقرأ `ARG STRIPE_KEY` شيئا. والمتغير العادي لا يكون build secret أبدا، فلا يجد ربطه شيئا. تغيير قيمة متغير سري يعيد بناء الخدمة دون الـ cache. وتغيير متغير عادي يبقي الطبقات التي فوق أول `ARG` يقرؤه. والخدمة التي تبنى دون `Dockerfile` لا تحتاج شيئا إضافيا: كل خطوة من بنائها تأخذ كل متغير، وكل متغير سري كـ build secret. ## ثبت الحزم من npm registry خاص أضف إلى الـ repo ملف `.npmrc` يسمي الـ token باسم متغيره، واضبط `NPM_TOKEN` كمتغير سري: ```ini @acme:registry=https://npm.pkg.github.com //npm.pkg.github.com/:_authToken=${NPM_TOKEN} ``` الخدمة التي تبنى دون `Dockerfile` لا تحتاج أكثر من ذلك. وفي `Dockerfile`، انسخ `.npmrc` مع ملفات الحزم، واربط المتغير السري بخطوة التثبيت: ```dockerfile COPY package.json package-lock.json .npmrc ./ RUN --mount=type=secret,id=NPM_TOKEN,env=NPM_TOKEN npm ci ``` ## اربط قاعدة بيانات أو مخزنا لا تصل قيم قاعدة البيانات إلى الخدمة إلا عبر متغير تراه. اجعل قيمة المتغير مرجعا: `${{postgres.DATABASE_URL}}` يقرأ `DATABASE_URL` من قاعدة البيانات التي اسمها `postgres`، ويملؤه غيم وقت النشر. مرجع مثل `${{Service.VAR}}` يعمل داخل موقع واحد فقط. وتصل إلى خدمة الويب في موقع آخر عبر عنوانها العام. اختر **نسخ كمرجع** من قائمة متغير في صفحة قاعدة البيانات، وضعه كقيمة. ```sh ghaym cloud vars set DATABASE_URL '${{postgres.DATABASE_URL}}' --project shop --env production --service web ``` وما دامت خدمة الويب لا تشير إلى أي متغير من متغيرات قاعدة بيانات، تكتب صفحة متغيراته **postgres غير موصولة بهذه الخدمة.** اختر هناك **أضف DATABASE_URL** لتجهيز المرجع، أو **تجاهل** لإخفاء السطر. [ربط مخزن](/ar/docs/bucket-connections) يجهز ستة متغيرات على الخدمة، من `S3_ENDPOINT` إلى `S3_REGION`، كل منها مرجع إلى متغير المخزن نفسه: `${{bucket:media.S3_BUCKET}}` يقرأ `S3_BUCKET` من المخزن الذي اسمه `media`. يمكنك أن تغير أسماءها أو تحذفها، وفصل المخزن يزيلها. ## القيم التي يضيفها غيم يضيف غيم أربع قيم من عنده. والمتغير الذي تضبطه بالاسم نفسه يحل محل كل منها. | الاسم | القيمة | تصل إلى | | --- | --- | --- | | `GHAYM_COUNTRY` | رمز الدولة التي تعمل فيها الخدمة، مثل `JO` | البناء والخدمة وهي تعمل | | `GHAYM_SITE` | الموقع الذي تعمل فيه، مثل `amman-1` | البناء والخدمة وهي تعمل | | `PORT` | **منفذ التطبيق** | الخدمة وهي تعمل | | `NODE_OPTIONS` | `--max-old-space-size` بنسبة 75% من ذاكرة الخدمة | الخدمة وهي تعمل | ## شغل الـ migrations عند التشغيل لا يصل البناء إلى الشبكة الخاصة بالمشروع، فلا تصل الـ migration إلى قاعدة بياناتك أثناءه. شغل الـ migrations عند بدء التطبيق بدلا من ذلك، في **أمر التشغيل** في [إعدادات البناء](/ar/docs/build-settings): ```sh npx prisma migrate deploy && node server.js ``` Source: https://ghaym.me/docs/apply-changes.md # راجع التغييرات وطبقها اعرف ما هو مجهز في البيئة، ثم طبقه كله مرة واحدة أو تجاهله. ## طبق التغييرات 1. افتح البيئة واضغط `⌘K` واختر **مراجعة التغييرات**. تعرض الصفحة كل [تغيير مجهز](/ar/docs/staged-changes) في البيئة وما يفعله كل واحد منها. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud changes show --project shop --env production ``` 2. اضغط `⌘↵`، أو اختر **تطبيق التغييرات**. تطبق كل التغييرات التي في القائمة معا، والتغيير على متغير أو على ربط مخزن أو على الـ branch أو على إعداد بناء ينشر كل موقع يغيره. الحجم والنسخ والتوزيع والقراء والوصول تطبق دون نشر. في الـ CLI: ```sh ghaym cloud changes apply --project shop --env production ``` ## تجاهل التغييرات اضغط `⌘K`، واختر **مراجعة التغييرات**، وحدد التغييرات التي لا تريدها واختر **تجاهل المحدد**. وعبر الـ CLI، تجاهل كل ما هو مجهز في البيئة: ```sh ghaym cloud changes discard --project shop --env production ``` Source: https://ghaym.me/docs/scaling.md # كبر الخدمة أو صغرها غير حجم الخدمة، وزد نسخها، واختر كيف تصل إليها الطلبات. ## غير الحجم أو النسخ 1. افتح الخدمة واضغط `⌘K` واختر **الإعدادات › الحجم**، ثم اختر حجما. لكل حجم [سعر](/ar/docs/limits-and-prices) خاص. ولكل بيئة حجمها، ولا يصل التغيير في بيئة إلى غيرها. ينتظر التغيير [كتغيير مجهز](/ar/docs/staged-changes). في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud services set web instanceSizeSlug= ``` 2. لتشغل نسخا أكثر من الخدمة، اختر **الإعدادات › النسخ** واختر عددا. خطتك تحدد أكبر عدد تستطيع تشغيله. في الـ CLI: ```sh ghaym cloud services scale web --replicas 3 ``` 3. اضغط `⌘K`، واختر **مراجعة التغييرات**، ثم اضغط `⌘↵` لكي [تطبقه](/ar/docs/apply-changes). يطبق الحجم والنسخ دون نشر جديد. في الـ CLI: ```sh ghaym cloud changes apply --project shop ``` ## اختر كيف تصل الطلبات إلى النسخ التوزيع يحدد أي نسخة ترد على الطلب. | التوزيع | ما يفعله | | --- | --- | | **بالتساوي** | يرسل كل طلب إلى النسخة التالية بالدور. اختره عندما لا يحفظ التطبيق شيئا عن الزائر في الذاكرة. | | **كل زائر لنسخته** | الجلسات الثابتة (sticky sessions). تبقي cookie اسمها `ghaym_replica` كل زائر على النسخة التي ردت عليه أول مرة. اختره عندما يحفظ التطبيق الجلسات في الذاكرة. | اضغط `⌘K`، واختر **الإعدادات › التوزيع**، واختر واحدا منهما. ثم طبق التغيير. ```sh ghaym cloud services scale web --routing same_visitor --apply ``` تضيف قاعدة البيانات أو الكاش [قراء](/ar/docs/database-readers) بدلا من النسخ. ويتغير حجمها بالطريقة نفسها، في كل بيئة، لكن إلى حجم له القرص نفسه فقط: الحجم الجديد يغير ذاكرتها وسعرها. في الـ CLI: ```sh ghaym cloud services set db databaseSizeSlug= ``` Source: https://ghaym.me/docs/databases.md # أضف قاعدة بيانات أضف قاعدة بيانات PostgreSQL أو MySQL يديرها غيم، واجعل خدمات المشروع تصل إليها. ## أضف القاعدة 1. افتح [المشروع](/ar/docs/projects-and-services)، واضغط `⌘K` واختر **إضافة خدمة › PostgreSQL** أو **إضافة خدمة › MySQL**. أما Redis، [فأضف كاش](/ar/docs/caches) بدلا منها. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud services create --project shop --type database --engine postgres --name db --db-size --site ``` ولإضافة MySQL، اكتب `--engine mysql`. 2. اختر الإصدار، ثم اكتب الاسم واضغط Enter. ثم اختر [الموقع](/ar/docs/countries-and-sites) الذي تعمل فيه قاعدة البيانات، ولا يتغير لاحقا، ثم الحجم إذا كان هناك أكثر من واحد. PostgreSQL متوفرة بالإصدارات 16 و 17 و 18، ويكون 18 هو المختار في البداية. و MySQL متوفرة بالإصدار 8.4. ويعرض `ghaym cloud engines list` المحركات التي يشغلها غيم وإصداراتها. ويأتي المحركان بحجمين، 512 MB و 1 GB، والحجم الواحد له [السعر](/ar/docs/limits-and-prices) نفسه في المحركين. ## اربط خدماتك بالقاعدة لا تصل قيم قاعدة البيانات إلى الموقع إلا عبر [متغير](/ar/docs/variables) يعرضه الموقع. اجعل قيمة المتغير مرجعا: `${{db.DATABASE_URL}}` يقرأ `DATABASE_URL` من قاعدة البيانات التي اسمها `db`. وفي صفحة القاعدة، اختر **نسخ كمرجع** من قائمة المتغير لتنسخ هذا الشكل. توفر PostgreSQL المتغيرات `DATABASE_URL` و `DATABASE_READER_URL` و `PGHOST` و `PGPORT` و `PGUSER` و `PGPASSWORD` و `PGDATABASE`. وتوفر MySQL المتغيرات `DATABASE_URL` و `DATABASE_READER_URL` و `MYSQL_HOST` و `MYSQL_PORT` و `MYSQL_USER` و `MYSQL_PASSWORD` و `MYSQL_DATABASE`، على المنفذ 3306. ويبدأ `DATABASE_URL` فيها بـ `mysql://`. وتحجز MySQL الأسماء `mysql` و `sys` و `performance_schema` و `information_schema` لقواعدها الخاصة. فإذا سميت قاعدة MySQL باسم واحد منها، والشرطة فيه مكان الشرطة السفلية، يضيف غيم `_db` إلى اسم القاعدة الداخلية: `mysql` تصبح `mysql_db`، و `performance-schema` تصبح `performance_schema_db`. وهذا الاسم هو ما يحمله `MYSQL_DATABASE`. وما دام الموقع لا يشير إلى أي متغير من متغيرات قاعدة البيانات، تكتب صفحة متغيراته **db غير موصولة بهذه الخدمة.** اختر هناك **أضف DATABASE_URL** لتجهيز المرجع بخطوة واحدة. الموقع الذي تنشره من مستودع يذكر ملف `.env.example` فيه `DATABASE_URL`، في مشروع فيه قاعدة PostgreSQL أو MySQL واحدة، يبدأ وهذا المرجع مضبوط عليه. وإذا كانت في المشروع قاعدتان، يترك غيم `DATABASE_URL` لتضبطه بنفسك. وفي الـ CLI، اضبط المرجع على الموقع بنفسك: ```sh ghaym cloud vars set DATABASE_URL '${{db.DATABASE_URL}}' --project shop --env production --service web ``` ## تأكد افتح القاعدة. تحت **الاتصال**، يعرض قسم **داخل المشروع** المضيف والمنفذ واسم القاعدة والمستخدم التي تستعملها خدماتك، ولا شيء منها سري. وإذا أردت أن تفتح القاعدة من حاسوبك المحمول، [فاتصل بها عبر tunnel](/ar/docs/database-tunnels). ```sh ghaym cloud services connection db ``` Source: https://ghaym.me/docs/caches.md # أضف كاش أضف كاش Redis يديره غيم، واجعل خدمات المشروع تصل إليه. ## أضف الكاش 1. افتح [المشروع](/ar/docs/projects-and-services)، واضغط `⌘K` واختر **إضافة خدمة › Redis**. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud services create --project shop --type cache --engine redis --name cache --db-size --site ``` 2. اختر الإصدار، ثم اكتب الاسم واضغط Enter. ثم اختر [الموقع](/ar/docs/countries-and-sites) الذي يعمل فيه الكاش، ولا يتغير لاحقا، ثم الحجم إذا كان هناك أكثر من واحد. Redis متوفر بالإصدارين 7 و 8، ويكون 8 هو المختار في البداية. ويعرض `ghaym cloud engines list` المحركات التي يشغلها غيم وإصداراتها. والأحجام 512 MB و 1 GB، ولكل حجم [سعر](/ar/docs/limits-and-prices) خاص. ## اربط خدماتك بالكاش لا تصل قيم الكاش إلى الموقع إلا عبر [متغير](/ar/docs/variables) يعرضه الموقع. اجعل قيمة المتغير مرجعا: `${{cache.REDIS_URL}}` يقرأ `REDIS_URL` من الكاش الذي اسمه `cache`. يوفر Redis المتغيرات `REDIS_URL` و `REDIS_READER_URL` و `REDIS_HOST` و `REDIS_PORT` و `REDIS_PASSWORD`. وما دام الموقع لا يشير إلى أي متغير من متغيرات الكاش، تكتب صفحة متغيراته **cache غير موصولة بهذه الخدمة.** اختر هناك **أضف REDIS_URL** لتجهيز المرجع بخطوة واحدة. وفي الـ CLI، اضبط المرجع على الموقع بنفسك: ```sh ghaym cloud vars set REDIS_URL '${{cache.REDIS_URL}}' --project shop --env production --service web ``` يستطيع الكاش أن يشغل [قراء](/ar/docs/database-readers) كما تفعل قاعدة البيانات. أما [النسخ الاحتياطية](/ar/docs/database-backups) فتغطي قواعد البيانات فقط، لا الكاش. ## تأكد افتح الكاش. تحت **الاتصال**، يعرض قسم **داخل المشروع** المضيف والمنفذ اللذين تستعملهما خدماتك. وإذا أردت أن تفتح الكاش من حاسوبك المحمول، [فاتصل به عبر tunnel](/ar/docs/database-tunnels). ```sh ghaym cloud services connection cache ``` Source: https://ghaym.me/docs/database-tunnels.md # اتصل بقاعدة البيانات من جهازك افتح tunnel من port على جهازك إلى قاعدة البيانات، لكي يستطيع أي برنامج على حاسوبك استخدامها. ## افتح tunnel 1. افتح [قاعدة البيانات](/ar/docs/databases)، وتحت **الاتصال** اختر **نسخ** لكي تنسخ أمر الـ tunnel الخاص بها. شغله في التيرمينال. وفي الـ [CLI](/ar/docs/install-the-cli)، تستطيع أيضا أن تكتبه بنفسك: ```sh ghaym cloud connect db --env production ``` 2. يطبع الأمر رابطا على `127.0.0.1`، ثم المضيف والـ port والقاعدة والمستخدم التي يطلبها أي برنامج. الصق الرابط في برنامجك. ومع PostgreSQL و MySQL يطبع أيضا الأمر الذي يفتح برنامج المحرك نفسه، `psql` أو `mysql`. يسجل غيم الدخول نيابة عن البرنامج، فلا تظهر كلمة سر في أي شيء مما يطبعه الأمر. 3. اضغط Ctrl-C لكي تغلق الـ tunnel. يأخذ الـ tunnel الـ port الأصلي للقاعدة إذا كان متاحا، وإلا فيأخذ أول port متاح بعده. يستطيع المالكون والمديرون والمطورون فتحه. ## اختر ما تتصل به - `--reader` يوصلك بقراء القاعدة بدل الكاتب. وإذا لم يكن هناك قراء، يوصلك بالكاتب ويخبرك بذلك. - `--port` يختار الـ port على جهازك. وإذا كان للقاعدة قراء، فإن **أوامر أخرى** بجانب **نسخ** تحتوي على هذه الأوامر أيضا. ```sh ghaym cloud connect db --env production --reader ``` ## اتصل بقاعدة نائمة خارج الإنتاج، [تنام](/ar/docs/sleep) القاعدة مع بيئتها، ويتوقف الأمر بخطأ. أضف `--wake` لكي يوقظها ويتصل، والأمر الذي تنسخه من الـ console يحتوي عليه عندما تكون نائمة. وما دام الـ tunnel مفتوحا، تبقى القاعدة مستيقظة. ```sh ghaym cloud connect db --env staging --wake ``` Source: https://ghaym.me/docs/database-readers.md # أضف قارئا لقاعدة البيانات أضف قراء لقاعدة البيانات أو الكاش، وهي نسخ للقراءة فقط تتبع الكاتب. ## أضف قارئا 1. افتح [قاعدة البيانات](/ar/docs/databases) أو [الكاش](/ar/docs/caches)، واضغط `⌘K` واختر **الإعدادات › القراء**، ثم اختر **كاتب + قارئ** أو أكثر. تحدد خطتك عدد القراء الذين تستطيع تشغيلهم. ينتظر التغيير [كتغيير مجهز](/ar/docs/staged-changes). في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud services scale db --readers 1 ``` 2. اضغط `⌘K`، واختر **مراجعة التغييرات**، ثم اضغط `⌘↵` لكي [تطبقه](/ar/docs/apply-changes). ينسخ القارئ بيانات الكاتب وينضم دون نشر. في الـ CLI: ```sh ghaym cloud changes apply --project shop ``` ## اقرأ منه تصل خدماتك إلى القراء عبر [متغير](/ar/docs/variables) يشير إلى `DATABASE_READER_URL`، أو إلى `REDIS_READER_URL` للكاش، ويبقى `DATABASE_URL` أو `REDIS_URL` على الكاتب. وإذا توقف جهاز الكاتب، يعمل الكاتب من جديد على جهاز آخر بنسخة من قرصه، ولا يأخذ أي قارئ مكانه. ويبقى `DATABASE_URL` أو `REDIS_URL` كما هو. ## احذف القراء اضغط `⌘K`، واختر **الإعدادات › القراء › كاتب فقط**، وطبق التغيير. ```sh ghaym cloud services scale db --readers 0 --apply ``` Source: https://ghaym.me/docs/database-backups.md # خذ نسخة احتياطية من القاعدة واسترجعها خذ نسخة احتياطية من قاعدة البيانات كل ليلة أو متى شئت، واسترجعها في قاعدة جديدة. ## خذ نسخة الآن افتح [قاعدة البيانات](/ar/docs/databases)، واضغط `⌘K` واختر **النسخ الاحتياطية › خذ نسخة احتياطية الآن**. تستيقظ القاعدة النائمة أولا، فتكون النسخة للقاعدة كما هي. وتحصل كل قاعدة PostgreSQL أو MySQL أيضا على نسخة احتياطية كل ليلة، منذ إضافتها. وإذا أردت إيقاف ذلك، اختر **النسخ الاحتياطية › كل ليلة** وأطفئه. يعتمد عدد النسخ المحفوظة على [خطتك](/ar/docs/limits-and-prices). النسخ الاحتياطية لقواعد البيانات فقط، لا [للكاش](/ar/docs/caches). ## استرجع نسخة 1. اضغط `⌘K` واختر **النسخ الاحتياطية › كل النسخ الاحتياطية**، ثم اختر نسخة. 2. اختر **استرجاع**. يسترجع غيم النسخة في قاعدة جديدة بجانب القديمة، بالسعر الشهري المكتوب على السطر، ولا يلمس القديمة أبدا. 3. وجه خدماتك إلى القاعدة الجديدة عبر [المتغير](/ar/docs/variables) `DATABASE_URL` الخاص بها. ## احذف نسخة اختر النسخة من **النسخ الاحتياطية › كل النسخ الاحتياطية** واختر **حذف النسخة الاحتياطية**. Source: https://ghaym.me/docs/templates.md # القوالب شغل تطبيقا مفتوح المصدر في مشروعك: ينشئ القالب خدماته وقاعدة بياناته، ثم تصبح كلها ملكك كأي خدمة أخرى. ## القوالب المتاحة - [Supabase (استضافة ذاتية)](/ar/docs/templates/supabase) · قاعدة بيانات وتسجيل دخول وملفات لتطبيقك - [Umami](/ar/docs/templates/umami) · إحصاءات زوار موقعك ## شغل قالبا 1. افتح [المشروع](/ar/docs/projects-and-services)، واضغط `⌘K` واختر **إضافة خدمة › القوالب**، ثم اختر القالب. 2. تعرض الشاشة التالية كل ما ينشئه القالب، بحجمه وسعره الشهري. اختر [الموقع](/ar/docs/countries-and-sites)، وغير الأحجام إن شئت، واملأ ما يطلبه القالب، ثم اضغط **تطبيق**: ينشر القالب فورا. إذا كانت في البيئة [تغييرات مجهزة](/ar/docs/staged-changes) من قبل، يكون الزر **تجهيز**، ثم [تطبق القالب معها](/ar/docs/apply-changes) من **مراجعة التغييرات**. 3. إذا أنشأ القالب قيما سرية، يعرضها غيم مرة واحدة، بعد التطبيق مباشرة، في النافذة التي طبقت منها. انسخها قبل أن تضغط **تم**. Source: https://ghaym.me/docs/templates/supabase.md # Supabase (استضافة ذاتية) قاعدة بيانات وتسجيل دخول ومخزن ملفات لتطبيقك من نسخة Supabase مفتوحة المصدر، على قاعدة PostgreSQL يديرها غيم، وغيم لا يتبع شركة Supabase. ## ما ينشئه | الاسم | النوع | الحجم الأساسي | شهريا في amman-1 | |---|---|---|---| | `supabase` | خدمة ويب | Small | 18.000 د.أ | | `supabase-db` | قاعدة بيانات PostgreSQL | Database 1GB | 9.000 د.أ | | `supabase-files-` | مخزن | | 0.100 د.أ للغيغابايت | | **المجموع، دون التخزين** | | | **27.000 د.أ** | تشغل خدمة `supabase` سبع حاويات معا، بحجم واحد وعنوان واحد: - `gateway`: المدخل. كل الطلبات تمر بها. - `auth`: تسجيل الدخول والمستخدمون. - `rest`: واجهة REST لجداولك. - `realtime`: التحديثات المباشرة. - `storage`: الملفات، وتحفظها في مخزن القالب. - `meta`: تقرأ بنية القاعدة لـ Studio. - `studio`: لوحة Supabase. ## ما تضبطه بعد التشغيل - انسخ `SERVICE_ROLE_KEY` و `DASHBOARD_PASSWORD` من الشاشة التي تظهر بعد التطبيق. لا تظهران مرة أخرى. - المفتاح العام `ANON_KEY` في متغيرات `supabase`، وتقرؤه متى شئت. - اضبط `GOTRUE_SITE_URL` في متغيرات `supabase` على عنوان تطبيقك، ليعود إليه المستخدم بعد تأكيد بريده. - اضبط `SUPABASE_PUBLIC_URL` في متغيرات `supabase` على عنوان الخدمة العام، لتشير إليه روابط تأكيد البريد. - لتغيير خادم البريد لاحقا، عدل متغيرات `GOTRUE_SMTP_*` في `supabase`. - اسم المستخدم في رابط الاتصال بالقاعدة هو `ghaym`. أدلة Supabase تكتب `postgres`، وعلى غيم استخدم `ghaym`. - GraphQL متوقف في البداية. لتشغيله، نفذ `create extension pg_graphql;` في محرر SQL في Studio. - نسخة Realtime أحدث من نسخة القالب قد تفشل في ترحيلاتها، لأنها تحتاج دورا لا تعطيه القاعدة. ## افتح Studio افتح عنوان `supabase` في المتصفح. اسم المستخدم `supabase`، وكلمة المرور هي `DASHBOARD_PASSWORD`. ## انقل مشروعا قائما لنقل قاعدة مشروع Supabase مستضاف ذاتيا وملفاته ومفاتيحه إلى غيم، اتبع [الانتقال من Supabase المستضاف ذاتيا](/ar/docs/templates/move-from-self-hosted-supabase). Source: https://ghaym.me/docs/templates/umami.md # Umami إحصاءات زوار موقعك من نسخة Umami مفتوحة المصدر، على قاعدة PostgreSQL يديرها غيم، وغيم لا يتبع Umami. ## ما ينشئه | الاسم | النوع | الحجم الأساسي | شهريا في amman-1 | |---|---|---|---| | `umami` | خدمة ويب | Nano | 4.500 د.أ | | `umami-db` | قاعدة بيانات PostgreSQL | Database 1GB | 9.000 د.أ | | **المجموع** | | | **13.500 د.أ** | تشغل خدمة `umami` حاوية واحدة، `umami`. ## ما تضبطه بعد التشغيل - لا شيء في البداية: `DATABASE_URL` يشير إلى `umami-db`، و `APP_SECRET` سر يولده غيم عند التطبيق. - افتح عنوان `umami` في المتصفح وادخل باسم المستخدم `admin` وكلمة المرور `umami`، وهو الحساب الأول الذي ينشئه Umami. غير كلمة المرور هذه من إعدادات Umami فورا. - أضف موقعك في Umami، ثم ضع رمز التتبع الذي يعطيك إياه في صفحات موقعك. Source: https://ghaym.me/docs/templates/move-from-self-hosted-supabase.md # الانتقال من Supabase المستضاف ذاتيا انقل قاعدة مشروع Supabase مستضاف ذاتيا وملفاته ومفاتيحه إلى قالب Supabase على غيم، وتنفذ كل خطوة من جهازك. ## قبل أن تبدأ - [شغل قالب Supabase](/ar/docs/templates/supabase) في المشروع الذي تنتقل إليه، وطبقه. - ثبت `pg_dump` و `pg_restore` و `psql` من PostgreSQL 17 أو أحدث، والـ [CLI](/ar/docs/install-the-cli)، و rclone 1.70 أو أحدث. - افتح [نفقا](/ar/docs/database-tunnels) إلى قاعدة القالب، واتركه مفتوحا: ```sh ghaym cloud connect supabase-db --env production ``` - في نافذة طرفية ثانية، احفظ رابط المصدر بمستخدمه `postgres`، والرابط الذي يطبعه النفق بالمستخدم `ghaym`. نفذ كل خطوة مما يلي في هذه النافذة: ```sh export SRC='postgres://postgres:@:5432/postgres' export DST='' ``` ## 1. انسخ البنية خذ نسخة من المصدر، واترك المخططات التي تنشئها خدمات Supabase نفسها، واستعد الباقي قبل صفوفه، مع تحويل كل مالك وصلاحية باسم `postgres` إلى `ghaym`: ```sh M='auth|storage|realtime|_realtime|extensions|graphql|graphql_public|vault|pgbouncer|cron|net|supabase_functions|pgsodium|pgsodium_masks|pgtle|topology' pg_dump -Fc -Z0 "$SRC" > move.dump pg_restore -l move.dump | grep -v -E "^[0-9]+; [0-9]+ [0-9]+ [A-Z ]+ ($M) |EVENT TRIGGER|^[0-9]+; [0-9]+ [0-9]+ SCHEMA - ($M) |COMMENT - EXTENSION|PUBLICATION - supabase_realtime |ACL pg_catalog |ACL - SCHEMA ($M) |DEFAULT ACL .* supabase_admin$" > move.list rewrite() { sed -E 's/(OWNER TO|TO|FROM|FOR ROLE) postgres([;, ])/\1 ghaym\2/g'; } pg_restore -L move.list --section=pre-data -f - move.dump | rewrite | psql -q -v ON_ERROR_STOP=1 "$DST" ``` ## 2. انسخ المستخدمين وسجلات الملفات انسخ صفوف تسجيل الدخول والتخزين جدولا جدولا، والمستخدمين أولا، بأعمدة المصدر التي لا تولدها القاعدة الجديدة فقط. ثم املأ أعمدة الرموز التي يقرؤها GoTrue نصا، وقدم عداد رموز التجديد إلى ما بعد صفوف الطرفين: ```sh T='auth.users auth.identities auth.sessions auth.refresh_tokens auth.mfa_factors auth.mfa_challenges auth.mfa_amr_claims auth.one_time_tokens auth.audit_log_entries storage.buckets storage.objects storage.s3_multipart_uploads storage.s3_multipart_uploads_parts' for t in $T; do s=${t%.*}; n=${t#*.} sc=$(psql -tA "$SRC" -c "select string_agg(column_name, ',') from information_schema.columns where table_schema='$s' and table_name='$n'") [ -z "$sc" ] && continue cols=$(psql -tA "$DST" -c "select string_agg(quote_ident(column_name), ',' order by ordinal_position) from information_schema.columns where table_schema='$s' and table_name='$n' and is_generated='NEVER' and column_name = any(string_to_array('$sc', ','))") [ -z "$cols" ] && continue psql "$SRC" -c "\copy (select $cols from $t) to stdout" | psql "$DST" -c "\copy $t($cols) from stdin" done psql "$DST" -c "update auth.users set confirmation_token = coalesce(confirmation_token, ''), recovery_token = coalesce(recovery_token, ''), email_change_token_new = coalesce(email_change_token_new, ''), email_change = coalesce(email_change, ''), email_change_token_current = coalesce(email_change_token_current, ''), phone_change = coalesce(phone_change, ''), phone_change_token = coalesce(phone_change_token, ''), reauthentication_token = coalesce(reauthentication_token, '')" sv=$(psql -tA "$SRC" -c "select last_value from auth.refresh_tokens_id_seq") psql "$DST" -c "select setval('auth.refresh_tokens_id_seq', greatest($sv, (select coalesce(max(id), 1) from auth.refresh_tokens)))" ``` ## 3. انسخ صفوفك استعد الصفوف، ثم القيود والمفاتيح الخارجية والسياسات، من القائمة نفسها وبالتحويل نفسه: ```sh pg_restore -L move.list --section=data --section=post-data -f - move.dump | rewrite | psql -q -v ON_ERROR_STOP=1 "$DST" ``` ## 4. انسخ مشغلاتك على auth و storage تضع النسخة مشغلا مثل `on_auth_user_created` تحت مخطط جدوله، والخطوة 1 تركت ذلك المخطط. ابحث عن مشغلاتك على جداول `auth` و `storage` بالمخطط الذي تقع فيه دالتها، وأنشئها من جديد: ```sh psql -tA "$SRC" -c "select pg_get_triggerdef(t.oid) || ';' from pg_trigger t join pg_class c on c.oid = t.tgrelid join pg_proc p on p.oid = t.tgfoid where not t.tgisinternal and c.relnamespace::regnamespace::text in ('auth', 'storage') and p.pronamespace::regnamespace::text !~ '^($M)\$'" > triggers.sql psql -v ON_ERROR_STOP=1 "$DST" -f triggers.sql ``` ## 5. انسخ سياساتك على auth و storage وتركت الخطوة 1 أيضا السياسات على جداول `auth` و `storage`، مثل سياسة على `storage.objects` تسمح للمستخدم بقراءة ملفاته. اقرأ سياسات المصدر من `pg_policies`، وأنشئ من جديد كل سياسة ليست في القالب: ```sh psql -tA "$SRC" -c "select format('do \$p\$ begin if not exists (select from pg_policies where schemaname = %L and tablename = %L and policyname = %L) then create policy %I on %I.%I as %s for %s to %s%s%s; end if; end \$p\$;', schemaname, tablename, policyname, policyname, schemaname, tablename, permissive, cmd, array_to_string(roles, ', '), ' using (' || qual || ')', ' with check (' || with_check || ')') from pg_policies where schemaname in ('auth', 'storage')" > policies.sql psql -v ON_ERROR_STOP=1 "$DST" -f policies.sql ``` ## انسخ الملفات انسخ الملفات من مجلد التخزين في المصدر إلى مخزن القالب بـ rclone، بمفاتيح المخزن من `ghaym cloud buckets credentials get --show`: ```sh export RCLONE_CONFIG_GHAYM_TYPE=s3 export RCLONE_CONFIG_GHAYM_PROVIDER=Other export RCLONE_CONFIG_GHAYM_ENDPOINT=https://s3.jo.cloud.ghaym.me export RCLONE_CONFIG_GHAYM_REGION=jo export RCLONE_CONFIG_GHAYM_FORCE_PATH_STYLE=false export RCLONE_CONFIG_GHAYM_SIGN_ACCEPT_ENCODING=false export RCLONE_CONFIG_GHAYM_ACCESS_KEY_ID='' export RCLONE_CONFIG_GHAYM_SECRET_ACCESS_KEY='' rclone copy ./volumes/storage/stub ghaym: ``` `stub` هو `GLOBAL_S3_BUCKET` في المصدر، وهو المجلد الذي تكتب فيه خدمة التخزين ملفاتها، فإن غيرته فضع قيمتك مكانه. لمخزن خارج الأردن، ضع رمزه مكان `jo`، كما تظهره **منطقة التوقيع** في صفحة المخزن. ## احتفظ بمفاتيحك اضبط `JWT_SECRET` و `ANON_KEY` و `SERVICE_ROLE_KEY` من المصدر على `supabase`، لتبقى المفاتيح التي تحملها تطبيقاتك صالحة: ```sh ghaym cloud vars set JWT_SECRET '' --project --env production --service supabase --secret ghaym cloud vars set ANON_KEY '' --project --env production --service supabase ghaym cloud vars set SERVICE_ROLE_KEY '' --project --env production --service supabase --secret --apply ``` ## ما لا ينتقل لا تنتقل Edge Functions، لأن غيم لا يشغلها. الكائن الذي يحتاج صلاحيات superuser، مثل دالة بلغة C أو إضافة ليست في القالب، يوقف الاستعادة. احذف سطره من `move.list` وأعد الخطوة. صورة خدمة أحدث من صورة القالب، ومنها Realtime، قد تفشل في ترحيلاتها. أسرار Vault لا تنتقل. أنشئها من جديد في Studio بعد الاستعادة. Source: https://ghaym.me/docs/custom-domains.md # اربط نطاقك وجه نطاقك إلى خدمة، وتأكد من الـ DNS، وقرر إن كان عنوان ghaym.app سيبقى مفتوحا. ## اربط النطاق 1. افتح خدمة الويب واضغط `⌘K` واختر **الإعدادات › ربط نطاق**. اكتب الـ hostname، مثل `shop.example.com`، واضغط Enter. يربط النطاق فورا، بالخدمة التي في الإنتاج. تأخذ الخدمة في أي موقع مفتوح نطاقا مخصصا، ولا تذكر دولة عند ربطه. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud domains add web shop.example.com ``` 2. عند مزود الـ DNS الخاص بك، أضف السجلين اللذين يعرضهما النطاق تحت **سجلات DNS**: سجل CNAME من الـ hostname الخاص بك إلى عنوان الخدمة، وسجل TXT على `_ghaym-verify.shop.example.com` يثبت أن النطاق لك. في الـ CLI: ```sh ghaym cloud domains list web ``` ## تأكد يفحص غيم السجلات تلقائيا. يبقى مكتوبا على النطاق **قيد التحقق** حتى يجدها، ثم **يعمل**، أو **فشل التحقق** إذا كان سجل ناقصا أو خاطئا. وإذا أردت الفحص الآن، اضغط `⌘K` واختر **الإعدادات › تحقق الآن**. ```sh ghaym cloud domains verify web ``` ## أطفئ عنوان ghaym.app عندما يعمل نطاقك، تستطيع الخدمة أن ترد عليه وحده. اضغط `⌘K`، واختر **الإعدادات › الوصول › عنوان ghaym.app** لتجعله **مطفأ**، وطبق التغيير. وحتى يعمل نطاق، يكون مكتوبا على السطر **اربط نطاقا أولا لتطفئه**. راجع [الوصول](/ar/docs/access) لتعرف ما يمكنك فعله أيضا بوصول الخدمة. ```sh ghaym cloud access set web --reach custom-domain --apply ``` Source: https://ghaym.me/docs/private-services.md # اجعل الخدمة خاصة اجعل الخدمة ترد على خدمات مشروعها فقط، دون أي عنوان على الإنترنت. ## اجعلها خاصة 1. في الـ console، افتح الخدمة واضغط `⌘K`. اختر **الإعدادات › الوصول › خدمات المشروع فقط**. هكذا تصبح الخدمة [خاصة](/ar/docs/access)، ويبقى التغيير منتظرا [كتغيير مجهز](/ar/docs/staged-changes). في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud access set api --reach private ``` 2. اضغط `⌘K`، واختر **مراجعة التغييرات**، ثم اضغط `⌘↵` لكي [تطبقه](/ar/docs/apply-changes). في الـ CLI: ```sh ghaym cloud changes apply --project shop ``` ## تأكد اضغط `⌘K` واختر **الإعدادات**. بجانب **الوصول** سترى **خاصة**. تصل إليها باقي خدمات المشروع على `api:3000`. ```sh ghaym cloud access get api ``` ## أعد فتحها اضغط `⌘K`، واختر **الإعدادات › الوصول › الكل**، وطبق التغيير. ```sh ghaym cloud access set api --reach public --apply ``` Source: https://ghaym.me/docs/restricted-access.md # حدد من يمكنه فتح الخدمة اجعل أعضاء المشروع فقط، أو عناوين IP التي تحددها فقط، يفتحون الخدمة. ## اسمح للأعضاء فقط 1. افتح الخدمة واضغط `⌘K` واختر **الإعدادات › الوصول › أعضاء المشروع فقط**. هكذا تصبح الخدمة [مقيدة](/ar/docs/access)، وينتظر التغيير [كتغيير مجهز](/ar/docs/staged-changes). في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud access set web --members-only ``` 2. اضغط `⌘K`، واختر **مراجعة التغييرات**، ثم اضغط `⌘↵` لكي [تطبقه](/ar/docs/apply-changes). في الـ CLI: ```sh ghaym cloud changes apply --project shop ``` بعدها يسجل الزائر الدخول بغيم أولا، ولا يدخل إلا [أعضاء مساحة عملك](/ar/docs/team). ## اسمح لعناوين محددة فقط 1. اضغط `⌘K` واختر **الإعدادات › الوصول › تفتح من عناوين IP محددة فقط**. اكتب عنوان IP أو نطاق CIDR واضغط Enter، أو اختر **أضف عنوانك**. تتسع القائمة حتى 50 عنوانا. في الـ CLI: ```sh ghaym cloud access ips add web 203.0.113.7 198.51.100.0/24 ``` 2. طبق التغيير بالطريقة نفسها. لا يستطيع أي عنوان آخر فتح الخدمة. في الـ CLI: ```sh ghaym cloud changes apply --project shop ``` ## افتحها للجميع مرة أخرى اضغط `⌘K` واختر **الإعدادات › الوصول › الكل**. ولقائمة العناوين، اختر **امسح القائمة** من صفحتها. ثم طبق التغيير. ```sh ghaym cloud access set web --no-members-only ghaym cloud access ips clear web --yes --apply ``` Source: https://ghaym.me/docs/object-storage.md # احفظ ملفاتك في مخزن أنشئ مخزنا، وخذ عنوانه ومفاتيحه، واستعمله من أي S3 client. ## أنشئ مخزنا 1. في الـ console، اضغط `⌘K` واختر **مساحة العمل › مخزن جديد**. اكتب اسما من 3 إلى 63 حرفا: حروف لاتينية صغيرة وأرقام وشرطات، ويبدأ وينتهي بحرف أو رقم. الاسم هو عنوان المخزن، ولا يتغير لاحقا. 2. اختر الموقع الذي يعيش فيه المخزن واختر **إنشاء**. تبقى الملفات في الموقع الذي اخترته، ولا تتغير لاحقا. لا يكون لمخزنين الاسم نفسه، في أي موقع. المخزن تابع لـ [مساحة العمل](/ar/docs/workspaces-and-roles) وليس لمشروع، وليس له نشرات. إذا لم يكن في خطتك مكان لمخزن آخر، يعرض الـ console **لا متسع في الخطة لهذا المخزن** ولا ينشئ شيئا؛ مساحة كل خطة موجودة في [الحدود والأسعار](/ar/docs/limits-and-prices). تحسب الملفات المخزنة بالـ GB كل شهر، والملفات التي لم تقرأ منذ 30 يوما تحسب بسعر البارد، كما تشرح [الفوترة](/ar/docs/billing). ومن [الـ CLI](/ar/docs/cli-buckets)، `ghaym cloud buckets create --name my-bucket --site amman-1` ينشئ مخزنا، و `ghaym cloud buckets credentials get my-bucket --show` يطبع مفاتيحه عندما يجهز. > [!UNAVAILABLE] > نسخ الملفات القديمة، وقفل الملفات، ونسخة ثانية من المخزن، ونطاق خاص على المخزن. ## استعمله من الكود افتح المخزن من **المخازن**. تحت **العناوين** ثلاث قيم: - **العنوان العام**: `https://my-bucket.s3.jo.cloud.ghaym.me`، للتوقيع المسبق والقراءة العامة. - **العنوان داخل المشروع**: `http://s3`، من داخل شبكة المشروع فقط. - **منطقة التوقيع**: `jo`، رمز الدولة الذي يوقع به الـ S3 client. تحت **المفاتيح**، اختر **إظهار المفاتيح** لتقرأ الـ access key ID والـ secret access key. يقبل أي S3 client هذه القيم؛ لا توجد مكتبة من غيم عليك تنزيلها. لتعطي هذه القيم لخدمة كمتغيرات، [اربط المخزن بها](/ar/docs/bucket-connections). المخزن يربط بخدمة في موقعه وحده. من خدمة، استعمل العنوان داخل المشروع مع الـ path-style: ```js import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3"; const s3 = new S3Client({ endpoint: process.env.S3_ENDPOINT, region: process.env.S3_REGION, forcePathStyle: true, credentials: { accessKeyId: process.env.S3_ACCESS_KEY_ID, secretAccessKey: process.env.S3_SECRET_ACCESS_KEY, }, }); await s3.send( new PutObjectCommand({ Bucket: process.env.S3_BUCKET, Key: "reports/june.pdf", Body: bytes }), ); ``` ```python import os import boto3 from botocore.config import Config s3 = boto3.client( "s3", endpoint_url=os.environ["S3_ENDPOINT"], region_name=os.environ["S3_REGION"], aws_access_key_id=os.environ["S3_ACCESS_KEY_ID"], aws_secret_access_key=os.environ["S3_SECRET_ACCESS_KEY"], config=Config(s3={"addressing_style": "path"}), ) s3.upload_file("june.pdf", os.environ["S3_BUCKET"], "reports/june.pdf") ``` من حاسوبك، أو CI، أو خادم خارج غيم، أعط الـ client العنوان `https://s3.jo.cloud.ghaym.me` والمنطقة `jo`، واترك الـ path-style مطفأ: يضع الـ client اسم المخزن قبله، وهكذا ينتج العنوان العام. ```js const s3 = new S3Client({ endpoint: "https://s3.jo.cloud.ghaym.me", region: "jo", credentials: { accessKeyId: process.env.S3_ACCESS_KEY_ID, secretAccessKey: process.env.S3_SECRET_ACCESS_KEY, }, }); ``` ## اجعله عاما افتح المخزن، واضغط `⌘K` واختر **جعل المخزن عاما**. يستطيع أي شخص قراءة ملفات المخزن من الرابط. أما عرض الملفات والكتابة فيحتاجان إلى مفتاح. تعرض الملفات العامة من العنوان العام. لتغلقه مرة أخرى، اختر **جعل المخزن خاصا**: لا يقرأ ملف منه إلا بطلب موقع. ## دور المفاتيح أو احذفه لتبدل المفاتيح، افتح المخزن، واضغط `⌘K` واختر **تدوير المفاتيح**. إذا لم تكن هناك خدمة مربوطة، تتوقف المفاتيح الحالية فورا. وإذا كانت هناك خدمات مربوطة، تبقى المفاتيح الحالية صالحة حتى يعاد نشر الخدمات، يوما واحدا على الأكثر. وأي client آخر يستعملها يحتاج إلى المفاتيح الجديدة. لتحذف المخزن، اضغط `⌘K`، واختر **حذف المخزن** واكتب اسم المخزن للتأكيد. حذف المخزن يمحو ملفاته ومفاتيحه. ولا يبقى منه شيء. Source: https://ghaym.me/docs/bucket-connections.md # اربط مخزنا بخدمة أعط الخدمة ستة متغيرات تشير إلى المخزن، لكي يصل إليه الكود دون أن تنسخ مفاتيح. ## اربط مخزنا 1. افتح خدمة ويب في الـ console، واضغط `⌘K` واختر **الإعدادات › ربط مخزن**. اختر مخزنا، فينتظر الربط [كتغيير مجهز](/ar/docs/staged-changes). تظهر كل مخازن مساحة العمل مع موقع كل منها. يجب أن يكون لديك [مخزن](/ar/docs/object-storage) قبل ذلك. الربط للبيئة التي أنت فيها. اربط المخزن في كل بيئة تحتاجه. 2. اضغط `⌘K`، واختر **مراجعة التغييرات**، ثم اضغط `⌘↵` لكي [تطبقه](/ar/docs/apply-changes). عندما تطبقه تنشر الخدمة، ويرى الكود المخزن. ومن [الـ CLI](/ar/docs/cli-buckets)، `ghaym cloud buckets connect ` يجهز الربط في البيئة التي يحددها `--env`، و `--apply` يطبقه. يجهز الربط ستة [متغيرات](/ar/docs/variables) على الخدمة، كل منها مرجع إلى متغير المخزن نفسه (`${{bucket:.S3_*}}`): | المتغير | القيمة | | --- | --- | | `S3_ENDPOINT` | `http://s3`، العنوان داخل المشروع | | `S3_PUBLIC_ENDPOINT` | العنوان العام للمخزن، للتوقيع المسبق والقراءة العامة | | `S3_BUCKET` | اسم المخزن | | `S3_ACCESS_KEY_ID` | الـ access key ID | | `S3_SECRET_ACCESS_KEY` | الـ secret access key | | `S3_REGION` | رمز الدولة، مثل `jo` | يمكنك أن تغير أسماءها أو تحذفها. المخزن يربط بخدمة في موقعه وحده. ويرفض الربط عبر المواقع، ولا يجهز منه شيء. ## اربط مخزنا ثانيا يأخذ أول مخزن للخدمة الأسماء دون أي شيء قبلها. وإذا كانت الأسماء الستة مأخوذة على الخدمة، يطلب منك الـ console أن تعطي المخزن التالي بادئة. تأتي البادئة قبل كل اسم: `MEDIA_S3_BUCKET`. تبدأ بحرف كبير، ثم حروف كبيرة وأرقام وشرطات سفلية، حتى 21 حرفا. ## عند تدوير المفاتيح تشير المتغيرات إلى المخزن بدلا من أن تنسخ مفاتيحه. بعد أن [يدور أحد المفاتيح](/ar/docs/object-storage)، تبقى المفاتيح القديمة صالحة حتى يعاد نشر الخدمات المربوطة، يوما واحدا كحد أقصى، وتسمي صفحة المخزن الخدمات التي ما زالت تستعملها. انشرها من جديد لكي تأخذ المفاتيح الجديدة. ## افصله اضغط `⌘K` على الخدمة، واختر **الإعدادات › فصل مخزن** ثم اختر المخزن. الفصل يجهز أيضا. تفقد الخدمة في هذه البيئة كل متغير يشير إلى المخزن، حتى المتغيرات التي غيرت أسماءها، بعد تطبيق التغييرات. ولا يحذف أي شيء من المخزن. Source: https://ghaym.me/docs/browser-uploads.md # اسمح للمتصفح بالرفع إلى المخزن وقع رابط رفع على خادمك، لكي يرسل المتصفح الملفات إلى المخزن مباشرة دون أن يرى السر. ## كيف يعمل لا يحصل المتصفح على مفاتيح المخزن أبدا. يطلب من خادمك رابطا، فيوقعه خادمك بمفاتيح المخزن، ثم يرسل المتصفح الملف إلى هذا الرابط. ## ارفع ملفا 1. على خادمك، وقع رابطا للملف. مع [مخزن مربوط](/ar/docs/bucket-connections)، تملك الخدمة أصلا `S3_PUBLIC_ENDPOINT` و`S3_REGION` والمفاتيح: ```js import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3"; import { getSignedUrl } from "@aws-sdk/s3-request-presigner"; const signer = new S3Client({ region: process.env.S3_REGION, bucketEndpoint: true, requestChecksumCalculation: "WHEN_REQUIRED", credentials: { accessKeyId: process.env.S3_ACCESS_KEY_ID, secretAccessKey: process.env.S3_SECRET_ACCESS_KEY, }, }); export async function signUpload(type) { const key = `uploads/${crypto.randomUUID()}`; const url = await getSignedUrl( signer, new PutObjectCommand({ Bucket: process.env.S3_PUBLIC_ENDPOINT, Key: key, ContentType: type, }), { expiresIn: 900 }, ); return { key, url }; } ``` وقعه على `S3_PUBLIC_ENDPOINT`: العنوان داخل المشروع لا يستجيب إلا من داخل شبكة المشروع، فلا يستطيع المتصفح استخدام رابط موقع عليه. ومع تشغيل `bucketEndpoint`، يأخذ `Bucket` هذا العنوان بدلا من اسم المخزن. اضبط `requestChecksumCalculation` على `WHEN_REQUIRED`: فالـ SDK يوقع checksum في كل طلب من تلقاء نفسه، وهذا يفسد الرفع الموقع. 2. في الصفحة، اطلب رابطا من خادمك وارفع الملف عليه: ```js const { url } = await fetch("/upload-link", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ type: file.type }), }).then((response) => response.json()); await fetch(url, { method: "PUT", body: file, headers: { "Content-Type": file.type }, }); ``` `/upload-link` مثال على route في خادمك يستدعي `signUpload`. يبقى السر على خادمك. يعمل الرابط للمدة التي وقعته لها، وهي هنا 15 دقيقة. ## حدد المصادر يقبل المخزن طلبات المتصفح من أي موقع حتى تكتب المصادر المسموحة له. القائمة الفارغة تعني كل المصادر: فالتوقيع هو الذي يحكم الكتابة، لا القائمة. لكي تكتبها، افتح المخزن، واضغط `⌘K` واختر **تعديل المصادر المسموحة**. اكتب مصدرا واحدا في كل سطر، الـ scheme والـ host فقط، مثل `https://example.com`. تتسع القائمة لـ 50 مصدرا كحد أقصى. بعد ذلك يرفض المخزن طلبات المتصفح من أي مصدر آخر. لا يملأ غيم القائمة أبدا من عناوين مشروعك: فالمخزن لا يتبع أي مشروع. Source: https://ghaym.me/docs/bucket-files.md # ارفع ونزل ملفات المخزن ارفع ملفات المخزن ونزلها واحذفها من الـ console، وانسخ روابطها، واعرف أي الملفات أصبحت باردة. ## ارفع الملفات 1. افتح [المخزن](/ar/docs/object-storage) من **المخازن**. **الكائنات** تعرض المجلد الذي أنت فيه؛ افتح أي مجلد لتدخله. 2. اختر **رفع ملفات**، أو اسحب ملفات أو مجلدا وأفلتها على القائمة. ومن `⌘K`، **ارفع ملفات هنا** و**ارفع مجلدا هنا** يرفعان إلى المجلد الذي أمامك. أكبر حجم لكل ملف 5 GiB. 3. إذا كان هناك ملف بالاسم نفسه أصلا، فاختر **استبدل** أو **تخط** لكل ملف. الاستبدال يحذف القديم نهائيا. ولا يمكن استرجاعه. ومن [الـ CLI](/ar/docs/cli-buckets)، `ghaym cloud buckets upload ` يرفع ملفا واحدا، و `ghaym cloud buckets objects list ` يعرض الملفات. العضو الذي دوره **مشاهد** لا يستطيع الرفع: اطلب من **المالك** أو **مشرف** [دور](/ar/docs/workspaces-and-roles) **مطور**. المخزن الممتلئ لا يقبل شيئا حتى تحذف ملفات أو تزيد التخزين في خطتك. وفي المخزن العام، يستطيع أي شخص معه الرابط أن يقرأ ما رفعته. ## ابحث عن ملف ونزله اكتب في **أسماء تبدأ بـ** لكي تفلتر المجلد؛ الأسماء تفرق بين الحروف الكبيرة والصغيرة. يبقى المجلد موجودا فقط ما دامت فيه ملفات. افتح قائمة الملف واختر **فتح** أو **تنزيل** أو **نسخ الرابط**. الرابط المنسوخ لملف خاص يعمل لمدة ساعة؛ والرابط لملف في مخزن عام يعمل لأي شخص. الملف الذي عليه **بارد** لم يقرأ منذ 30 يوما أو أكثر، ويحسب بسعر البارد حتى أول قراءة. فتحه أو تنزيله يعيده إلى سعر الساخن. ## احذف الملفات افتح قائمة الملف واختر **حذف**. لكي تحذف مجلدا وكل ما فيه، اضغط `⌘K` وأنت داخله واختر **احذف هذا المجلد**، ثم اكتب اسم المجلد للتأكيد. يعد الـ console الملفات أولا، ويعرض العدد أثناء الحذف. وإذا توقف حذف المجلد في المنتصف، فإن **احذف الباقي** يكمله. > [!UNAVAILABLE] > نسخ الملفات القديمة: لا يمكن التراجع عن الحذف. **النشاط** في صفحة المخزن يعرض الرفع والحذف الذي قام به الأعضاء من هذه الصفحة، لا ما يكتبه تطبيقك. Source: https://ghaym.me/docs/logs.md # اقرأ سجل الخدمة تابع سجل البناء وسجل التشغيل مباشرة، وابحث فيهما وفلترهما ونزلهما. ## تابع السجل 1. افتح الخدمة في الـ console، واضغط `⌘K` واختر **انتقال › السجل**. السجل مباشر، وفيه سطور كل النسخ فور وصولها. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud services logs web ``` 2. اكتب في **ابحث في السطور** لتبحث، واختر **المستوى** لتفلتر: **خطأ** أو **تحذير** أو **معلومة** أو **تتبع**. وما دام السجل مباشرا، يصل البحث إلى آخر ساعة. 3. اختر **إيقاف مؤقت** لتثبت السطور مكانها، و**متابعة** لتعود إلى المتابعة. إذا لم تكن الخدمة تعمل (نائمة، أو متوقفة، أو لم تنشر بعد)، يخرج الـ CLI. أضف `-f` لكي ينتظر بدلا من ذلك: عندما يوقظ طلب خدمة نائمة، تظهر أسطرها الأولى. ## اقرأ فترة سابقة اختر **الفترة**: **15 دقيقة** أو **ساعة** أو **24 ساعة** أو **7 أيام** أو **فترة أخرى**. المدة التي تستطيع العودة إليها تعتمد على خطتك: يخبرك السجل كم ساعة تحفظ خطتك. ## اقرأ سجل بناء نشرة اضغط `⌘K`، واختر **انتقال › كل النشرات** وافتح نشرة. في **السجل** الخاص بها ثلاث مراحل: **البناء** و**التشغيل** و**مخرجات التطبيق**. يفتح على المرحلة التي فشلت، فـ [البناء](/ar/docs/builds) الفاشل يعرض أول سطر أحمر فيه. **نسخ السجل** ينسخ المراحل الثلاث عندما تنتهي النشرة. والـ CLI يبث سجل البناء والتشغيل لنشرة برقمها: ```sh ghaym cloud deployments list --service web ghaym cloud deployments logs -f ``` ## نزل السجل اختر **تنزيل** من رأس السجل، أو اضغط `⌘K` واختر **انتقال › تنزيل السجل**. ينزل ما يعرضه السجل، مع الفلاتر التي اخترتها. Source: https://ghaym.me/docs/traffic-and-metrics.md # اعرض زيارات الخدمة واستهلاكها اعرف من يزور الخدمة ومن أين، وأي مسارات وردود يحصلون عليها، وأي AI crawlers زاروها، وكم تستهلك من CPU وذاكرة. ## اعرض زياراتها 1. افتح [الخدمة](/ar/docs/projects-and-services) في الـ console واختر تبويب **الزيارات**. 2. اختر **الفترة**: **ساعة** أو **24 ساعة** أو **7 أيام** أو **30 يوم**. تعرض المربعات **زيارات** و**ناجحة** و**أخطاء الخادم**، وكل منها مقابل الفترة السابقة. 3. تابع إلى الأسفل في التبويب: **الزوار** يضع الزيارات على خريطة حسب الدولة، و**المسارات** يعرض المسارات التي طلبوها، و**الاستجابات** يقسم الردود التي وصلتهم إلى ناجح، وتحويل، وخطأ من العميل، وخطأ من الخادم. الأرقام تعد أشخاصا: الـ console يزيل الزيارات الآلية والـ scanners. غيم لا يخزن أبدا عنوان IP للزائر؛ تعرف الدولة من المكان الذي وصل إليه الطلب. ## اعرف أي crawlers للذكاء الاصطناعي زارت الخدمة **الذكاء الاصطناعي** في التبويب نفسه يعد طلبات الـ crawlers الخاصة بكل شركة ذكاء اصطناعي في الفترة، الأكثر أولا، والتي لا يعرف اسمها تظهر تحت **أخرى**. ## اعرض استهلاك مواردها اختر تبويب **نظرة عامة**. **استهلاك الموارد** يرسم **الذاكرة** و**المعالج** على الفترة التي تختارها، وتحت الرسم **ذروة الذاكرة** و**ذروة المعالج** و**الشبكة الصادرة**، وكم قضت الخدمة وهي نائمة، تحت **نائم**. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud services metrics web ``` Source: https://ghaym.me/docs/activity.md # اعرف من أجرى كل تغيير اقرأ نشاط المشروع: كل نشر وكل تغيير، ومن أجراه، وهل كان شخصا أو agent أو غيم. ## اقرأ النشاط 1. افتح المشروع في الـ console، واضغط `⌘K` واختر **المشروع › نشاط المشروع**. تظهر هنا كل نشرة وكل تغيير في المتغيرات أو الحجم أو النطاقات، مع من أجراه: **أنت**، أو **عضو**، أو **عضو سابق**، أو agent، أو **غيم**. والتغيير الذي أجري من الـ CLI يظهر بجانبه **(CLI)**. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud audit list --project shop ``` 2. لكي تضيقه، اختر نوعا: **الكل** أو **النشرات** أو **المتغيرات** أو **الحجم** أو **النطاقات** أو **الوصول** أو **الوكلاء**. وتحت **من قام بالتغيير**، اختر **أي جهة** أو **أنت** أو **وكيل** أو **غيم**. ويصفي الـ CLI حسب `human` أو `agent`، وحسب الوقت: ```sh ghaym cloud audit list --project shop --actor agent --from 2026-10-01T00:00:00Z ``` ## كم يوما يحفظ النشاط تحدد خطتك عدد أيام النشاط التي يحفظها غيم، والصفحة تخبرك: خطة Team تحفظ سنة. يستطيع أي عضو في [مساحة العمل](/ar/docs/workspaces-and-roles) أن يقرأه، مهما كان دوره. على خطة Solo، يعرض النشاط ما فعله الوكلاء فقط، ولا يقدم **من قام بالتغيير** إلا **وكيل**. السجل الكامل، مع ما فعله الأشخاص وغيم، يأتي مع خطة Team. ويسجل غيم كل تغيير على كل خطة، فبعد الانتقال إلى Team تظهر التغييرات السابقة أيضا. للمخزن **النشاط** الخاص به: يظهر فيه الرفع والحذف الذي يجري من صفحته، ولا تظهر الكتابة التي يجريها تطبيقك. وعلى خطة Solo، يأتي هذا السجل مع خطة Team. Source: https://ghaym.me/docs/email-alerts.md # اختر تنبيهات البريد اختر الأحداث التي نرسل لك عنها بريدا، مثل نشر فشل، أو خدمة توقفت، أو استهلاك بلغ الحد. ## شغل التنبيهات أو أطفئها 1. في الـ console، اضغط `⌘K` واختر **مساحة العمل › تنبيهات الإيميل**. اختر تنبيها لكي تقلبه؛ تبقى القائمة مفتوحة، فتستطيع أن تقلب عدة تنبيهات متتالية. ينتهي كل تنبيه من الثمانية بـ **مفعل** أو **مطفأ**. لا يغيرها إلا مالك مساحة العمل أو المشرف. 2. لكي تقرأ ما يغطيه كل تنبيه، اختر **مساحة العمل › فتح إعدادات التنبيهات**. تحت **ما الذي نرسله**، يضم تبويب **التنبيهات**: - **فشل النشر**: عندما يفشل بناء أو نشر. رسالة واحدة لكل محاولة. - **نجاح النشر**: عندما يبدأ نشر جديد بالعمل. - **توقف خدمة**: عندما تتوقف خدمة عن الرد أكثر من خمس دقائق، ومرة أخرى عندما تعود. - **تعذر النسخ الاحتياطي**: عندما لا تكتمل النسخة الليلية لقاعدة بيانات. القاعدة النائمة ليست فشلا ولا رسالة لها. - **تعذر الاسترجاع**: عندما لا يكتمل استرجاع طلبته. لا تتغير قاعدتك الأصلية. - **80% من حد الاستهلاك**: عندما يبلغ استهلاك الشهر 80% من الحد الذي وضعته. - **بلوغ حد الاستهلاك**: عندما يبلغ الحد وتتوقف خدماتك. - **صدور الفاتورة**: عندما يغلق الشهر وتصدر فاتورته. تبدأ كل التنبيهات مفعلة إلا **نجاح النشر**. ما تطفئه يبقى ظاهرا في الـ console، ويخبرك كل سطر بآخر مرة أرسل فيها. لا يصل تنبيها حد الاستهلاك إلى أحد حتى [تضع حد استهلاك](/ar/docs/spending-limits). ## من يصله البريد يذهب البريد إلى مالك مساحة العمل والمشرفين، عشرة منهم كحد أقصى. يعرض **من يصله البريد** كل عنوان مع دوره واللغة التي تكتب بها نسخته: كل شخص يقرأ التنبيه بلغة حسابه. ## جرب الإرسال اضغط `⌘K` واختر **مساحة العمل › أرسل تنبيها تجريبيا**، أو اختر **أرسل رسالة تجريبية** في تبويب **التنبيهات**. تصل الرسالة إلى بريدك وحدك. وانتظر دقيقة قبل أن ترسل رسالة أخرى. Source: https://ghaym.me/docs/data-residency.md # تحقق من مكان بياناتك تعرض صفحة مكان البيانات كل خدمة وقاعدة بيانات ومخزن في بيئة، مع موقعه ودولته. يظهر المخزن إذا كان مربوطا بخدمة في تلك البيئة. ## اقرأ القائمة 1. افتح المشروع، واضغط `⌘K` واختر **المشروع › مكان البيانات**. تغطي القائمة البيئة التي فتحتها منها، أو بيئة الإنتاج إن فتحتها خارج أي بيئة. 2. القائمة جدول واحد فيه **الاسم** و**النوع** و**الموقع**، ولكل دولة مجموعة فيه. يسمي السطر الأول في كل مجموعة دولتها، وينتهي بـ **تنزيل اتفاقية المعالجة**، وهي اتفاقية معالجة البيانات لتلك الدولة. يعرض كل سطر الموقع الذي يعمل فيه. القائمة للقراءة فقط. يعمل المرجع داخل موقع واحد فقط، والمخزن يربط بخدمة في موقعه وحده. تشرح صفحة [الدول والمواقع](/ar/docs/countries-and-sites) ما هو الموقع. ## الخطط القائمة مفتوحة في كل خطة. ## من الـ CLI في الـ [CLI](/ar/docs/install-the-cli)، يعرض `ghaym cloud residency report` كل مورد مع موقعه ودولته: ```sh ghaym cloud residency report --project shop ``` Source: https://ghaym.me/docs/team.md # أضف فريقك إلى مساحة العمل أنشئ مساحة عمل للفريق، وأرسل دعوات بالبريد الإلكتروني، وأعط كل شخص دورا. ## أنشئ مساحة عمل للفريق 1. افتح قائمة مساحات العمل في أعلى الـ console واختر **مساحة عمل جديدة**. اكتب **اسم مساحة العمل** واختر **إنشاء مساحة العمل**. للمساحة الجديدة مشاريعها وحساب فوترتها وفواتيرها، وتكون أنت مالكها. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud workspaces create --name "Client projects" ghaym cloud workspaces list ``` 2. تتسع خطة Solo حتى 3 أعضاء، مع الدعوات المفتوحة؛ ولأكثر من ذلك انقل المساحة إلى خطة Team، كما تشرح [غير خطتك](/ar/docs/plans). كل مساحة عمل تقبل أعضاء، ومنها المساحة الأولى. ولتعمل في مساحة الفريق من الـ CLI، أضف `--workspace` مع رقمها من `ghaym cloud workspaces list`. ## ادع الأشخاص 1. في مساحة الفريق، اضغط `⌘K` واختر **مساحة العمل › ادع عضو**. لا يراها إلا المالك والمشرفون. 2. اكتب البريد الإلكتروني للشخص، ثم اختر دورا: **مشرف** لكل شيء عدا الملكية، أو **مطور** للمشاريع والنشر والمتغيرات، أو **مشاهد** للقراءة فقط، دون قيم المتغيرات. [مساحات العمل والأدوار](/ar/docs/workspaces-and-roles) تشرح كل دور. 3. يرسل غيم الدعوة بالبريد الإلكتروني، ويبقى الرابط صالحا 7 أيام. ليقبلها، يدخل الشخص بحساب غيم على البريد نفسه ويختار **اقبل الدعوة**. الدعوات التي لم تقبل بعد تنتظر في **الإعدادات**، في تبويب **الأعضاء**، تحت **دعوات لم تقبل**، وكل منها إما **بانتظار القبول** أو **انتهت**. ومن قائمة إجراءات الدعوة، **أرسلها مرة ثانية** ترسل رابطا جديدا و**ألغ الدعوة** تسحبها. ## غير دورا أو أزل شخصا افتح **الإعدادات** وتبويب **الأعضاء**. يستطيع كل الأعضاء قراءة القائمة. ويفتح المالك أو المشرف قائمة إجراءات العضو ليختار **غير الدور** أو **أزله من المساحة**. دور المالك لا يتغير. ليسلم المساحة لشخص آخر، يختار المالك **انقل الملكية** على ذلك العضو، ويصبح هو مشرفا. ويستطيع أي شخص غيره أن يختار **اترك المساحة** على سطره؛ وللمساحة دائما مالك. Source: https://ghaym.me/docs/spending-limits.md # تابع إنفاقك وضع له حدا اعرف كم أنفقت هذا الشهر، وضع سقفا لميزانية المشروع، وضع حدا للاستهلاك يوقف الخدمات قبل أن تكبر الفاتورة. ## اعرف كم صرفت افتح **الفوترة** في الـ console. يعرض **الملخص** كم كلف هذا الشهر **حتى الآن**، مع رسوم الخطة، وكم هو **متوقع للشهر** حتى آخره، واليوم الذي تصدر فيه فاتورته. اختر **الاستهلاك**، أو اضغط `⌘K` واختر **مساحة العمل › الاستهلاك**، لترى الشهر مفصلا حسب المشروع والبيئة والخدمة. ويعرض كل سطر كم كلف **حتى الآن** وكم هو **متوقع** حتى آخر الشهر. وللشهر الماضي تبويب خاص به، فيه رابط إلى فاتورته بعد أن تصدر. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud billing spend shop ghaym cloud usage ``` الأول يعرض كم أنفق مشروع واحد هذا الشهر، والثاني يعرض استهلاك مساحة العمل المحسوب وتكلفته. طريقة حساب سعر كل سطر موجودة في [الفوترة](/ar/docs/billing). ## ضع سقفا لميزانية المشروع يوضع سقف الميزانية من الـ CLI، بعملة مساحة عملك: ```sh ghaym cloud projects update shop --budget-cap 50 ``` يرفض غيم إضافة خدمة جديدة إذا كان مصروف هذا الشهر حتى الآن، مع السعر الشهري للخدمة، سيتجاوز السقف. والخدمة التي تحسب على الاستهلاك فقط، وليس لها سعر شهري ثابت، لا تفحص مقابله. والخدمات التي تعمل أصلا لا يوقفها السقف أبدا. وفي **الاستهلاك**، يعرض سطر المشروع سقفه. لتضع سقفا وأنت تنشئ المشروع، أضف `--budget-cap` إلى `ghaym cloud projects create`. ولتزيله، أعط `--budget-cap none`. ## ضع حدا للاستهلاك حد الاستهلاك يغطي مساحة العمل كلها، ولا يستطيع تغييره إلا المالك والمشرفون. 1. من **الفوترة**، اختر **ضبط حد**، أو **تغيير الحد** إن كان هناك حد، أو اضغط `⌘K` واختر **مساحة العمل › تعديل حد الاستهلاك**. 2. اكتب مبلغا بعملة مساحة عملك، حتى ثلاث خانات عشرية بالدينار أو خانتين بالريال، واختر **حفظ**. - إذا كان أقل مما استهلكه هذا الشهر، يصير الزر **حفظ وإيقاف الخدمات**، والحفظ يوقف خدماتك الآن. 3. لتزيل الحد، امسح الحقل واختر **إزالة الحد**. عندما يصل الاستهلاك إلى الحد، تتوقف خدماتك حتى ترفعه أو يبدأ الشهر التالي. ولا يحذف شيء. تعرض **الفوترة** أنك بلغت الحد وأن الخدمات متوقفة. اختر **رفع الحد**، وتعود الخدمات خلال دقيقة. [وتنبيهات الإيميل](/ar/docs/email-alerts) تنبه المالك والمشرفين عندما يصل الاستهلاك إلى 80% من الحد، ومرة أخرى عندما يصل إليه. Source: https://ghaym.me/docs/plans.md # غير خطتك انتقل بين خطة Solo وخطة Team، واعرف ما تسمح به كل واحدة. ## غير الخطة 1. افتح **الفوترة** واختر **تغيير الخطة**. لا يستطيع تغيير الخطة إلا المالك والمشرفون. 2. اختر خطة. تعرض كل بطاقة رسومها الشهرية بعملة مساحة عملك، وتحدد **خطتك الحالية** الخطة التي أنت عليها. في خطة Solo **حتى 3 أعضاء** و**الاستهلاك بسعره** و**حد إنفاق تضبطه بنفسك**. وفي خطة Team **أعضاء بلا حد** و**يشمل 99.000 د.أ استهلاكا كل شهر** و**حد إنفاق تضبطه بنفسك**. والخطة التي تشمل استهلاكا تخبرك بمقداره كل شهر. [الحدود والأسعار](/ar/docs/limits-and-prices) تقارن الخطط سطرا بسطر. 3. اختر **تأكيد التغيير**. يحدث التغيير الآن: تضاف الرسوم الجديدة إلى فاتورة هذا الشهر، وتحسب رسوم الخطة كاملة لكل شهر. ثم يعيدك الـ console إلى **الفوترة**، ويعرض سطر **الخطة** خطتك الجديدة. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud billing plans ghaym cloud billing set-plan --plan team ghaym cloud billing account ``` `billing plans` يعرض الخطط وحدودها، و`set-plan` يأخذ مفتاح خطة من هذه القائمة، و`billing account` يعرض الخطة التي أنت عليها. طريقة جمع الرسوم والاستهلاك موجودة في [الفوترة](/ar/docs/billing). ## عند رفض التغيير - لا تستطيع تغيير الخطة والحساب مغلق. Source: https://ghaym.me/docs/create-an-api-key.md # أنشئ مفتاح API أنشئ مفتاحا بصلاحيات محددة لسكربت أو CI أو agent، ودوره أو ألغه متى شئت. ## أنشئ مفتاحا 1. افتح [مفاتيح الـAPI](https://auth.ghaym.me/account/api-keys) في حسابك واختر **إنشاء مفتاح**. 2. **أكد أنك أنت**: اكتب **كلمة المرور الحالية** واختر **تأكيد**. - إذا كنت تدخل برابط وليس لديك كلمة مرور، اختر **أرسل لي رابط تأكيد** وافتحه في المتصفح نفسه. إنشاء المفتاح وتدويره وإبطاله كلها تطلب هذا التأكيد، ولا يستطيع أي مفتاح تجاوزه. 3. اكتب **اسم المفتاح** يذكرك أين يعمل، حتى 80 حرفا. 4. تحت **ما الذي يصل إليه**، اختر ما يستطيع المفتاح فعله: - **قراءة فقط**: كل ما يستطيع حسابك قراءته أو عرضه، ولا شيء مما يغير. - **غيم كلاود فقط**: كل الأفعال على موارد غيم كلاود، ولا شيء خارجها. - **وصول كامل**: كل ما يستطيع حسابك فعله. - **تحديد يدوي**: صلاحية في كل سطر، بصيغة `app:resource:action`، ويمكن أن يكون أي جزء منها `*`. [مفاتيح الـ API والصلاحيات](/ar/docs/api-keys) تشرحها. 5. تحت **مدة الصلاحية**، اختر **بلا انتهاء** أو **30 يوما** أو **90 يوما** أو **سنة**، واختر **أنشئ المفتاح**. 6. هذه المرة الوحيدة التي تظهر فيها القيمة السرية: يحتفظ غيم ببصمتها فقط. اختر **انسخ القيمة السرية**، وضعها حيث يعمل المفتاح، ثم اختر **حفظتها**. تبدأ القيمة السرية بـ `ghk_`. لكي تستخدم المفتاح من التيرمينال أو CI أو agent، [ادخل به عبر الـ CLI](/ar/docs/install-the-cli). ## دور المفتاح أو ابطله كل مفتاح في الصفحة يعرض **أنشئ** و**آخر استخدام** و**ينتهي في**. يبقى المفتاح المبطل أو المنتهي في القائمة، وعليه **مبطل** أو **منته**. - **تدوير** يعطي المفتاح قيمة سرية جديدة، ويبقي اسمه وصلاحياته ومدته كما هي. تبقى القيمة القديمة صالحة لفترة قصيرة، وتخبرك الصفحة حتى متى، لكي تضع الجديدة مكانها قبل ذلك. - **إبطال** يوقف المفتاح فورا: أي شيء ما زال يحمل القيمة السرية يفشل من هذه اللحظة. أبطل المفتاح فور أن تشك في أنه تسرب. Source: https://ghaym.me/docs/agent-approvals.md # راقب عمل الـ agent اختر أي أفعال للـ agent تنتظر موافقة شخص، ووافق عليها أو ارفضها، وتراجع عما فعلته جلسة الـ agent. ## اختر ما ينتظر موافقة شخص لكل مشروع سياسة موافقة. وهي تحدد أي طلبات من [الـ coding agent](/ar/docs/agents) تنتظر شخصا قبل أن تنفذ: - `standard`، وهي الأساسية: ينتظر حذف مشروع أو بيئة أو خدمة أو نطاق خاص، وكذلك تطبيق تغييرات مجهزة تحذف متغيرا أو خدمة أو نسخة قاعدة. - `strict`، على خطة Team: ينتظر هذا الحذف، وأيضا إطلاق خدمة لها سعر شهري. - `sandbox`: لا ينتظر شيء. وعلى خطة Solo، يرفض ضبط `strict`. والمشروع الذي يحمل `strict` من قبل يعمل هناك كـ `standard`، ويبقى `strict` محفوظا لحين عودة المساحة إلى Team. وخفض السياسة متاح على كل خطة. الطلب الذي تقدمه أنت لا ينتظر أبدا. يعد غيم الطلب صادرا من agent عندما يعمل الـ CLI داخل Claude Code أو Cursor، أو عندما يسمي `GHAYM_AGENT` الـ agent. اضبط سياسة المشروع بأمر واحد. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud projects update shop --approval-policy strict ``` ## رد على طلب 1. الطلب المنتظر لا ينفذ. ينتهي أمر الـ agent بالرمز `6` ومعه رقم الموافقة، ويشغل الـ agent الأمر `ghaym cloud approvals wait `، الذي يعود عندما يحسم الطلب. وفي أثناء الانتظار، لا يتغير شيء. 2. في الـ console، افتح المشروع. افتح [النشاط](/ar/docs/activity): يظهر كل طلب أعلى القائمة، ويسمي الـ agent، ويذكر ما سيحدث، مثلا «حذف البيئة يوقف كل خدمة تعمل فيها ويزيلها.» الطلب الذي يخص المشروع كله يحمل **كل المشروع**، والباقي يخص البيئة التي تقرأ نشاطها. يعرض زر **النشاط** فيه عدد الطلبات التي تنتظرك. 3. اختر **اعتمد الطلب** لكي ينفذ، أو **ارفض**. في الحذف أو الإطلاق، يقول الزر **اعتمد الحذف** أو **اعتمد الإطلاق**. الطلب الذي لا يرد عليه أحد يسقط وحده، في الوقت الذي يظهر في البطاقة بعد **تسقط تلقائيا**. لا يرد على الطلب إلا الشخص الذي يملك الـ agent الذي قدمه، ولا يستطيع أي agent أن يرد. من التيرمينال الخاص بك، خارج الـ agent: ```sh ghaym cloud approvals list --status pending ghaym cloud approvals approve ghaym cloud approvals deny ``` لا ينتهي `approvals wait` بالرمز `0` إلا إذا اعتمد الطلب. وينتهي الطلب المرفوض أو الساقط بالرمز `6`، وكذلك الانتظار الذي تنتهي مهلته: 300 ثانية، إلا إذا حدد `--timeout` غيرها. عندها ينتظر الـ agent من جديد بدلا من أن يعيد الطلب. ## تراجع عن جلسة الـ agent كل أمر CLI يشغله الـ agent يفتح جلسة، إلا إذا حمل `GHAYM_SESSION` رقما واحدا للسلسلة كلها. ```sh ghaym cloud sessions list --project shop ghaym cloud sessions get ghaym cloud sessions watch ``` يعرض `sessions list` لكل جلسة الـ agent الخاص بها، وسببها، وأفعالها، وما فشل منها، والطلبات المنتظرة. يعرض `sessions get` أفعال جلسة واحدة وما لمسته، ويتابع `sessions watch` أفعالها أولا بأول. لكي تتراجع عن جلسة، اقرأ الخطة أولا، ثم شغلها: ```sh ghaym cloud sessions rollback --dry-run ghaym cloud sessions rollback ``` يحذف التراجع المشاريع والبيئات والخدمات والنطاقات الخاصة التي أنشأتها الجلسة وما زالت موجودة، من الأحدث إلى الأقدم. ويظهر كل فعل آخر في القائمة مع سبب عدم التراجع عنه: التغيير لم تحفظ قيمته القديمة، والحذف نهائي، والنشرة يتراجع عنها [بالرجوع إلى نشرة سابقة](/ar/docs/rollback). والـ agent الذي يطلب التراجع ينتظر شخصا، إلا إذا كان المشروع `sandbox`. Source: https://ghaym.me/docs/verified-prompts.md # جهز الـ repo للنشر عبر الـ agent أعط الـ agent الخاص بك prompt يجهز repo موجودا للنشر، ويتوقف قبل الـ push. ## قبل أن تبدأ - شغل الـ agent في جذر الـ repo، دون تغييرات غير محفوظة فيه، لكي يكون الـ diff الذي ينتجه من عمله وحده. - الكود على GitHub. ربطه عبر GitHub App الخاص بغيم خطوة تقوم بها أنت، كما تشرح [انشر من GitHub](/ar/docs/deploy-from-github)؛ ولا يستطيع الـ agent إكمالها وحده. - الـ prompts تقرأ ملفات الـ repo وتعدلها فقط. ولا يتصل أي منها بغيم، فلا يحتاج الـ agent إلى مفتاح. - كل prompt يطابق ما توثقه هذه الصفحات، لكنه لم يقس، فلا توجد نسبة نجاح. اقرأ الـ diff قبل الـ push. ## Next.js يتوقع الـ prompt وجود `package.json` في جذر الـ repo. يفحص سكربتات `build` و`start`، ويراجع المتغيرات التي يقرؤها الـ repo وينبهك إلى أي سر خلف `NEXT_PUBLIC_`، ويعدد المتغيرات التي يجب أن تضبطها، مقسمة إلى متغيرات للخادم فقط ومتغيرات عامة. ثم يعرض عليك الـ diff ويتوقف. ``` Prepare this Next.js repository for deployment to Ghaym Cloud (a platform-as-a-service). Context you must respect: - Ghaym builds a container image from this repo. Ghaym auto-detects Node projects from package.json, so no Dockerfile is needed unless this repo has an unusual build. - The app must listen on the port given in the PORT environment variable. `next start` already does this — do not hard-code a port in the start script. - Secrets are set as environment variables in the Ghaym console. Do not commit them and do not invent values. - Any variable prefixed NEXT_PUBLIC_ is inlined into the browser bundle and is public. Never put a secret behind that prefix. - The `ghaym` CLI is the main way to drive Ghaym Cloud (`npm i -g @ghaymjo/cli`): `ghaym cloud projects create --name ` and `ghaym cloud services create --project --type git --repo --size --site ` set the project up — and after that, every deploy is a git push to the production branch, because Ghaym builds what it pulls from the connected repository. Tasks: 1. Check package.json: confirm `build` and `start` scripts exist and that `start` does not hard-code a port. Fix if needed. 2. Audit every environment variable this repo reads. Flag any NEXT_PUBLIC_ variable that looks like a secret. 3. List every environment variable I must set in the Ghaym console, split into server-only and public, with a one-line description each. Do not fill in values. 4. Do not push. Show me the diff and stop. ``` ## Laravel يتوقع الـ prompt وجود `composer.json` في جذر الـ repo. يضيف `Dockerfile` يشغل التطبيق على كل العناوين، على الـ port الذي في `PORT`، و`.dockerignore` يستثني `.env` و`vendor`. يعدد المتغيرات التي يجب أن تضبطها، ثم يعرض عليك الـ diff ويتوقف. ``` Prepare this Laravel repository for deployment to Ghaym Cloud (a platform-as-a-service). Context you must respect: - Ghaym builds a container image from this repo. Most languages are detected on their own; anything else needs a Dockerfile. This repo builds from one, so it needs a Dockerfile. A repository that already has a Dockerfile when its service is added builds from it. - The app must listen on 0.0.0.0 and on the port given in the PORT environment variable. Do not hard-code a port. - Secrets (APP_KEY, database credentials) are set as environment variables in the Ghaym console. Do not commit them, and do not invent values. - The `ghaym` CLI is the main way to drive Ghaym Cloud (`npm i -g @ghaymjo/cli`): `ghaym cloud projects create --name ` and `ghaym cloud services create --project --type git --repo --size --site ` set the project up — and after that, every deploy is a git push to the production branch, because Ghaym builds what it pulls from the connected repository. Tasks: 1. Add a production Dockerfile that installs PHP extensions Laravel needs (including pdo_pgsql), runs `composer install --no-dev`, and starts the app bound to 0.0.0.0:$PORT. 2. Add a .dockerignore that excludes .env, vendor, node_modules, and storage caches. 3. List every environment variable I must set in the Ghaym console, with a one-line description each. Do not fill in values. 4. Do not push. Show me the diff and stop. ``` عندما تقرأ الـ diff، اعمل له push، وأعط [الـ agent](/ar/docs/agents) باقي العمل. Source: https://ghaym.me/docs/projects-and-services.md # المشاريع والبيئات والخدمات في المشروع بيئات، وفي كل بيئة خدمات، والخدمة هي ما تنشره وتدفع عنه. ## المشاريع المشروع هو تطبيق واحد مع الأجزاء التي يحتاجها، مثل موقع وAPI وقاعدة بيانات. عندما تنشئ مشروعا، تنشأ معه بيئة الإنتاج الخاصة به، وهي تنشر من `main` إلا إذا اخترت branch آخر. ## البيئات البيئة هي نسخة من خدمات المشروع. لكل خدمة في المشروع مكان في كل بيئة، ومعها إعداداتها ووصولها ومتغيراتها الخاصة هناك. | البيئة | تنشر من | تنام | | --- | --- | --- | | **الإنتاج** | الـ branch الذي يتابعه المشروع | أبدا | | أي بيئة أخرى، مثل `staging` | الـ branch الخاص بها | بعد 15 دقيقة دون أي طلب | تأخذ البيئة الجديدة نسخة خاصة بها من كل قاعدة بيانات وكل كاش، وتبدأ كل نسخة فارغة: البيئات لا تتشارك البيانات. صفحة [انشر branch في بيئة مستقلة](/ar/docs/branch-environments) تريك كيف تنشئ واحدة، وصفحة [النوم](/ar/docs/sleep) تشرح لماذا ترتاح البيئات الأخرى. ## الخدمات الخدمة هي برنامج واحد يعمل. تعمل في [موقع](/ar/docs/countries-and-sites) واحد داخل البيئة، تختاره عند إنشائها، ولا يتغير. ولها ثلاثة أنواع: | النوع | تضاف من | ما هي | | --- | --- | --- | | خدمة ويب | **مستودع GitHub** | كودك، مثل موقع أو API، ويرد على HTTP على الـ port الخاص به. غيم [يبنيها](/ar/docs/builds) من الـ repo الخاص بك. | | قاعدة بيانات | **PostgreSQL** أو **MySQL** | قاعدة بيانات يشغلها غيم عنك داخل المشروع. | | كاش | **Redis** | كاش يشغله غيم عنك داخل المشروع. | تنشر خدمات الويب من Git repo، وتعيش قواعد البيانات والكاش داخل الشبكة الخاصة بالمشروع. ترد خدمة الويب على رابط ينتهي بـ `ghaym.app`، [ونطاقك](/ar/docs/custom-domains) يستطيع أن يشير إليها أيضا. ## الحجم والنسخ يحدد حجم الخدمة الذاكرة والـ CPU وسعرها الشهري، ويعرض لك الـ console السعر قبل أن تختار الحجم. تستطيع خدمة الويب أن تعمل بعدة نسخ. أما قاعدة البيانات والكاش فيكبران بالقراء بدلا من ذلك، ولا يتغير حجم أي منهما إلا إلى حجم له القرص نفسه. ولكل بيئة حجمها. صفحة [كبر الخدمة أو صغرها](/ar/docs/scaling) تريك الأمرين، وصفحة [الفاتورة](/ar/docs/billing) تريك كيف يجمع السعر. ## من الـ CLI اعرض مشاريعك، ثم بيئات مشروع واحد، عبر الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud projects list ghaym cloud environments list shop ``` ينشئ أمر `environments create` بيئة تنشر من الـ branch الخاص بها، ويعرض أمر `services metrics` الـ CPU والذاكرة والطلبات لخدمة واحدة. Source: https://ghaym.me/docs/builds.md # البناء والنشر يتحول الـ push إلى خدمة تعمل على خطوات: يبني غيم image، ويشغلها على الـ port الخاص بك، ويتأكد من أنها تستجيب، ثم يحول الطلبات إليها. ## الخطوات تمر كل نشرة لـ [خدمة](/ar/docs/projects-and-services) بأربع خطوات، وتعرض النشرة الخطوة التي هي فيها: | الخطوة | في الـ console | ما يحدث | | --- | --- | --- | | البناء | **قيد البناء** | يبني غيم image من الـ repo الخاص بك. | | التشغيل | **قيد النشر** | تعمل الـ image الجديدة على كل نسخة، واحدة تلو الأخرى، وتبقى النسخ القديمة تخدم حتى تستبدل كل واحدة. | | الفحص | **فحص الجاهزية** | يسأل غيم التطبيق على مسار فحص الجاهزية حتى يستجيب. | | تعمل | **يعمل** | تأخذ النشرة الجديدة الطلبات، ويصبح مكتوبا على السابقة **استبدلت**. | [سجلات](/ar/docs/logs) النشرة تتابع كل خطوة سطرا بسطر. ## كيف تبنى الصورة أغلب اللغات تبنى دون `Dockerfile`: يكتشف غيم اللغة والـ framework وحده. وما عدا ذلك يبنى بـ `Dockerfile`. والـ repo الذي يحتوي على `Dockerfile` عند إضافة الخدمة يستخدم هذه الأداة من البداية. **أمر البناء** و**أمر التشغيل** في [إعدادات البناء](/ar/docs/build-settings) يحلان محل ما يكتشفه غيم وحده. ## المنفذ والفحص يشغل غيم التطبيق وقيمة `PORT` فيه هي **منفذ التطبيق**، وهو 3000 إذا لم تغيره. يستمع التطبيق على هذا الـ port على كل العناوين. ثم يفحص غيم **مسار فحص الجاهزية**: | مسار فحص الجاهزية | ينجح عندما يرد التطبيق بـ | | --- | --- | | فارغ، فيفحص غيم `/` | أي status أقل من 500 | | مسار وضعته أنت، مثل `/health` | status من 2xx أو 3xx | يستمر غيم في السؤال حتى 30 ثانية. أما الخدمة التي ليس لها عنوان عام فتفحص داخل شبكة المشروع بدلا من ذلك. ## عندما يفشل النشر البناء الذي يفشل يصبح مكتوبا عليه **فشل البناء**، والتشغيل أو الفحص الذي يفشل يصبح مكتوبا عليه **فشل النشر**. النشرة التي تفشل لا تلمس النشرة التي تعمل، فتبقى السابقة تخدم. وسجلها يخبرك بما تعطل. ولكي تعود إلى نشرة قديمة، [ارجع لها](/ar/docs/rollback): يعيد غيم تشغيل الـ image الخاصة بتلك النشرة دون بناء. ## ما الذي يبدأ النشر - الـ push على الـ branch الذي تتابعه الخدمة يبنيها وينشرها، في كل بيئة تتابع هذا الـ branch. - تطبيق [تغيير مجهز](/ar/docs/staged-changes) على متغير أو على ربط مخزن أو على الـ branch أو على إعداد بناء ينشر كل موقع يغيره. - الحجم والنسخ والتوزيع والقراء والوصول تطبق دون نشر. لكي تنشر من جديد يدويا، أو تعرض نشرات خدمة، عبر الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud services redeploy web ghaym cloud deployments list --service web ``` Source: https://ghaym.me/docs/staged-changes.md # التغييرات المجهزة التغييرات على إعدادات الخدمة ومتغيراتها وبيئتها تنتظر حتى تطبقها، لكي تنزل كلها معا كتغيير واحد. ## ما الذي ينتظر لكل [بيئة](/ar/docs/projects-and-services) قائمة واحدة من التغييرات المجهزة. التغيير الذي تجهزه يضاف إلى هذه القائمة ولا يغير شيئا بعد. وعندما تطبق القائمة، تطبق كل التغييرات التي فيها معا. | التغيير | ينتظر حتى تطبقه | تطبيقه يبدأ نشرا | | --- | --- | --- | | متغير | نعم | نعم | | الـ branch أو إعداد بناء | نعم | نعم | | الحجم والنسخ والتوزيع | نعم | لا | | قراء قاعدة البيانات | نعم | لا | | ربط مخزن | نعم | نعم | | الوصول | نعم | لا | | حذف خدمة | نعم | لا | تطبيق تغيير على متغير أو على ربط مخزن أو على الـ branch أو على إعداد بناء يبدأ نشرا لكل خدمة ويب يغيرها. والباقي يسري بمجرد تطبيقه. مفتاح [النسخ الاحتياطية](/ar/docs/database-backups) الليلية لقاعدة البيانات يطبق فورا. وإضافة خدمة أو قاعدة بيانات تعمل فورا أيضا. ## التطبيق أو التجاهل اضغط `⌘K` واختر **مراجعة التغييرات**. اضغط `⌘↵`، أو اختر **تطبيق التغييرات**. ولكي تزيل بعضها، حددها واختر **تجاهل المحدد**. صفحة [راجع التغييرات وطبقها](/ar/docs/apply-changes) ترشدك فيها خطوة بخطوة. في الـ [CLI](/ar/docs/install-the-cli)، اعرض قائمة بيئة واحدة أو طبقها أو تجاهلها: ```sh ghaym cloud changes show --project shop ghaym cloud changes apply --project shop --env staging ghaym cloud changes discard --project shop ``` الأمر الذي يجهز تغييرا، مثل `services scale` أو `access set` أو `vars set`، يأخذ `--apply` لكي يطبقه في المرة نفسها. ## الإنتاج والبيئات الأخرى تنسخ البيئة الجديدة إعدادات الإنتاج [والوصول](/ar/docs/access) مرة واحدة، عند إنشائها. وبعد ذلك تحتفظ كل بيئة بإعداداتها، ولا يصل التغيير المجهز في بيئة إلى غيرها. Source: https://ghaym.me/docs/sleep.md # النوم والاستيقاظ تنام الخدمات خارج الإنتاج عندما لا يستخدمها أحد، ولا تكلف شيئا وهي نائمة، وتستيقظ مع أول طلب. ## متى تنام الخدمة تنام خدمة الويب خارج الإنتاج بعد 15 دقيقة دون أي طلب. الإنتاج لا ينام أبدا. والخدمة النائمة يكتب عليها **نائم** في الـ console. وتنام معها باقي خدمات [البيئة](/ar/docs/projects-and-services): | الخدمة | تنام | تستيقظ | | --- | --- | --- | | خدمة ويب لها عنوان عام | بعد 15 دقيقة دون أي طلب | مع أول طلب يصلها | | قاعدة بيانات | عندما تنام كل خدمات الويب التي لها عنوان عام بجانبها | عندما تستيقظ إحداها | | خدمة ويب ليس لها عنوان عام | مثل قاعدة البيانات | مثل قاعدة البيانات | ## الاستيقاظ أول طلب يوقظ الخدمة، ويخدم فور تشغيلها. عندما تستيقظ خدمة ويب، تستيقظ قبلها كل قاعدة بيانات نائمة بجانبها، فلا يعود التطبيق أبدا إلى اتصال ميت. والنشر أيضا يوقظ الخدمة. النوم يوقف الخدمة دون أن يزيلها، فالاستيقاظ لا يحتاج إلى نشر جديد. وإذا لم يكن في خطتك مجال لموارد مستيقظة أكثر، يرفض الاستيقاظ وتبقى الخدمة نائمة، ويكتب الـ console **نائم — محجوب بحدود الخطة**. ## إيقاظ قاعدة البيانات الـ tunnel إلى قاعدة بيانات نائمة يتوقف بخطأ. أضف `--wake` لكي يوقظها ويتصل، عبر الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud connect db --env staging --wake ``` وما دام الـ tunnel مفتوحا، تبقى القاعدة مستيقظة. صفحة [اتصل بقاعدة البيانات من جهازك](/ar/docs/database-tunnels) تشرح الباقي. ولكي تتابع سجلات خدمة وهي تنام وتستيقظ، يبقي الأمر `services logs` مع `-f` البث مفتوحا والخدمة نائمة. ## كم يكلف النوم تحسب موارد الخدمة فقط على الدقائق التي كانت مستيقظة فيها، فلا تحسب على الخدمة النائمة أي موارد. ويبقى الـ volume مخزنا سواء كانت الخدمة مستيقظة أو نائمة، ويحسب في الحالتين. صفحة [الفاتورة](/ar/docs/billing) تريك كيف تجمع دقائق الاستيقاظ. Source: https://ghaym.me/docs/access.md # الوصول الخدمة إما عامة، وإما مقيدة بأعضاء أو بعناوين محددة، وإما خاصة بمشروعها، ولكل بيئة إعدادها. ## ثلاثة مستويات لكل [خدمة](/ar/docs/projects-and-services) ويب مستوى وصول واحد في كل بيئة. يعرضه الـ console بجانب **الوصول** في **الإعدادات**. | المستوى | في الـ console | في الـ CLI | | --- | --- | --- | | **عامة** | **الكل** | `--reach public` | | **مقيد** | **أعضاء المشروع فقط**، أو **تفتح من عناوين IP محددة فقط** | `--members-only`، `access ips add` | | **خاصة** | **خدمات المشروع فقط** | `--reach private` | تطلب الخدمة المقيدة من كل زائر أن يسجل الدخول بغيم أولا، أو لا تفتح إلا من العناوين التي في قائمتها، وحتى 50 عنوانا. والخدمة الخاصة ليس لها عنوان عام: لا تصل إليها إلا الخدمات التي في المشروع نفسه والبيئة نفسها. لكي تغيره، اتبع [اجعل الخدمة خاصة](/ar/docs/private-services) أو [حدد من يمكنه فتح الخدمة](/ar/docs/restricted-access). ## العناوين مع `--reach custom-domain`، لا تجيب الخدمة إلا على [نطاقاتك](/ar/docs/custom-domains)، ويغلق عنوان ghaym.app. ولكل خدمة ويب أيضا عنوان داخلي: اسمها والـ port، مثل `api:3000`. تستعمله باقي خدمات المشروع. الخدمة الخاصة ليس لها غيره. ## البيئات تبدأ البيئة الجديدة بإعداد وصول الإنتاج، ينسخ مرة واحدة عند إنشائها. وبعد ذلك تحتفظ كل بيئة بإعدادها، ولا يصل التغيير في بيئة إلى غيرها. ولكي تغير إعداد staging عبر الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud access set api --env staging --members-only ``` > [!NOTE] > ليس لقاعدة البيانات إعداد وصول. الإعداد لخدمات الويب فقط. ## التغيير ينتظر مستوى الوصول الجديد [تغيير مجهز](/ar/docs/staged-changes). لا يتغير شيء حتى [تطبقه](/ar/docs/apply-changes)، ويطبق بدون نشر. Source: https://ghaym.me/docs/countries-and-sites.md # الدول والمواقع تعمل كل خدمة في موقع واحد، وكل موقع يقع في دولة واحدة. ## المواقع الموقع هو مركز بيانات واحد داخل الدولة، له أجهزته وأسعاره، فقد يختلف سعر الحجم نفسه في موقع آخر. ولكل موقع اسم مختصر، مثل `amman-1`. لا يظهر عند اختيار موقع إلا المواقع المفتوحة للخدمات الجديدة. ## اختر موقعا عند إنشاء الخدمة لا يختار أحد الموقع عنك، فاختره قبل أن تنشئ الخدمة. ولا يمكن تغيير الموقع لاحقا. تعمل [الخدمة](/ar/docs/projects-and-services) في موقع واحد داخل البيئة. ولنقلها، أنشئ خدمة جديدة في الموقع الآخر، واحذف القديمة. ## دولة أخرى، خدمة أخرى لكي تعمل في دولة أخرى بجانب `web` في `amman-1`، انشر خدمة أخرى في موقع مفتوح هناك، مثل `web-sa` في `riyadh-1` عندما يفتح. تغيير المستودع أو الفرع أو الحجم أو النسخ أو التوجيه أو المتغيرات أو الوصول أو النطاقات أو الإيقاف أو التشغيل في خدمة واحدة يترك الأخرى كما كانت، ولا يمس نشر إحداهما الأخرى. تبقى الروابط لكل دولة (`..ghaym.app`). ويربط النطاق المخصص بالخدمة دون أن تذكر دولة. ## لا يعبر شيء الموقع مرجع مثل `${{Service.VAR}}` يعمل داخل موقع واحد فقط. المخزن يربط بخدمة في موقعه وحده. وتصل إلى خدمة الويب في موقع آخر عبر عنوانها العام. ## نسخ في كل دولة تحتفظ بنسخ في كل دولة يدويا، كما تفعل على AWS. تعمل كل قاعدة بيانات في موقع واحد، ويبقى قراؤها في الموقع نفسه. تعرض صفحة [مكان البيانات](/ar/docs/data-residency) كل خدمة وقاعدة بيانات ومخزن مع موقعه ودولته. ## من الـ CLI في الـ [CLI](/ar/docs/install-the-cli)، اختر الموقع بالخيار `--site`، واعرض المواقع بالأمر `ghaym cloud regions list`: ```sh ghaym cloud regions list ghaym cloud services create --project shop --type git --repo owner/web --size --site amman-1 ``` Source: https://ghaym.me/docs/workspaces-and-roles.md # مساحات العمل والأدوار تملك مساحة العمل مشاريعك ومخازنك وفاتورتك، ودور كل عضو يحدد ما يستطيع أن يرى ويغير. ## مساحات العمل لمساحة العمل مشاريعها وحساب فوترتها وفواتيرها. والمخازن أيضا تابعة لها، لا لمشروع. تنشأ مساحة عملك الأولى عند أول دخول لك باسم «مساحتي الشخصية». وهي مثل أي مساحة: تقبل أعضاء حتى حد المقاعد في خطتها، ويستطيع مالكها تغيير اسمها. ولكي تعمل مع أشخاص آخرين، ادعهم إلى مساحة عمل، أو أنشئ مساحة للفريق من **مساحة عمل جديدة**، كما تريك صفحة [أضف فريقك إلى مساحة العمل](/ar/docs/team). ## الأدوار لكل عضو في مساحة العمل دور واحد: | الدور | ما يستطيع فعله | | --- | --- | | **المالك** | كل شيء، وهو الوحيد الذي يستطيع نقل الملكية. ولكل مساحة مالك واحد بالضبط. | | **مشرف** | كل شيء إلا الملكية، بما في ذلك الأعضاء والمال. | | **مطور** | المشاريع والخدمات والنشر والمتغيرات. دون أعضاء ولا فوترة. | | **مشاهد** | قراءة فقط، دون قيم المتغيرات. | القراءة مفتوحة لكل الأدوار، والتغيير يحتاج إلى **مطور** أو أعلى. والأعضاء والفوترة للمالك والمشرفين فقط: هم الذين يدعون الناس، ويغيرون الخطة وحد الاستهلاك، وتصلهم رسائل التنبيه بالبريد الإلكتروني. ## تغيير الأدوار والمالك يستطيع المالك والمشرفون تغيير دور أي عضو أو إزالته. دور المالك لا يتغير: يختار المالك **انقل الملكية** على عضو آخر، فيصبح هو مشرفا. ويبقى للمساحة مالك دائما. ## من الـ CLI اعرض مساحات العمل التي أنت فيها، عبر الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud workspaces list ``` ولكي تعمل في واحدة منها، أضف `--workspace` مع الـ ID الخاص بها إلى أي أمر. Source: https://ghaym.me/docs/billing.md # طريقة حساب الفاتورة تدفع بالدقيقة عما يعمل، على سعر الحجم الشهري، وفي آخر الشهر تصدر فاتورة باستهلاكه. ## ماذا تدفع كل شهر فاتورة كل شهر هي رسوم خطتك مع الاستهلاك الذي لا تشمله خطتك. وخطة Team تشمل كل شهر استهلاكا بقيمة رسومها، فتدفع الرسوم، أو استهلاكك إن زاد عليها. وما لا يستهلك من ذلك في شهر لا ينتقل إلى الشهر التالي. ورسوم الخطة تحسب كاملة عن كل شهر. رسوم كل خطة وحدودها موجودة في صفحة [الحدود والأسعار](/ar/docs/limits-and-prices)، وصفحة [غير خطتك](/ar/docs/plans) تنقلك بينها. لا يحسب عليك شيء قبل أن ينتهي الشهر. وعندما يغلق الشهر، تصدر فاتورته. الفاتورة بعملة مساحة عملك، الدينار الأردني أو الريال السعودي، والضريبة مشمولة بالسعر. والاستهلاك في موقع يسعر بالعملة الأخرى يحول بسعر الصرف الحالي. ويغير المالك العملة من **الإعدادات › العملة**. ## الموارد بالدقيقة لكل حجم سعر شهري، والـ console يعرضه قبل أن تختار الحجم. تحسب الخدمة بهذا السعر، مقسوما على دقائق الشهر، عن كل دقيقة تكون فيها مستيقظة. والخدمة النائمة لا تحسب عليها موارد، كما تشرح صفحة [النوم](/ar/docs/sleep). | في شهر واحد، خدمة | تحسب | | --- | --- | | مستيقظة كل دقيقة | سعر حجمها الشهري بالضبط، ولا يزيد أبدا | | مستيقظة نصف الدقائق | نصف سعر حجمها الشهري | | ثلاث نسخ، مستيقظة كل دقيقة | ثلاثة أضعاف سعر حجمها الشهري | | انتقلت إلى حجم أكبر في منتصف الشهر | كل جزء بسعر الحجم الذي عملت به | ## التخزين - الـ volume يحسب بالـ GB كل شهر، سواء كانت خدمته مستيقظة أو نائمة. - تحسب الملفات التي في المخزن بالـ GB المخزنة كل شهر. والملف الذي لم يقرأ منذ 30 يوما أو أكثر يحسب بسعر البارد حتى أول قراءة، وفتحه أو تنزيله يعيده إلى سعر الساخن. وتشرح صفحة [احفظ ملفاتك في مخزن](/ar/docs/object-storage) الباقي. ## متابعة الفاتورة ووضع حد لها في **الفوترة**، يعرض **الملخص** كم كلف الشهر **حتى الآن**، مع رسوم الخطة، وكم هو **متوقع للشهر**. و**الاستهلاك** يفصل الشهر حسب المشروع والبيئة والخدمة. في الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud usage ghaym cloud billing invoices list ``` حد الاستهلاك يغطي مساحة العمل كلها: عندما يصل الاستهلاك إلى الحد، تتوقف خدماتك حتى ترفعه أو يبدأ الشهر التالي، ولا يحذف شيء. وسقف الميزانية على مشروع يرفض أي خدمة جديدة ترفع مصروف هذا الشهر فوقه. وصفحة [تابع إنفاقك وضع له حدا](/ar/docs/spending-limits) تضبط الاثنين. Source: https://ghaym.me/docs/cli.md # مرجع الـ CLI ابحث عن أي أمر `ghaym`: الـ arguments والـ flags ورموز الخروج، والـ JSON الذي يطبعه. لـ `ghaym` 0.0.21. لترى النسخة التي لديك أو تحدثها، انظر [ثبت الـ CLI وسجل الدخول](/ar/docs/install-the-cli). ## مجموعات الأوامر | المجموعة | الغرض | |---|---| | [`ghaym config`](/ar/docs/cli-config) | اقرأ إعدادات الـ CLI واكتبها | | [`ghaym cloud workspaces`](/ar/docs/cli-workspaces) | إدارة مساحات العمل | | [`ghaym cloud projects`](/ar/docs/cli-projects) | إدارة المشاريع | | [`ghaym cloud environments`](/ar/docs/cli-environments) | إدارة البيئات | | [`ghaym cloud services`](/ar/docs/cli-services) | إدارة الخدمات | | [`ghaym cloud deployments`](/ar/docs/cli-deployments) | تفاصيل عمليات النشر | | [`ghaym cloud changes`](/ar/docs/cli-changes) | التغييرات المجهزة على بيئة، وتنشر معا | | [`ghaym cloud topology`](/ar/docs/cli-topology) | كل نسخة من كل خدمة | | [`ghaym cloud rollouts`](/ar/docs/cli-rollouts) | النشر نسخة بعد نسخة | | [`ghaym cloud residency`](/ar/docs/cli-residency) | أين تعمل كل خدمة وقاعدة بيانات ومخزن، واتفاقية المعالجة لكل دولة | | [`ghaym cloud regions`](/ar/docs/cli-regions) | المناطق والأحجام التي تبيعها | | [`ghaym cloud engines`](/ar/docs/cli-engines) | ما يمكن أن تشغله قاعدة البيانات أو الكاش | | [`ghaym cloud vars`](/ar/docs/cli-vars) | إدارة متغيرات البيئة | | [`ghaym cloud domains`](/ar/docs/cli-domains) | إدارة النطاقات المخصصة | | [`ghaym cloud access`](/ar/docs/cli-access) | من يستطيع الوصول إلى خدمة ويب، في كل بيئة | | [`ghaym cloud buckets`](/ar/docs/cli-buckets) | إدارة المخازن | | [`ghaym cloud billing`](/ar/docs/cli-billing) | تفاصيل الفوترة | | [`ghaym cloud audit`](/ar/docs/cli-audit) | تفاصيل سجل التدقيق | | [`ghaym cloud approvals`](/ar/docs/cli-approvals) | إدارة الموافقات | | [`ghaym cloud sessions`](/ar/docs/cli-sessions) | تفاصيل جلسات الـ agents | | [`ghaym cloud git`](/ar/docs/cli-git) | الربط مع GitHub App | | [`ghaym help`](/ar/docs/cli-help) | مواضيع مساعدة إضافية | عبر الـ [CLI](/ar/docs/install-the-cli)، تحصل على كل الأوامر والـ flags بنداء واحد: ```sh ghaym help all --json ``` ## `ghaym login` سجل دخول هذا الجهاز، في المتصفح أو بمفتاح API يمرر عبر pipe. ```usage ghaym login ``` ## `ghaym logout` سجل خروج هذا الجهاز وألغ دخوله من المتصفح. ```usage ghaym logout ``` ## `ghaym whoami` اعرض الهوية التي وراء بيانات الدخول الحالية. ```usage ghaym whoami ``` ## `ghaym cloud init` اكتشف الـ framework واكتب ملف `ghaym.yaml`. ```usage ghaym cloud init [flags] ``` | الـ flag | الوظيفة | |---|---| | `--name ` | اسم المشروع، واسم المجلد إن لم يحدد | | `--port ` | الـ port الذي تستمع عليه الخدمة | | `--framework ` | غير الـ framework الذي اكتشفه | | `--repo ` | الـ repo على GitHub الذي ينشر منه المشروع | | `--replicas ` | عدد نسخ خدمة الويب التي تعمل | | `--size ` | الـ slug لحجم الـ instance، وهو micro إذا لم تحدده | | `--force` | اكتب فوق `ghaym.yaml` إذا كان موجودا | ## `ghaym cloud deploy` أنشئ ما يصفه `ghaym.yaml`، ثم اشرح كيف تنشر. ```usage ghaym cloud deploy [flags] ``` | الـ flag | الوظيفة | |---|---| | `--repo ` | الـ repo على GitHub الذي تنشر منه | | `--size ` | الـ slug لحجم الـ instance، ويتقدم على `size` في `ghaym.yaml` | | `--site ` | الموقع الذي تنشر فيه، ويتقدم على `site` في `ghaym.yaml` | | `--env ` | البيئة التي تنشر فيها، بالاسم أو الـ id. إذا لم تحددها، فبيئة الإنتاج | ## `ghaym cloud connect` افتح tunnel من port على هذا الجهاز إلى قاعدة بيانات. ```usage ghaym cloud connect [database] [flags] ``` | الـ argument | مطلوب | |---|---| | `[database]` | لا | | الـ flag | الوظيفة | |---|---| | `--project ` | المشروع الذي فيه قاعدة البيانات، إذا كان اسمها في أكثر من مشروع | | `--env ` | البيئة، بالاسم أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--reader` | اتصل بنسخة للقراءة فقط | | `--port ` | الـ port المحلي. إذا لم تحدده، فالـ port الخاص بالمحرك أو أول port متاح بعده | | `--wake` | أيقظ القاعدة أولا إذا كانت نائمة، وانتظر حتى ترد | ## `ghaym cloud usage` اعرض الاستهلاك المحسوب وكلفته لهذا الشهر. ```usage ghaym cloud usage ``` ## الـ flags العامة | الـ flag | الوظيفة | |---|---| | `-V, --version` | اطبع رقم النسخة | | `--json` | اطبع مستند JSON ثابت على stdout | | `--dry-run` | اعرض ما سيحدث دون أن تغير شيئا | | `--intent ` | لماذا تشغل الأمر. يحفظ في سجل التدقيق | | `--idempotency-key ` | استعمل المفتاح نفسه حتى ينطبق التعديل الذي تعيده مرة واحدة | | `--workspace ` | مساحة العمل التي تعمل فيها. تتقدم على `GHAYM_WORKSPACE` وملف الإعدادات | ## متغيرات البيئة | المتغير | الوظيفة | |---|---| | `GHAYM_TOKEN` | مفتاح API يبدأ بـ `ghk_`. يتقدم دائما على بيانات الدخول المحفوظة. | | `GHAYM_API_URL`، `GHAYM_AUTH_URL` | عناوين الخدمات الأساسية. | | `GHAYM_SESSION` | uuidv7 تعيد استعماله بين النداءات حتى تجمعها في جلسة agent واحدة. وضبطه يجعل صاحب النداء agent. | | `GHAYM_INTENT` | نص حر يحفظ في سجل التدقيق. | | `GHAYM_AGENT` | يستبدل الـ harness المكتشف، بصيغة `name/version`. | | `GHAYM_WORKSPACE` | id مساحة العمل. `--workspace` يتقدم عليه، وهو يتقدم على ملف الإعدادات. وإذا كان معرفا وفارغا، فلا يسمي أي مساحة. | ## رموز الخروج | الرمز | الاسم | المعنى | من HTTP | |---|---|---|---| | `0` | `ok` | نجح الأمر. | – | | `1` | `generic` | فشل غير مصنف (شبكة، خادم، bug). | أي status آخر، أو لا يوجد رد | | `2` | `usage` | الأمر مكتوب خطأ: flag غير معروف، أو argument ناقص، أو احتاج إلى سؤال والجلسة غير تفاعلية. | – | | `3` | `auth` | لم تسجل الدخول، أو انتهت صلاحية الـ token، أو ليست لديك صلاحية. | 401, 403 | | `4` | `not-found` | المورد الذي ذكرته غير موجود. | 404 | | `5` | `conflict` | القيم غير صحيحة، أو الطلب يتعارض مع الوضع الحالي. | 400, 409, 422 | | `6` | `needs-approval` | العملية تحتاج إلى موافقة: أنشئت موافقة وهي معلقة. تابعها بـ `ghaym cloud approvals wait `. | 202 مع `approval-required` | | `7` | `quota` | موقوف بسبب حصة أو ميزانية أو وضع الفوترة. | 402, 429 | ## مخرجات JSON مع `--json`، يطبع الأمر مستند JSON واحدا على stdout. | الحقل | المحتوى | |---|---| | `ok` | `true` إذا نجح الأمر، و `false` إذا فشل. | | `data` | النتيجة عندما ينجح. تحتوي معظم القوائم على `items` و `pagination` (`limit` و `offset` و `total`). | | `data` مع `--dry-run` | `dryRun`، ثم إحدى خطتين. `ghaym cloud services create` و `ghaym cloud domains add` و `ghaym cloud sessions rollback` تسأل الـ API، فيرد بخطته مع التكلفة: `operation` و `summary` و `resources` و `estimatedMonthlyJod` و `warnings`. وأي تعديل غيرها لا يرسل شيئا: `simulated` و `reason`، والـ `request` الذي كان سيرسله، والـ `Authorization` مخفي. ولا يتغير شيء. | | `exitCode` | [رمز الخروج](#رموز-الخروج)، عندما يفشل. | | `error` | [مستند الخطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ) من الـ API كما هو. الـ `type` فيه هو اسم صفحته في أخطاء الـ API. ويضيف الـ CLI `suggestions` إذا لم يطابق المرجع أي شيء. | ## سلوك كل أمر - لا يطرح سؤالا إلا في تيرمينال. في الـ CI، أو دون تيرمينال، أو تحت Claude Code، يتوقف برمز `2` ويخبرك بأي flag تمرره. - كل أمر يغير شيئا يقبل `--dry-run`، ومعه لا يغير شيئا. - كل تعديل يرسل `Idempotency-Key` ينشئه بنفسه، و `--idempotency-key` يضع مفتاحا من عندك. - العملية التي تحتاج إلى موافقة تخرج برمز `6` ومعها id الموافقة. انتظرها بـ `ghaym cloud approvals wait`. - الـ `` أو الـ `` يقبل الـ id أو الـ slug. والـ slug لا يتكرر في الحساب. - المرجع الذي لا يطابق شيئا يخرج برمز `4`، ويذكر أقرب slugs، وأيضا تحت `error.suggestions` مع `--json`. - الـ `--env` يقبل اسما أو id. وإذا لم تحدده، يعمل الأمر الخاص بالخدمة على بيئة الإنتاج. والأمر الذي يقبل id البيئة يحتاج إلى `--project` إذا أعطيته اسما. - الـ scale والإعدادات والمتغيرات والوصول وربط المخازن [تنتظر](/ar/docs/staged-changes). ولا يتغير شيء حتى `ghaym cloud changes apply`، أو `--apply` في الأمر نفسه. - `vars set` و `vars unset` يجهزان المتغير على خدمة واحدة مع `--service`. وبدونه يكون المتغير مشتركا ويصل إلى كل خدمة في البيئة. - حد الخطة يخرج برمز `7` ومعه `planKey` و `limit` و `limitValue`. و `ghaym cloud billing plans` يعرض حدود كل خطة. - `ghaym cloud connect` يبقي الـ tunnel مفتوحا حتى Ctrl-C، ويعيد الاتصال على الـ port نفسه. مع `--json` يطبع سطرا عندما يجهز الـ tunnel، وسطرا آخر إذا أغلقه الخادم. القاعدة النائمة تخرج برمز `5`، و `--wake` يوقظها أولا. Source: https://ghaym.me/docs/cli-config.md # ghaym config اقرأ إعدادات الـ CLI واكتبها. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym config get` اعرض الإعدادات المعمول بها الآن. ```usage ghaym config get ``` ## `ghaym config set` اكتب قيمة إعداد في ملف الإعدادات. ```usage ghaym config set ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | Source: https://ghaym.me/docs/cli-workspaces.md # ghaym cloud workspaces إدارة مساحات العمل. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud workspaces list` اعرض مساحات العمل التي أنت عضو فيها. ```usage ghaym cloud workspaces list [flags] ``` | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | ## `ghaym cloud workspaces create` أنشئ مساحة عمل. ```usage ghaym cloud workspaces create --name ``` | الـ flag | الوظيفة | |---|---| | `--name ` | مطلوب. اسم مساحة العمل | ## `ghaym cloud workspaces delete` احذف مساحة عمل فارغة. ```usage ghaym cloud workspaces delete ``` | الـ argument | مطلوب | |---|---| | `` | نعم | Source: https://ghaym.me/docs/cli-projects.md # ghaym cloud projects إدارة المشاريع. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud projects list` اعرض المشاريع. ```usage ghaym cloud projects list [flags] ``` | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | ## `ghaym cloud projects get` اعرض مشروعا واحدا، بالـ id أو الـ slug. ```usage ghaym cloud projects get ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud projects create` أنشئ مشروعا. ```usage ghaym cloud projects create --name [flags] ``` | الـ flag | الوظيفة | |---|---| | `--name ` | مطلوب. اسم المشروع | | `--branch ` | الـ branch الذي ينشر منه الإنتاج | | `--sandbox` | أنشئه مشروع sandbox | | `--budget-cap ` | سقف الميزانية الشهري بعملة مساحة العمل | ## `ghaym cloud projects update` غير اسم مشروع أو سقفه أو سياسة الموافقات فيه. ```usage ghaym cloud projects update [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--name ` | اسم المشروع الجديد | | `--budget-cap ` | سقف الميزانية الشهري بعملة مساحة العمل، أو `none` لإزالته | | `--approval-policy ` | واحدة من: `sandbox`، `standard`، `strict` | ## `ghaym cloud projects delete` احذف مشروعا، بالـ id أو الـ slug. ```usage ghaym cloud projects delete [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--confirm` | احذف قواعد بيانات المشروع أيضا | Source: https://ghaym.me/docs/cli-environments.md # ghaym cloud environments إدارة البيئات. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud environments list` اعرض بيئات مشروع. ```usage ghaym cloud environments list [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | ## `ghaym cloud environments get` اعرض بيئة واحدة، بالاسم أو الـ id. ```usage ghaym cloud environments get ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | ## `ghaym cloud environments create` أنشئ بيئة تنشر من الـ branch الخاص بها. ```usage ghaym cloud environments create --project --name --branch ``` | الـ flag | الوظيفة | |---|---| | `--project ` | مطلوب. المشروع، بالـ id أو الـ slug | | `--name ` | مطلوب. اسم البيئة | | `--branch ` | مطلوب. الـ branch الذي تنشر منه | ## `ghaym cloud environments delete` احذف بيئة غير بيئة الإنتاج. ```usage ghaym cloud environments delete [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--project ` | المشروع، ويلزم إذا كان `` اسما | | `--confirm` | احذف قواعد بيانات البيئة أيضا | Source: https://ghaym.me/docs/cli-services.md # ghaym cloud services إدارة الخدمات. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud services list` اعرض خدمات مشروع. ```usage ghaym cloud services list [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | ## `ghaym cloud services get` اعرض خدمة واحدة، بالـ id أو الـ slug أو الاسم. ```usage ghaym cloud services get ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud services create` شغل خدمة جديدة في مشروع. ```usage ghaym cloud services create --project --type [flags] ``` | الـ flag | الوظيفة | |---|---| | `--project ` | مطلوب. المشروع، بالـ id أو الـ slug | | `--type ` | مطلوب. git أو database أو cache. والـ slug الخاص بمحرك وحده، مثل mysql، يعني نوعه | | `--engine ` | محرك قاعدة البيانات أو الكاش، مثل postgres أو mysql. يعرضها `ghaym cloud engines list` | | `--name ` | اسم الخدمة. إذا لم تحدده، فيؤخذ من الـ repo أو النوع | | `--repo ` | الـ repo على GitHub لخدمة git | | `--env ` | البيئة التي تشغلها فيها، بالاسم أو الـ id | | `--db-version ` | نسخة المحرك لقاعدة البيانات أو الكاش | | `--size ` | الـ slug لحجم الـ instance لخدمة git، مطلوب لـ git | | `--db-size ` | حجم قاعدة البيانات أو الكاش. يعرضها `ghaym cloud regions sizes --database` | | `--replicas ` | عدد النسخ التي تعمل من خدمة الويب | | `--site ` | الموقع الذي تعمل فيه الخدمة؛ `ghaym cloud regions list` يعرض المواقع | ## `ghaym cloud services add` أضف خدمة إلى بيئة أخرى في مشروعها، بالـ id أو الـ slug أو الاسم. ```usage ghaym cloud services add --env --from [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--env ` | مطلوب. البيئة التي تضاف إليها، بالاسم أو الـ id | | `--from ` | مطلوب. البيئة التي تعمل فيها، بالاسم أو الـ id، وتنسخ إعداداتها | | `--site ` | الموقع الذي تعمل فيه؛ موقع البيئة المصدر إذا لم تذكره | ## `ghaym cloud services delete` احذف خدمة من بيئة واحدة، بالـ id أو الـ slug أو الاسم. ```usage ghaym cloud services delete --env [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--env ` | مطلوب. البيئة التي تحذف منها، بالاسم أو الـ id | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | ## `ghaym cloud services redeploy` انشر الخدمة من جديد، بالـ id أو الـ slug أو الاسم. ```usage ghaym cloud services redeploy [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--branch ` | الـ branch الذي تنشره | | `--message ` | رسالة الـ commit التي تحفظ | ## `ghaym cloud services scale` غير النسخ أو القراء أو توزيع الطلبات، كتغيير مجهز. ```usage ghaym cloud services scale [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--replicas ` | نسخ خدمة الويب | | `--readers ` | نسخ القراءة لقاعدة البيانات | | `--routing ` | كيف تصل الطلبات إلى النسخ: equal أو same_visitor | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | ## `ghaym cloud services set` غير إعدادات البناء والتشغيل بصيغة key=value، كتغيير مجهز. ```usage ghaym cloud services set [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم، واحد أو أكثر | | الـ flag | الوظيفة | |---|---| | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | ## `ghaym cloud services logs` تابع سجل التشغيل مباشرة من كل النسخ. ```usage ghaym cloud services logs [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--project ` | المشروع الذي فيه الخدمة، إذا كان اسمها في أكثر من مشروع | | `-f, --follow` | أبق البث مفتوحا والخدمة نائمة | ## `ghaym cloud services metrics` اعرض أرقام الـ CPU والذاكرة والطلبات. ```usage ghaym cloud services metrics [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | ## `ghaym cloud services connection` اعرض كيف تصل خدمات المشروع إلى قاعدة البيانات، وأمر الـ tunnel. ```usage ghaym cloud services connection [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | ## `ghaym cloud services resolved-env` اعرض المتغيرات التي يبدأ بها الـ container في موقع هذه الخدمة. ```usage ghaym cloud services resolved-env [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--show` | اطبع القيم بدل إخفائها | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | ## `ghaym cloud services retry-provisioning` أعد محاولة تجهيز قاعدة بيانات فشل تجهيزها. ```usage ghaym cloud services retry-provisioning ``` | الـ argument | مطلوب | |---|---| | `` | نعم | Source: https://ghaym.me/docs/cli-deployments.md # ghaym cloud deployments تفاصيل عمليات النشر. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud deployments list` اعرض عمليات النشر. ```usage ghaym cloud deployments list [flags] ``` | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | | `--service ` | عمليات النشر الخاصة بهذه الخدمة فقط، بالـ id أو الـ slug أو الاسم | | `--environment ` | عمليات النشر الخاصة بهذه البيئة فقط. يحتاج إلى `--service` | | `--project ` | المشروع، ويلزم إذا كان `--environment` اسما | ## `ghaym cloud deployments get` اعرض عملية نشر واحدة. ```usage ghaym cloud deployments get ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud deployments rollback` اجعل هذا النشر يعمل مرة أخرى. ```usage ghaym cloud deployments rollback ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud deployments logs` تابع سجل البناء والتشغيل مباشرة. ```usage ghaym cloud deployments logs [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `-f, --follow` | واصل المتابعة بعد انتهاء النشر | | `--since ` | استأنف من id حدث سابق | Source: https://ghaym.me/docs/cli-changes.md # ghaym cloud changes التغييرات المجهزة على بيئة، وتنشر معا. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud changes show` اعرض ما هو مجهز. ```usage ghaym cloud changes show --project [flags] ``` | الـ flag | الوظيفة | |---|---| | `--project ` | مطلوب. المشروع، بالـ id أو الـ slug | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | ## `ghaym cloud changes apply` انشر كل التغييرات المجهزة. ```usage ghaym cloud changes apply --project [flags] ``` | الـ flag | الوظيفة | |---|---| | `--project ` | مطلوب. المشروع، بالـ id أو الـ slug | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | ## `ghaym cloud changes discard` ألغ كل التغييرات المجهزة. ```usage ghaym cloud changes discard --project [flags] ``` | الـ flag | الوظيفة | |---|---| | `--project ` | مطلوب. المشروع، بالـ id أو الـ slug | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | ## `ghaym cloud changes stage` أضف تغييرا خاما واحدا، كتغيير مجهز. ```usage ghaym cloud changes stage --kind --project [flags] ``` | الـ flag | الوظيفة | |---|---| | `--kind ` | مطلوب. نوع التغيير، مثل env_var_set أو setting_set | | `--project ` | مطلوب. المشروع، بالـ id أو الـ slug | | `--service ` | الخدمة التي يخصها التغيير، بالـ id أو الـ slug أو الاسم. بدونها يكون المتغير مشتركا | | `--key ` | مفتاح المتغير أو الإعداد | | `--value ` | القيمة الجديدة | | `--secret` | احفظ المتغير كسر | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | ## `ghaym cloud changes unstage` أزل تغييرا مجهزا واحدا. ```usage ghaym cloud changes unstage --kind --project [flags] ``` | الـ flag | الوظيفة | |---|---| | `--kind ` | مطلوب. نوع التغيير، مثل env_var_set أو setting_set | | `--project ` | مطلوب. المشروع، بالـ id أو الـ slug | | `--service ` | الخدمة التي يخصها التغيير، بالـ id أو الـ slug أو الاسم. بدونها يكون تغييرا على متغير مشترك | | `--key ` | مفتاح المتغير أو الإعداد | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | Source: https://ghaym.me/docs/cli-topology.md # ghaym cloud topology كل نسخة من كل خدمة. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud topology show` اعرض الـ topology. ```usage ghaym cloud topology show --project [flags] ``` | الـ flag | الوظيفة | |---|---| | `--project ` | مطلوب. المشروع، بالـ id أو الـ slug | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | Source: https://ghaym.me/docs/cli-rollouts.md # ghaym cloud rollouts النشر نسخة بعد نسخة. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud rollouts latest` اعرض آخر نشر، نسخة بعد نسخة. ```usage ghaym cloud rollouts latest [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | Source: https://ghaym.me/docs/cli-residency.md # ghaym cloud residency أين تعمل كل خدمة وقاعدة بيانات ومخزن، واتفاقية المعالجة لكل دولة. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud residency report` اعرض كل مورد مع موقعه ودولته. ```usage ghaym cloud residency report --project [flags] ``` | الـ flag | الوظيفة | |---|---| | `--project ` | مطلوب. المشروع، بالـ id أو الـ slug | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | Source: https://ghaym.me/docs/cli-regions.md # ghaym cloud regions المناطق والأحجام التي تبيعها. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud regions list` اعرض المناطق. ```usage ghaym cloud regions list [flags] ``` | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | ## `ghaym cloud regions sizes` اعرض أحجام منطقة وأسعارها. ```usage ghaym cloud regions sizes [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | | `--database` | أحجام قواعد البيانات بدل أحجام الـ instances | Source: https://ghaym.me/docs/cli-engines.md # ghaym cloud engines ما يمكن أن تشغله قاعدة البيانات أو الكاش. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud engines list` اعرض المحركات مع نوع كل منها وإصداراته والـ port الخاص به. ```usage ghaym cloud engines list ``` Source: https://ghaym.me/docs/cli-vars.md # ghaym cloud vars إدارة متغيرات البيئة. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud vars list` اعرض متغيرات البيئة. ```usage ghaym cloud vars list --env [flags] ``` | الـ flag | الوظيفة | |---|---| | `--env ` | مطلوب. id البيئة، أو اسمها مع `--project` | | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | | `--project ` | المشروع، ويلزم إذا كان `--env` اسما | | `--service ` | متغيرات هذه الخدمة فقط، بالـ id أو الـ slug أو الاسم | | `--show` | اطبع القيم غير السرية بدل إخفائها | ## `ghaym cloud vars set` اضبط متغير بيئة، كتغيير مجهز. ```usage ghaym cloud vars set [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--service ` | الخدمة التي يجهز عليها المتغير، بالـ id أو الـ slug أو الاسم. بدونها يصل المتغير إلى كل خدمة في البيئة | | `--project ` | المشروع، ويلزم بدون `--service` | | `--secret` | احفظه كسر. لا يمكن قراءة القيمة مرة أخرى أبدا | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | ## `ghaym cloud vars unset` أزل متغير بيئة، كتغيير مجهز. ```usage ghaym cloud vars unset [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--service ` | الخدمة التي يجهز عليها المتغير، بالـ id أو الـ slug أو الاسم. بدونها يصل المتغير إلى كل خدمة في البيئة | | `--project ` | المشروع، ويلزم بدون `--service` | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | Source: https://ghaym.me/docs/cli-domains.md # ghaym cloud domains إدارة النطاقات المخصصة. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud domains list` اعرض نطاقات خدمة. ```usage ghaym cloud domains list [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | ## `ghaym cloud domains add` اربط نطاقا مخصصا. ```usage ghaym cloud domains add ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | ## `ghaym cloud domains verify` افحص الـ DNS الخاص بالنطاق الآن. ```usage ghaym cloud domains verify ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | ## `ghaym cloud domains remove` افصل نطاقا مخصصا. ```usage ghaym cloud domains remove ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | Source: https://ghaym.me/docs/cli-access.md # ghaym cloud access من يستطيع الوصول إلى خدمة ويب، في كل بيئة. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud access get` اعرض الوصول في كل البيئات. الخدمة بالـ id أو الـ slug أو الاسم. ```usage ghaym cloud access get ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud access set` حدد أين تجيب الخدمة ومن يستطيع فتحها، كتغيير مجهز. ```usage ghaym cloud access set [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--reach ` | public أو custom-domain أو private | | `--members-only` | لا يفتحها إلا أعضاء مساحة العمل الذين سجلوا الدخول | | `--no-members-only` | يستطيع فتحها أي شخص يصل إليها | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | ## `ghaym cloud access ips list` اعرض قائمة الـ IP وما هو مجهز عليها. ```usage ghaym cloud access ips list [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | ## `ghaym cloud access ips add` أضف عناوين أو نطاقات CIDR، كتغيير مجهز. تجهز القائمة كلها معا، فأي تعديل آخر مجهز عليها يستبدل. ```usage ghaym cloud access ips add [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم، واحد أو أكثر | | الـ flag | الوظيفة | |---|---| | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | ## `ghaym cloud access ips remove` أزل عناوين من قائمة الـ IP، كتغيير مجهز. ```usage ghaym cloud access ips remove [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم، واحد أو أكثر | | الـ flag | الوظيفة | |---|---| | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | ## `ghaym cloud access ips clear` أفرغ قائمة الـ IP حتى يستطيع أي عنوان فتحها، كتغيير مجهز. ```usage ghaym cloud access ips clear [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--yes` | أفرغها دون أن تسأل | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | Source: https://ghaym.me/docs/cli-buckets.md # ghaym cloud buckets إدارة المخازن. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud buckets list` اعرض مخازن مساحة العمل. ```usage ghaym cloud buckets list ``` ## `ghaym cloud buckets sites` اعرض المواقع التي يمكن إنشاء مخزن فيها، مع سعر التخزين. ```usage ghaym cloud buckets sites ``` ## `ghaym cloud buckets create` أنشئ مخزنا. يجهز في الخلفية. ```usage ghaym cloud buckets create --name --site ``` | الـ flag | الوظيفة | |---|---| | `--name ` | مطلوب. من 3 إلى 63 حرفا: حروف لاتينية صغيرة وأرقام وشرطات | | `--site ` | مطلوب. الموقع الذي يحفظ الملفات | ## `ghaym cloud buckets get` اعرض مخزنا واحدا، بالاسم أو الـ id. ```usage ghaym cloud buckets get ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud buckets update` غير القراءة العامة أو الـ origins المسموحة من المتصفح. ```usage ghaym cloud buckets update [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--public-read` | يقرأ الملف كل من لديه عنوانه | | `--no-public-read` | لا تقرأ الملفات إلا الطلبات الموقعة | | `--origin ` | origin مسموح من المتصفح، ويمكن تكراره، ويحل محل القائمة | | `--clear-origins` | لا تسمح لأي origin من المتصفح | ## `ghaym cloud buckets delete` احذف مخزنا وكل ما فيه. لا يمكن التراجع عن هذا. ```usage ghaym cloud buckets delete [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--confirm ` | اسم المخزن، للحذف دون سؤال | ## `ghaym cloud buckets stats` اعرض ما يخزنه المخزن مقارنة بحصته. ```usage ghaym cloud buckets stats ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud buckets credentials get` اعرض زوج المفاتيح. يبقى الـ secret مخفيا دون `--show`. ```usage ghaym cloud buckets credentials get [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--show` | اطبع الـ secret | ## `ghaym cloud buckets credentials rotate` أصدر زوج مفاتيح جديدا. يتوقف القديم فورا، أو بعد أن تعيد الخدمات المربوطة النشر. ```usage ghaym cloud buckets credentials rotate [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--show` | اطبع الـ secret الجديد | | `--yes` | بدل المفاتيح دون سؤال | ## `ghaym cloud buckets objects list` اعرض ملفات مجلد واحد، صفحة في كل مرة. ```usage ghaym cloud buckets objects list [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--prefix ` | المجلد الذي يعرض، وينتهي بـ / | | `--cursor ` | الصفحة التالية، من الرد الأخير | ## `ghaym cloud buckets objects summary` احسب الملفات والبايتات تحت prefix، صفحة في كل مرة. ```usage ghaym cloud buckets objects summary [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--prefix ` | المجلد الذي يحسب، وينتهي بـ / | | `--cursor ` | الصفحة التالية، من الرد الأخير | ## `ghaym cloud buckets objects download-url` اطبع رابطا موقعا قصير العمر ينزل الملف. ```usage ghaym cloud buckets objects download-url ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | ## `ghaym cloud buckets objects link` اطبع رابطا موقعا قصير العمر لمشاركة الملف. ```usage ghaym cloud buckets objects link ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | ## `ghaym cloud buckets objects delete` احذف ملفا واحدا. لا يمكن التراجع عن هذا. ```usage ghaym cloud buckets objects delete [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--yes` | احذف دون سؤال | ## `ghaym cloud buckets folder-deletes start` احسب ما في المجلد، ثم ابدأ حذفه. لا يمكن التراجع عن هذا. ```usage ghaym cloud buckets folder-deletes start [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--yes` | احذف دون سؤال | ## `ghaym cloud buckets folder-deletes list` اعرض عمليات حذف المجلدات في المخزن. ```usage ghaym cloud buckets folder-deletes list [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--status ` | الحالات مفصولة بفواصل، مثل running,stopped | ## `ghaym cloud buckets upload` ارفع ملفا واحدا، حتى 5 GiB. ```usage ghaym cloud buckets upload [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--key ` | مفتاح الملف، واسم الملف إذا لم تحدده | | `--replace` | استبدل الملف الموجود عند هذا المفتاح | ## `ghaym cloud buckets connect` جهز إعطاء خدمة ويب متغيرات `S3_*` الستة للمخزن. ```usage ghaym cloud buckets connect [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--prefix ` | prefix قبل أسماء المتغيرات، مثل UPLOADS | | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | ## `ghaym cloud buckets disconnect` جهز سحب متغيرات المخزن من خدمة ويب. ```usage ghaym cloud buckets disconnect [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | | `--apply` | انشر الآن بدل أن يبقى التغيير مجهزا | ## `ghaym cloud buckets connections` اعرض المخازن المربوطة بخدمة في بيئة واحدة. ```usage ghaym cloud buckets connections [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--env ` | اسم البيئة أو الـ id. إذا لم تحددها، فبيئة الإنتاج | Source: https://ghaym.me/docs/cli-billing.md # ghaym cloud billing تفاصيل الفوترة. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud billing spend` اعرض إنفاق مشروع في هذا الشهر. ```usage ghaym cloud billing spend ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud billing eligibility` افحص هل يستطيع الحساب النشر، ولماذا لا. ```usage ghaym cloud billing eligibility ``` ## `ghaym cloud billing plans` اعرض الخطط وحدودها. ```usage ghaym cloud billing plans [flags] ``` | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | ## `ghaym cloud billing account` اعرض حساب الفوترة وخطته. ```usage ghaym cloud billing account ``` ## `ghaym cloud billing set-plan` غير خطة الحساب. ```usage ghaym cloud billing set-plan --plan ``` | الـ flag | الوظيفة | |---|---| | `--plan ` | مطلوب. مفتاح الخطة من `billing plans` | ## `ghaym cloud billing invoices list` اعرض الفواتير. ```usage ghaym cloud billing invoices list [flags] ``` | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | ## `ghaym cloud billing invoices get` اعرض فاتورة واحدة. ```usage ghaym cloud billing invoices get ``` | الـ argument | مطلوب | |---|---| | `` | نعم | Source: https://ghaym.me/docs/cli-audit.md # ghaym cloud audit تفاصيل سجل التدقيق. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud audit list` اعرض العمليات المسجلة. ```usage ghaym cloud audit list [flags] ``` | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | | `--project ` | عمليات هذا المشروع فقط، بالـ id أو الـ slug | | `--actor ` | `human` أو `agent` | | `--from ` | العمليات من هذا الوقت وما بعده فقط | | `--to ` | العمليات قبل هذا الوقت فقط | Source: https://ghaym.me/docs/cli-approvals.md # ghaym cloud approvals إدارة الموافقات. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud approvals list` اعرض الموافقات. ```usage ghaym cloud approvals list [flags] ``` | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | | `--status ` | الموافقات التي في هذه الحالة فقط | | `--session ` | موافقات جلسة الـ agent هذه فقط | ## `ghaym cloud approvals get` اعرض موافقة واحدة. ```usage ghaym cloud approvals get ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud approvals approve` وافق على عملية معلقة وشغلها. ```usage ghaym cloud approvals approve ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud approvals deny` ارفض عملية معلقة. ```usage ghaym cloud approvals deny ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud approvals wait` انتظر حتى تقبل الموافقة أو ترفض. ```usage ghaym cloud approvals wait [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--timeout ` | توقف بعد هذا العدد من الثواني | | `--interval ` | الفاصل بين الفحوص في البداية | Source: https://ghaym.me/docs/cli-sessions.md # ghaym cloud sessions تفاصيل جلسات الـ agents. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud sessions list` اعرض جلسات الـ agents. ```usage ghaym cloud sessions list [flags] ``` | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | | `--project ` | جلسات هذا المشروع فقط، بالـ id أو الـ slug | ## `ghaym cloud sessions get` اعرض جلسة agent واحدة وعملياتها. ```usage ghaym cloud sessions get ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud sessions rollback` ألغ ما أنشأته جلسة agent. ```usage ghaym cloud sessions rollback ``` | الـ argument | مطلوب | |---|---| | `` | نعم | ## `ghaym cloud sessions watch` تابع عمليات جلسة مباشرة. ```usage ghaym cloud sessions watch ``` | الـ argument | مطلوب | |---|---| | `` | نعم | Source: https://ghaym.me/docs/cli-git.md # ghaym cloud git الربط مع GitHub App. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym cloud git install` اطبع الرابط الذي يثبت GitHub App الخاص بغيم. ```usage ghaym cloud git install ``` ## `ghaym cloud git installations` اعرض تثبيتات GitHub App التي تستطيع استعمالها. ```usage ghaym cloud git installations [flags] ``` | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | ## `ghaym cloud git repos` اعرض الـ repos الخاصة بتثبيت. `` هو الـ id من `git installations`. ```usage ghaym cloud git repos [flags] ``` | الـ argument | مطلوب | |---|---| | `` | نعم | | الـ flag | الوظيفة | |---|---| | `--limit ` | أقصى عدد من الصفوف يعاد | | `--offset ` | عدد الصفوف التي تتخطاها | | `--q ` | الـ repos التي يحتوي اسمها هذا النص فقط | ## `ghaym cloud git branches` اعرض الـ branches الخاصة بـ repo. ```usage ghaym cloud git branches --repo ``` | الـ flag | الوظيفة | |---|---| | `--repo ` | مطلوب. رابط الـ repo أو `owner/name` | Source: https://ghaym.me/docs/cli-help.md # ghaym help مواضيع مساعدة إضافية. وكل أمر هنا يأخذ أيضا [الـ flags العامة](/ar/docs/cli#الـ-flags-العامة)، ويعيد [رموز الخروج](/ar/docs/cli#رموز-الخروج)، ويطبع [مستند الـ JSON](/ar/docs/cli#مخرجات-json) مع `--json`. ## `ghaym help exit-codes` اشرح رموز الخروج التي يعيدها الـ CLI. ```usage ghaym help exit-codes ``` ## `ghaym help all` اطبع كل الأوامر والـ flags في صفحة واحدة مختصرة. ```usage ghaym help all ``` Source: https://ghaym.me/docs/api-keys.md # مفاتيح الـ API والصلاحيات للمفتاح صلاحيات بصيغة `app:resource:action`، ولا يستطيع أبدا أن يغير طريقة الدخول إلى الحساب، ويستبدل بـ token قصير العمر عبر HTTP. ## استخدام المفتاح عبر HTTP الـ [CLI](/ar/docs/install-the-cli) يجري هذا الاستبدال عنك. ومن دونه، استبدل [مفتاحك](/ar/docs/create-an-api-key) بـ token في نداء واحد. أرسل المفتاح في الـ header `Authorization`: ```sh curl -sX POST https://auth.api.ghaym.me/v1/auth/token -H "Authorization: Bearer $GHAYM_TOKEN" ``` يحتوي الرد على access token: ```json { "access_token": "", "token_type": "Bearer", "expires_in": 900, "scope": "cloud:projects:read cloud:projects:deploy" } ``` احفظ قيمة `access_token`، هنا باسم `ACCESS_TOKEN`، وأرسلها مع كل نداء: ```sh curl -s https://cloud.api.ghaym.me/v1/projects -H "Authorization: Bearer $ACCESS_TOKEN" ``` > [!NOTE] > لا تخلط بينهما. `GHAYM_TOKEN` يحمل مفتاح `ghk_` طويل العمر، وترسله إلى نداء الاستبدال فقط. أما الـ access token فترسله مع كل نداء آخر. - أرسل المفتاح في الـ header `Authorization` فقط. لا تضعه في رابط ولا في الـ body الخاص بالطلب، حتى لا يظهر في السجلات. - الـ access token قصير العمر، ولا يمكن تجديده. لكي تحصل على واحد جديد، استبدل المفتاح مرة أخرى. - تستطيع استبدال المفتاح 30 مرة في الدقيقة. احتفظ بالـ token حتى تنتهي صلاحيته، بدل أن تستبدل المفتاح قبل كل نداء. - الـ token يفعل ما تسمح به صلاحيات المفتاح، لكن فقط ما يستطيع صاحب المفتاح فعله اليوم. ترجع الأخطاء بصيغة RFC 9457. اعرض `detail` للشخص بدل أن تعيد المحاولة دون فهم. وكل الأنواع موجودة في [أخطاء الـ API](/ar/docs/errors). ## الصلاحيات للصلاحية ثلاثة أجزاء: `app:resource:action`. ويمكن أن يكون أي جزء `*`، ومعناها "الكل". ``` scope := segment ":" segment ":" segment | meta segment := "*" | [a-z0-9-]+ meta := "read-only" ``` أمثلة: - `cloud:projects:deploy`: نشر المشاريع، ولا شيء غيره. - `cloud:projects:*`: كل شيء على المشاريع. - `cloud:*:read`: قراءة أي شيء في Cloud. - `*:*:*`: كل ما يستطيع صاحب المفتاح فعله. - `read-only`: كل صلاحيات القراءة والعرض التي يملكها صاحب المفتاح. **لا يستطيع المفتاح أبدا أن يفعل أكثر من صاحبه.** يقارن غيم الصلاحيات بصلاحيات صاحب المفتاح الحالية، في كل مرة يستخدم فيها المفتاح. إذا خسر صاحب المفتاح صلاحية، تخسرها مفاتيحه أيضا فورا. والصلاحية على شيء لا يستطيع صاحب المفتاح فعله لا تمنح أي شيء. > [!TIP] > أعط كل مفتاح أصغر صلاحية تكفي لعمله. مفتاح النشر في الـ CI لا يحتاج إلى `*:*:*`. ولوحة المتابعة تحتاج إلى `read-only` فقط. ## ما لا يستطيع المفتاح فعله هناك أفعال تغير طريقة الدخول إلى الحساب. لا يقوم بها إلا الشخص نفسه، بعد أن يؤكد أنه هو: - أن يضع كلمة سر أو يزيلها. - أن يغير البريد الإلكتروني للحساب. - أن يحذف الحساب. - أن ينشئ مفاتيح API أو يدورها أو يلغيها. لا يستطيع أي مفتاح فعل ذلك، ولا يوجد إعداد يغير هذا. لهذا لا يفعل المفتاح المسرب إلا ما تسمح به صلاحياته. لا يستطيع الاستيلاء على الحساب، ولا إنشاء مفاتيح أخرى، ولا منع إلغائه. Source: https://ghaym.me/docs/limits-and-prices.md # الحدود والأسعار ابحث عن الخطط والأحجام والحدود. يسعر كل موقع بعملته: عمان ١ بالدينار الأردني، والرياض ١ بالريال السعودي. ويعرض الـ console كل سعر بعملة مساحة عملك. والأسعار تشمل الضريبة. ولمعرفة كيف تجمع في الفاتورة، اقرأ [طريقة حساب الفاتورة](/ar/docs/billing). ## الخطط | الخطة | Solo | Team | |---|---|---| | السعر | الاستهلاك فقط، بلا رسوم شهرية | 99 دينارا أو 549 ريالا في الشهر، وتشمل استهلاكا بالقيمة نفسها | | المشاريع | بلا حد | بلا حد | | البيئات لكل مشروع | 2 | بلا حد | | الخدمات | 20 | بلا حد | | نسخ الخدمة الواحدة | 3 | بلا حد | | الأعضاء | 3 | بلا حد | | الأحجام | كلها | كلها | | قيد التشغيل معا (ذاكرة، vCPU) | 8 GB، 4 vCPU | 16 GB، 8 vCPU | | المخازن | 5 | 20 | | سعة المخازن | 50 GB | 250 GB | | مدة حفظ السجلات | 24 ساعة | 7 أيام | | مدة حفظ النشاط | 90 يوم | 365 يوم | | النسخ الليلية المحفوظة | 7 | 30 | | النسخ الأسبوعية المحفوظة | 4 | 8 | | النسخ اليدوية | 3 | 10 | `ghaym cloud billing plans` يطبع حدود المشاريع والنسخ لكل خطة. ## الأحجام لكل حجم سعر شهري. تدفع الخدمة بالدقيقة وهي تعمل، بهذا السعر، ولا تدفع شيئا وهي نائمة. وتختلف الأسعار من موقع إلى آخر. لكي ترى أحجام موقع وأسعاره عبر الـ [CLI](/ar/docs/install-the-cli): ```sh ghaym cloud regions sizes amman-1 ghaym cloud regions sizes riyadh-1 ``` وخارج الإنتاج، [تنام](/ar/docs/sleep) الخدمة بعد 15 دقيقة دون أي طلب. ## قواعد البيانات والكاش لقواعد البيانات والكاش حجمان، 512 MB و 1 GB. في عمان ١، سعر 512 MB هو 4.500 دينار في الشهر، وسعر 1 GB هو 9.000 دينار في الشهر. ولكل موقع آخر أسعاره. ولا تنام قواعد البيانات والكاش في الإنتاج أبدا. لكي ترى أحجام موقع وأسعاره: ```sh ghaym cloud regions sizes amman-1 --database ``` ## تخزين الملفات الرفع المقسم (multipart) الذي لم يكتمل يلغى بعد سبعة أيام. Source: https://ghaym.me/docs/harness.md # ملفات الـ agent انسخ ملف AGENTS.md أو CLAUDE.md أو قواعد Cursor أو skill لـ Claude Code إلى الـ repo الخاص بك، أو احصل عليه خاما. هذه الملفات بالإنجليزية في اللغتين، لأن الـ [coding agent](/ar/docs/agents) هو الذي يقرؤها، لا الشخص. ## AGENTS.md الملف العام الذي تقرؤه أغلب الـ harnesses، فابدأ به. املأ القيم التي بين الأقواس، مثل branch الإنتاج واسم الخدمة والبيئة، واحذف ما لا ينطبق على مشروعك. والأوامر التي فيه تعمل على الـ [CLI](/ar/docs/install-the-cli). ```sh curl -sL https://ghaym.me/agents.md >> AGENTS.md ``` ````markdown AGENTS.md # AGENTS.md: deploying this repository to Ghaym Cloud Add this to the AGENTS.md at the root of your repository (or create one), fill in the bracketed values, and delete what doesn't apply to your project. It tells a coding agent (Claude Code, Codex, Cursor or a similar tool) how this project reaches production. Each rule links the page of the Ghaym Cloud docs that explains it; read that page before acting on the rule. Canonical version: https://ghaym.me/agents.md ## This project - Production branch: `[main]` - Service name in Ghaym: `[web]` - Environment: `[production]` ## Before you start - **Sign-up needs a person.** Deploying opens once Ghaym approves the account. If there is no account, say so and stop. [Set up a coding agent](https://ghaym.me/en/docs/agents) - **Use the CLI, not hand-written API calls.** [Install the CLI and sign in](https://ghaym.me/en/docs/install-the-cli) - **Sign in through the person.** The CLI uses the login of whoever runs it. If `ghaym whoami` fails, ask them to run `ghaym login` in their own terminal; never ask them to paste a key into the chat. [Set up a coding agent](https://ghaym.me/en/docs/agents) - **Learn every command and flag** in one call with `ghaym help all --json`. [CLI reference](https://ghaym.me/en/docs/cli) ## Deploying - **A push deploys.** A push to the branch a service tracks builds and deploys it, in every environment that tracks that branch. [Deploy from GitHub](https://ghaym.me/en/docs/deploy-from-github) - **A deploy has worked only when its build log says so.** A successful push only means Git accepted the commit. Read the log with `ghaym cloud deployments logs `. [Builds and deploys](https://ghaym.me/en/docs/builds) - **Listen on every address, on the port Ghaym sets.** Bind to `0.0.0.0`, not to localhost, and read the port from `PORT`. An app bound to localhost fails the readiness check, and its deploy fails. [Builds and deploys](https://ghaym.me/en/docs/builds) - **Set the project up from this repository:** `ghaym cloud git install` prints the link that installs the Ghaym GitHub App, `ghaym cloud projects create --name ` creates the project, and `ghaym cloud services create --project --type git --repo --size --site ` creates the service and starts its first deploy. `ghaym cloud regions list` names the sites. [Deploy your first service](https://ghaym.me/en/docs/getting-started) - **Try a change away from production:** `ghaym cloud environments create --project --name --branch `, then push to that branch. [Deploy a branch to its own environment](https://ghaym.me/en/docs/branch-environments) - **Undo a bad deploy:** `ghaym cloud deployments rollback `. Ghaym puts that deploy's image live again without a build. [Roll back a deploy](https://ghaym.me/en/docs/rollback) ## Settings - **Variables live in Ghaym**, set with `ghaym cloud vars set`, not in a committed config file. [Set variables and secrets](https://ghaym.me/en/docs/variables) - **Every change is staged.** Variables, build settings, size, replicas, routing and access move only with `ghaym cloud changes apply`, or `--apply` on the same call. Applying a variable, a bucket connection, the branch or a build setting deploys the service. [Staged changes](https://ghaym.me/en/docs/staged-changes) - **Try a change first.** Every command that changes something takes `--dry-run`, and then changes nothing. `services create`, `domains add` and `sessions rollback` return the plan with its estimated monthly price. [CLI reference](https://ghaym.me/en/docs/cli) ## When a command stops - **Wait for a person to approve:** a command that needs approval exits with `6` and an approval id. Run `ghaym cloud approvals wait ` instead of retrying. [Supervise a coding agent](https://ghaym.me/en/docs/agent-approvals) - **Branch on the exit code, not on the message.** [Exit codes](https://ghaym.me/en/docs/cli#exit-codes) - **Follow the error's page.** Every error is a JSON document in RFC 9457 format, and its `docs` link points to the page for its `type`. [API errors](https://ghaym.me/en/docs/errors) - **Check what happened:** `ghaym cloud audit list` and `ghaym cloud sessions list`, with `--json`. [See who changed what](https://ghaym.me/en/docs/activity) ## The HTTP API A call to the API signs in with an access token traded for the key: ```sh curl -sX POST https://auth.api.ghaym.me/v1/auth/token -H "Authorization: Bearer $GHAYM_TOKEN" ``` The access token is short-lived, and it can't be refreshed. A key can never do more than its owner. [API keys and scopes](https://ghaym.me/en/docs/api-keys) ## Cost - **Prices depend on the site.** Read them with `ghaym cloud regions sizes `. [Limits and prices](https://ghaym.me/en/docs/limits-and-prices) - **Polling keeps a service awake.** Services outside production sleep when idle, and compute is charged only while a service is awake. [Sleep and wake](https://ghaym.me/en/docs/sleep) - **Outgoing traffic past the monthly allowance is charged.** [Limits and prices](https://ghaym.me/en/docs/limits-and-prices) ## Pages to read - [API errors](https://ghaym.me/en/docs/errors): one page per API error type. - [Get a repo ready with an agent](https://ghaym.me/en/docs/verified-prompts): prompts that get an existing repository ready to deploy. - [Agent files](https://ghaym.me/en/docs/harness): this file, and its forms for Claude Code and Cursor. - [llms.txt](https://ghaym.me/llms.txt): the site index in llms.txt format. - Every page under https://ghaym.me/en/docs is also served as Markdown: drop `/en`, add `.md` to the path and `?lng=en`, for example https://ghaym.me/docs/agents.md?lng=en. - Pages are in English under `/en`. A Markdown file without `?lng=en` is in Arabic. ```` ## CLAUDE.md الإرشادات نفسها في الملف الذي يقرؤه Claude Code في بداية كل جلسة. أضفه إلى ملف CLAUDE.md الذي لديك بدلا من أن تستبدل به ملفك. ```sh curl -sL https://ghaym.me/integrations/ghaym.claude.md >> CLAUDE.md ``` ````markdown CLAUDE.md # Deploying this repository to Ghaym Cloud Add this to your project's `CLAUDE.md`, fill in the bracketed values, and delete what doesn't apply. It is the same guidance as https://ghaym.me/agents.md, in the file Claude Code reads every session. Each rule links the page of the Ghaym Cloud docs that explains it; read that page before acting on the rule. Canonical version: https://ghaym.me/integrations/ghaym.claude.md ## This project - Production branch: `[main]` - Service name in Ghaym: `[web]` - Environment: `[production]` ## Before you start - **Sign-up needs a person.** Deploying opens once Ghaym approves the account. If there is no account, say so and stop. [Set up a coding agent](https://ghaym.me/en/docs/agents) - **Use the CLI, not hand-written API calls.** [Install the CLI and sign in](https://ghaym.me/en/docs/install-the-cli) - **Sign in through me.** The CLI uses the login of whoever runs it. If `ghaym whoami` fails, ask me to run `ghaym login` in my own terminal; never ask me to paste a key into this chat. [Set up a coding agent](https://ghaym.me/en/docs/agents) - **Learn every command and flag** in one call with `ghaym help all --json`. [CLI reference](https://ghaym.me/en/docs/cli) ## Deploying - **A push deploys.** A push to the branch a service tracks builds and deploys it, in every environment that tracks that branch. [Deploy from GitHub](https://ghaym.me/en/docs/deploy-from-github) - **A deploy has worked only when its build log says so.** A successful push only means Git accepted the commit. Read the log with `ghaym cloud deployments logs `. [Builds and deploys](https://ghaym.me/en/docs/builds) - **Listen on every address, on the port Ghaym sets.** Bind to `0.0.0.0`, not to localhost, and read the port from `PORT`. An app bound to localhost fails the readiness check, and its deploy fails. [Builds and deploys](https://ghaym.me/en/docs/builds) - **Set the project up from this repository:** `ghaym cloud git install` prints the link that installs the Ghaym GitHub App, `ghaym cloud projects create --name ` creates the project, and `ghaym cloud services create --project --type git --repo --size --site ` creates the service and starts its first deploy. `ghaym cloud regions list` names the sites. [Deploy your first service](https://ghaym.me/en/docs/getting-started) - **Try a change away from production:** `ghaym cloud environments create --project --name --branch `, then push to that branch. [Deploy a branch to its own environment](https://ghaym.me/en/docs/branch-environments) - **Undo a bad deploy:** `ghaym cloud deployments rollback `. Ghaym puts that deploy's image live again without a build. [Roll back a deploy](https://ghaym.me/en/docs/rollback) ## Settings - **Variables live in Ghaym**, set with `ghaym cloud vars set`, not in a committed config file. [Set variables and secrets](https://ghaym.me/en/docs/variables) - **Every change is staged.** Variables, build settings, size, replicas, routing and access move only with `ghaym cloud changes apply`, or `--apply` on the same call. Applying a variable, a bucket connection, the branch or a build setting deploys the service. [Staged changes](https://ghaym.me/en/docs/staged-changes) - **Try a change first.** Every command that changes something takes `--dry-run`, and then changes nothing. `services create`, `domains add` and `sessions rollback` return the plan with its estimated monthly price. [CLI reference](https://ghaym.me/en/docs/cli) ## When a command stops - **Wait for me to approve:** a command that needs approval exits with `6` and an approval id. Run `ghaym cloud approvals wait ` instead of retrying. [Supervise a coding agent](https://ghaym.me/en/docs/agent-approvals) - **Branch on the exit code, not on the message.** [Exit codes](https://ghaym.me/en/docs/cli#exit-codes) - **Follow the error's page.** Every error is a JSON document in RFC 9457 format, and its `docs` link points to the page for its `type`. [API errors](https://ghaym.me/en/docs/errors) ## The HTTP API A call to the API signs in with an access token traded for the key: ```sh curl -sX POST https://auth.api.ghaym.me/v1/auth/token -H "Authorization: Bearer $GHAYM_TOKEN" ``` The access token is short-lived, and it can't be refreshed. A key can never do more than its owner. [API keys and scopes](https://ghaym.me/en/docs/api-keys) ## Cost - **Prices depend on the site.** Read them with `ghaym cloud regions sizes `. [Limits and prices](https://ghaym.me/en/docs/limits-and-prices) - **Polling keeps a service awake.** Services outside production sleep when idle, and compute is charged only while a service is awake. [Sleep and wake](https://ghaym.me/en/docs/sleep) - **Outgoing traffic past the monthly allowance is charged.** [Limits and prices](https://ghaym.me/en/docs/limits-and-prices) Every page under https://ghaym.me/en/docs is also served as Markdown: drop `/en`, add `.md` to the path and `?lng=en`. ```` ## قواعد Cursor قاعدة Cursor مع frontmatter تنطبق على المشروع كله. المحتوى نفسه، مختصرا للصيغة التي يقرؤها Cursor. ```sh curl -sL --create-dirs https://ghaym.me/integrations/ghaym.cursor.mdc -o .cursor/rules/ghaym.mdc ``` ````markdown .cursor/rules/ghaym.mdc --- description: How this repository deploys to Ghaym Cloud, with a link to the docs page for each rule. globs: alwaysApply: true --- # Ghaym Cloud Save as `.cursor/rules/ghaym.mdc`. Canonical version: https://ghaym.me/integrations/ghaym.cursor.mdc This repository deploys to Ghaym Cloud. Each rule links the page of the docs that explains it; read that page before acting on the rule. - Production branch: `[main]` - Service name in Ghaym: `[web]` ## Rules - Sign-up needs a person. Deploying opens once Ghaym approves the account. If there is no account, say so and stop. [Set up a coding agent](https://ghaym.me/en/docs/agents) - Use the CLI, not hand-written API calls. [Install the CLI and sign in](https://ghaym.me/en/docs/install-the-cli) - The CLI uses the login of whoever runs it. If `ghaym whoami` fails, ask them to run `ghaym login` in their own terminal; never ask them to paste a key into the chat. [Set up a coding agent](https://ghaym.me/en/docs/agents) - Learn every command and flag with `ghaym help all --json`. [CLI reference](https://ghaym.me/en/docs/cli) - A push to the branch a service tracks builds and deploys it, in every environment that tracks that branch. [Deploy from GitHub](https://ghaym.me/en/docs/deploy-from-github) - A deploy has worked only when its build log says so: `ghaym cloud deployments logs `. [Builds and deploys](https://ghaym.me/en/docs/builds) - Listen on `0.0.0.0`, on the port in `PORT`. An app bound to localhost fails the readiness check, and its deploy fails. [Builds and deploys](https://ghaym.me/en/docs/builds) - Set the project up with `ghaym cloud git install`, then `ghaym cloud projects create --name `, then `ghaym cloud services create --project --type git --repo --size --site `. `ghaym cloud regions list` names the sites. [Deploy your first service](https://ghaym.me/en/docs/getting-started) - Try a change away from production with `ghaym cloud environments create --project --name --branch `, then push to that branch. [Deploy a branch to its own environment](https://ghaym.me/en/docs/branch-environments) - Undo a bad deploy with `ghaym cloud deployments rollback `. [Roll back a deploy](https://ghaym.me/en/docs/rollback) - Variables live in Ghaym, set with `ghaym cloud vars set`, not in a committed config file. [Set variables and secrets](https://ghaym.me/en/docs/variables) - Every change is staged, variables included, and moves only with `ghaym cloud changes apply`, or `--apply` on the same call. Applying a variable, a bucket connection, the branch or a build setting deploys the service. [Staged changes](https://ghaym.me/en/docs/staged-changes) - Try a change with `--dry-run` first: every command that changes something takes it and then changes nothing. [CLI reference](https://ghaym.me/en/docs/cli) - A command that needs approval exits with `6` and an approval id. Run `ghaym cloud approvals wait ` instead of retrying. [Supervise a coding agent](https://ghaym.me/en/docs/agent-approvals) - An API error's `docs` link points to the page for its `type`. Follow it before retrying. [API errors](https://ghaym.me/en/docs/errors) - Prices depend on the site. Read them with `ghaym cloud regions sizes `. [Limits and prices](https://ghaym.me/en/docs/limits-and-prices) - Polling keeps a service awake. Services outside production sleep when idle. [Sleep and wake](https://ghaym.me/en/docs/sleep) The HTTP API: [API keys and scopes](https://ghaym.me/en/docs/api-keys). ```` ## skill لـ Claude Code skill اسمه deploy-to-ghaym: مسار النشر، والفحوص الأربعة قبل أن تنشر، وكيف تقرأ خطأ الـ API. لا يحمل إلا عندما يكون العمل عن النشر، فلا بأس أن يكون أطول. ```sh curl -sL --create-dirs https://ghaym.me/integrations/ghaym-skill.md -o .claude/skills/deploy-to-ghaym/SKILL.md ``` ````markdown .claude/skills/deploy-to-ghaym/SKILL.md --- name: deploy-to-ghaym description: Deploy a repository to Ghaym Cloud. Use when the user asks to deploy, ship or release this project to Ghaym, to set it up for Ghaym, to find out why a Ghaym deploy failed, or to read an error the Ghaym API returned. Covers the four checks before a deploy, the deploy itself, and how to read an API error, each with a link to the docs page behind it. --- # Deploy to Ghaym Cloud Save as `.claude/skills/deploy-to-ghaym/SKILL.md` in the repository, or under `~/.claude/skills/` to have it everywhere. Canonical version: https://ghaym.me/integrations/ghaym-skill.md Each step links the page of the Ghaym Cloud docs that explains it; read that page before acting on the step. To learn every command and flag in one call: ```sh ghaym help all --json ``` ## Before you start Sign-up needs a person, and deploying opens once Ghaym approves the account. If the user has no account, say so and stop. [Set up a coding agent](https://ghaym.me/en/docs/agents) Use the CLI, not hand-written API calls. Never ask the user to paste a key into the conversation; if `ghaym whoami` fails, ask them to run `ghaym login` in their own terminal. [Set up a coding agent](https://ghaym.me/en/docs/agents) ## Check four things before deploying 1. **The app listens on every address, on the port Ghaym sets.** It binds to `0.0.0.0`, not to localhost, and reads the port from `PORT`. An app bound to localhost fails the readiness check. [Builds and deploys](https://ghaym.me/en/docs/builds) 2. **The repository builds.** Most languages are detected on their own; anything else needs a `Dockerfile`. [Builds and deploys](https://ghaym.me/en/docs/builds#how-the-image-is-built) 3. **No secret is in the repository.** No `.env` is committed and no key is about to be. Values belong in Ghaym, set with `ghaym cloud vars set`. [Set variables and secrets](https://ghaym.me/en/docs/variables) 4. **The branch you push is the one the service tracks.** Confirm it with the user; don't assume `main`. [Deploy from GitHub](https://ghaym.me/en/docs/deploy-from-github) ## Deploy 1. If the project doesn't exist yet, `ghaym cloud git install` prints the link that installs the Ghaym GitHub App, `ghaym cloud projects create --name ` creates the project, and `ghaym cloud services create --project --type git --repo --size --site ` creates the service and starts its first deploy. `ghaym cloud regions list` names the sites. [Deploy your first service](https://ghaym.me/en/docs/getting-started) 2. Push. A push to the branch a service tracks builds and deploys it, in every environment that tracks that branch. ```sh git push origin ``` [Deploy from GitHub](https://ghaym.me/en/docs/deploy-from-github) 3. Read the build log with `ghaym cloud deployments logs `. A successful push only means Git accepted the commit; the deploy has worked only when the build log says so. [Builds and deploys](https://ghaym.me/en/docs/builds) To try a change away from production, run `ghaym cloud environments create --project --name --branch `, then push to that branch. [Deploy a branch to its own environment](https://ghaym.me/en/docs/branch-environments) To undo a bad deploy, run `ghaym cloud deployments rollback `. Ghaym puts that deploy's image live again without a build. [Roll back a deploy](https://ghaym.me/en/docs/rollback) Every change is staged: variables, build settings, size, replicas, routing and access move only with `ghaym cloud changes apply`, or `--apply` on the same call. Applying a variable, a bucket connection, the branch or a build setting deploys the service. [Staged changes](https://ghaym.me/en/docs/staged-changes) Try a change first: every command that changes something takes `--dry-run`, and then changes nothing. [CLI reference](https://ghaym.me/en/docs/cli) A command that needs approval exits with `6` and an approval id. Run `ghaym cloud approvals wait ` instead of retrying. [Supervise a coding agent](https://ghaym.me/en/docs/agent-approvals) ## Read an API error Every error is a JSON document in RFC 9457 format. With `--json`, the CLI puts this document under `error`. [API errors](https://ghaym.me/en/docs/errors) - `type`: the error's name, such as `not-found`. Branch on it, not on the text. - `title`: a short English title for the type. - `status`: the HTTP status. - `detail`: what went wrong with this call, for a person to read. Show it to the user. - `docs`: the link to the type's page, with what causes the error and how to fix the call. Follow it before retrying. A call to the API signs in with an access token traded for the key. [API keys and scopes](https://ghaym.me/en/docs/api-keys) ## Cost - Prices depend on the site. Read them with `ghaym cloud regions sizes `. [Limits and prices](https://ghaym.me/en/docs/limits-and-prices) - Polling keeps a service awake. Services outside production sleep when idle, and compute is charged only while a service is awake. [Sleep and wake](https://ghaym.me/en/docs/sleep) ```` Source: https://ghaym.me/docs/glossary.md # المصطلحات ابحث عن الكلمات التي يستعملها الـ console والـ CLI والتوثيق، بالعربية والإنجليزية، لكي يفهم الناس والـ agents المعنى نفسه. ## الكلمات في ملف `AGENTS.md` الخاص بالـ CLI الكلمات العربية نفسها، فيقول الـ agent ما يقوله الـ console. | بالإنجليزية | بالعربية | المعنى | | --- | --- | --- | | workspace | مساحة العمل | المكان الذي يضم المشاريع والأعضاء. وفيه حساب الفاتورة. | | environment | البيئة | الإنتاج، أو بيئة branch، داخل المشروع. | | production | الإنتاج | البيئة التي يستعملها عملاؤك. لا تنام أبدا. واسمها في الكود `production`. | | production branch | branch الإنتاج | الـ branch الذي ينشر على الإنتاج. | | replica | نسخة | نسخة واحدة عاملة من خدمة web. | | writer / reader | الكاتب / القارئ | النسخة الأساسية من قاعدة البيانات، والنسخ التي تقرأ منها. | | readers | القراء | نسخ القراءة من قاعدة البيانات، كما يعرضها الـ console. | | country | الدولة | الدولة التي يقع فيها الموقع. | | site | الموقع | مركز بيانات واحد في دولة، تعمل فيه الخدمة. | | residency | مكان البيانات | كل خدمة وقاعدة بيانات ومخزن مع موقعه ودولته. | | changes | التغييرات | التغييرات المجهزة التي تنشرها البيئة دفعة واحدة. | | rollout | الطرح | نشر يستبدل النسخ واحدة تلو الأخرى. | | domain | النطاق | اسم ترد عليه الخدمة. | | custom domain | النطاق المخصص | نطاق تملكه، موجه إلى خدمة. | | bucket | المخزن | تخزين ملفات. | | Solo, Team | Solo، Team | الخطط. تبقى أسماؤها بالحروف اللاتينية. | Source: https://ghaym.me/docs/errors.md # أخطاء الـ API ابحث عن أي خطأ تعيده الـ API: ما معناه، وما سببه، وكيف تصلح النداء. ## ما يحمله كل رد خطأ يعود كل خطأ كمستند JSON بصيغة RFC 9457، وفيه هذه الحقول: | الحقل | المحتوى | |---|---| | `type` | اسم الخطأ، مثل `not-found`. وصفحته `/docs/errors/`. | | `title` | عنوان قصير بالإنجليزية للنوع. | | `status` | رقم الـ HTTP status. | | `detail` | ما الخطأ الذي وقع في هذا النداء، مكتوبا ليقرأه شخص. | | `requestId`، `timestamp` | أي نداء كان، ومتى. | | `path`، `method`، `instance` | النداء الذي فشل. والـ `instance` هو الـ method والمسار معا. | | `docs` | رابط صفحة النوع. | | `errors` | في خطأ التحقق، وفي أي خطأ 4xx آخر يستطيع تحديد الحقل الخاطئ، إدخال لكل حقل. | يضع الـ CLI هذا المستند تحت `error` في [مخرجات الـ JSON](/ar/docs/cli#مخرجات-json). ## الطلب والتحقق - [`validation-error`](/ar/docs/errors/validation-error) · Validation Failed · 400 - [`bad-request`](/ar/docs/errors/bad-request) · Bad Request · 400 - [`unprocessable-entity`](/ar/docs/errors/unprocessable-entity) · Unprocessable Entity · 422 - [`too-many-requests`](/ar/docs/errors/too-many-requests) · Too Many Requests · 429 - [`dry-run-unsupported`](/ar/docs/errors/dry-run-unsupported) · Dry Run Not Supported · 400 - [`backups-unsupported`](/ar/docs/errors/backups-unsupported) · Backups Not Supported · 422 - [`bucket-object-too-large`](/ar/docs/errors/bucket-object-too-large) · Bucket Object Too Large · 400 - [`bucket-upload-invalid`](/ar/docs/errors/bucket-upload-invalid) · Bucket Upload Invalid · 400 - [`bucket-across-sites`](/ar/docs/errors/bucket-across-sites) · Bucket Across Sites · 422 - [`not-a-database`](/ar/docs/errors/not-a-database) · Not A Database · 422 - [`metrics-window-out-of-range`](/ar/docs/errors/metrics-window-out-of-range) · Metrics Window Out Of Range · 400 - [`deploy-rate-limit-exceeded`](/ar/docs/errors/deploy-rate-limit-exceeded) · Deploy Rate Limit Exceeded · 429 - [`reserved-slug`](/ar/docs/errors/reserved-slug) · Reserved Slug · 400 - [`host-not-gated`](/ar/docs/errors/host-not-gated) · This address does not ask visitors to sign in. · 400 - [`plan-not-self-selectable`](/ar/docs/errors/plan-not-self-selectable) · Plan Not Self Selectable · 403 - [`month-out-of-range`](/ar/docs/errors/month-out-of-range) · Month Out Of Range · 400 - [`workspace-header-required`](/ar/docs/errors/workspace-header-required) · Workspace Header Required · 400 - [`test-email-throttled`](/ar/docs/errors/test-email-throttled) · Test Email Throttled · 429 ## الدخول والصلاحيات يسجل النداء الدخول بـ access token تحصل عليه مقابل [مفتاح API](/ar/docs/api-keys). - [`unauthorized`](/ar/docs/errors/unauthorized) · Authentication Required · 401 - [`invalid-token`](/ar/docs/errors/invalid-token) · Invalid Token · 401 - [`forbidden`](/ar/docs/errors/forbidden) · Access Forbidden · 403 - [`insufficient-permission`](/ar/docs/errors/insufficient-permission) · Insufficient Permission · 403 - [`approval-required`](/ar/docs/errors/approval-required) · Approval Required · 202 - [`untrusted-origin`](/ar/docs/errors/untrusted-origin) · Untrusted Origin · 403 - [`database-connect-forbidden`](/ar/docs/errors/database-connect-forbidden) · Cannot Connect To Databases · 403 - [`installation-not-held`](/ar/docs/errors/installation-not-held) · Installation Not Held · 403 - [`forbidden-access`](/ar/docs/errors/forbidden-access) · Access Denied · 403 - [`invalid-access-code`](/ar/docs/errors/invalid-access-code) · The sign-in code is invalid or has expired. · 400 - [`agent-cannot-approve`](/ar/docs/errors/agent-cannot-approve) · Agent Cannot Approve · 403 - [`approval-only-initiator-may-decide`](/ar/docs/errors/approval-only-initiator-may-decide) · Only The Initiator May Decide · 403 - [`api-key-revoked`](/ar/docs/errors/api-key-revoked) · API Key Revoked · 401 ## موارد غير موجودة - [`not-found`](/ar/docs/errors/not-found) · Resource Not Found · 404 - [`resource-not-found`](/ar/docs/errors/resource-not-found) · Resource Not Found · 404 - [`project-not-found`](/ar/docs/errors/project-not-found) · Project Not Found · 404 - [`environment-not-found`](/ar/docs/errors/environment-not-found) · Environment Not Found · 404 - [`service-not-found`](/ar/docs/errors/service-not-found) · Service Not Found · 404 - [`serviceenvironment-not-found`](/ar/docs/errors/serviceenvironment-not-found) · ServiceEnvironment Not Found · 404 - [`deployment-not-found`](/ar/docs/errors/deployment-not-found) · Deployment Not Found · 404 - [`domain-not-found`](/ar/docs/errors/domain-not-found) · Domain Not Found · 404 - [`changeset-not-found`](/ar/docs/errors/changeset-not-found) · Changeset Not Found · 404 - [`instance-not-found`](/ar/docs/errors/instance-not-found) · Instance Not Found · 404 - [`installation-not-found`](/ar/docs/errors/installation-not-found) · Installation Not Found · 404 - [`repository-not-found`](/ar/docs/errors/repository-not-found) · Repository Not Found · 404 - [`region-not-found`](/ar/docs/errors/region-not-found) · Region Not Found · 404 - [`plan-not-found`](/ar/docs/errors/plan-not-found) · Plan Not Found · 404 - [`instance-size-not-found`](/ar/docs/errors/instance-size-not-found) · Instance size Not Found · 404 - [`billing-plan-not-found`](/ar/docs/errors/billing-plan-not-found) · Billing plan Not Found · 404 - [`billing-account-not-found`](/ar/docs/errors/billing-account-not-found) · Billing account Not Found · 404 - [`invoice-not-found`](/ar/docs/errors/invoice-not-found) · Invoice Not Found · 404 - [`offering-not-found`](/ar/docs/errors/offering-not-found) · Offering Not Found · 404 - [`abuse-report-not-found`](/ar/docs/errors/abuse-report-not-found) · Abuse report Not Found · 404 - [`agentsession-not-found`](/ar/docs/errors/agentsession-not-found) · AgentSession Not Found · 404 - [`approval-not-found`](/ar/docs/errors/approval-not-found) · Approval Not Found · 404 - [`backup-not-found`](/ar/docs/errors/backup-not-found) · Backup Not Found · 404 - [`bucket-not-found`](/ar/docs/errors/bucket-not-found) · Bucket Not Found · 404 - [`bucketconnection-not-found`](/ar/docs/errors/bucketconnection-not-found) · BucketConnection Not Found · 404 - [`database-size-not-found`](/ar/docs/errors/database-size-not-found) · Database size Not Found · 404 - [`invite-not-found`](/ar/docs/errors/invite-not-found) · Invite Not Found · 404 - [`member-not-found`](/ar/docs/errors/member-not-found) · Member Not Found · 404 - [`provider-not-found`](/ar/docs/errors/provider-not-found) · Provider Not Found · 404 - [`restore-not-found`](/ar/docs/errors/restore-not-found) · Restore Not Found · 404 - [`service-environment-not-found`](/ar/docs/errors/service-environment-not-found) · Service environment Not Found · 404 - [`slot-not-found`](/ar/docs/errors/slot-not-found) · Slot Not Found · 404 - [`tunnel-not-found`](/ar/docs/errors/tunnel-not-found) · Tunnel Not Found · 404 - [`upload-batch-not-found`](/ar/docs/errors/upload-batch-not-found) · Upload batch Not Found · 404 - [`user-not-found`](/ar/docs/errors/user-not-found) · User Not Found · 404 - [`workspace-not-found`](/ar/docs/errors/workspace-not-found) · Workspace Not Found · 404 ## التكرار والتعارض - [`conflict`](/ar/docs/errors/conflict) · Resource Conflict · 409 - [`bucket-name-taken`](/ar/docs/errors/bucket-name-taken) · Bucket Name Taken · 409 - [`bucket-already-connected`](/ar/docs/errors/bucket-already-connected) · Bucket Already Connected · 409 - [`bucket-object-exists`](/ar/docs/errors/bucket-object-exists) · Bucket Object Exists · 409 - [`project-conflict`](/ar/docs/errors/project-conflict) · Project Conflict · 409 - [`environment-conflict`](/ar/docs/errors/environment-conflict) · Environment Conflict · 409 - [`service-conflict`](/ar/docs/errors/service-conflict) · Service Conflict · 409 - [`domain-conflict`](/ar/docs/errors/domain-conflict) · Domain Conflict · 409 - [`envvar-conflict`](/ar/docs/errors/envvar-conflict) · EnvVar Conflict · 409 - [`offering-conflict`](/ar/docs/errors/offering-conflict) · Offering Conflict · 409 - [`instance-size-conflict`](/ar/docs/errors/instance-size-conflict) · Instance size Conflict · 409 - [`provider-conflict`](/ar/docs/errors/provider-conflict) · Provider Conflict · 409 ## حالة الموارد والاتصالات - [`invalid-deployment-state-transition`](/ar/docs/errors/invalid-deployment-state-transition) · Invalid Deployment State Transition · 409 - [`invalid-instance-state-transition`](/ar/docs/errors/invalid-instance-state-transition) · Invalid Instance State Transition · 409 - [`instance-quota-exceeded`](/ar/docs/errors/instance-quota-exceeded) · Instance Quota Exceeded · 403 - [`invalid-repo-url`](/ar/docs/errors/invalid-repo-url) · Invalid Repository URL · 400 - [`repo-unavailable`](/ar/docs/errors/repo-unavailable) · Repository Unavailable · 502 - [`invalid-installation-state`](/ar/docs/errors/invalid-installation-state) · Invalid Installation State · 401 - [`installation-revoked`](/ar/docs/errors/installation-revoked) · Installation Revoked · 410 - [`backups-disabled`](/ar/docs/errors/backups-disabled) · Backups Are Off · 422 - [`backup-in-flight`](/ar/docs/errors/backup-in-flight) · Backup Already Running · 409 - [`backup-not-restorable`](/ar/docs/errors/backup-not-restorable) · Backup Not Restorable · 409 - [`backup-held-by-restore`](/ar/docs/errors/backup-held-by-restore) · Backup In Use · 409 - [`backup-engine-version-unsupported`](/ar/docs/errors/backup-engine-version-unsupported) · Engine Version No Longer Supported · 422 - [`bucket-not-ready`](/ar/docs/errors/bucket-not-ready) · Bucket Not Ready · 409 - [`bucket-provisioning`](/ar/docs/errors/bucket-provisioning) · Bucket Provisioning · 409 - [`bucket-key-missing`](/ar/docs/errors/bucket-key-missing) · Bucket Key Missing · 409 - [`bucket-suspended`](/ar/docs/errors/bucket-suspended) · Bucket Suspended · 409 - [`bucket-folder-deleting`](/ar/docs/errors/bucket-folder-deleting) · Bucket Folder Deleting · 409 - [`bucket-quota-reached`](/ar/docs/errors/bucket-quota-reached) · Bucket Quota Reached · 409 - [`bucket-upload-batch-closed`](/ar/docs/errors/bucket-upload-batch-closed) · Bucket Upload Batch Closed · 409 - [`bucket-upload-incomplete`](/ar/docs/errors/bucket-upload-incomplete) · Bucket Upload Incomplete · 409 - [`bucket-upload-not-open`](/ar/docs/errors/bucket-upload-not-open) · Bucket Upload Not Open · 409 - [`database-provisioning`](/ar/docs/errors/database-provisioning) · Database Provisioning · 409 - [`database-failed`](/ar/docs/errors/database-failed) · Database Failed To Provision · 409 - [`database-cap-blocked`](/ar/docs/errors/database-cap-blocked) · Plan Full · 402 - [`database-suspended`](/ar/docs/errors/database-suspended) · Database Suspended · 402 - [`database-stopped`](/ar/docs/errors/database-stopped) · Database Stopped · 409 - [`database-asleep`](/ar/docs/errors/database-asleep) · Database Asleep · 409 - [`tunnel-closed`](/ar/docs/errors/tunnel-closed) · Tunnel Closed · 410 - [`service-suspended`](/ar/docs/errors/service-suspended) · Service Suspended · 409 - [`provisioning-not-retryable`](/ar/docs/errors/provisioning-not-retryable) · Provisioning Not Retryable · 409 - [`exposure-ceiling-exceeded`](/ar/docs/errors/exposure-ceiling-exceeded) · Exposure Ceiling Exceeded · 402 - [`github-authorization-failed`](/ar/docs/errors/github-authorization-failed) · GitHub Authorization Failed · 400 - [`custom-domain-required`](/ar/docs/errors/custom-domain-required) · Connect a domain first to turn off the ghaym.app address. · 409 - [`ip-allowlist-while-private`](/ar/docs/errors/ip-allowlist-while-private) · The IP list has no effect while the service is private. Undo private first. · 409 - [`last-domain-custom-only`](/ar/docs/errors/last-domain-custom-only) · This is the last live domain here, and the ghaym.app address is off. Turn it on first. · 409 - [`approval-not-pending`](/ar/docs/errors/approval-not-pending) · Approval Not Pending · 409 - [`approval-operation-unknown`](/ar/docs/errors/approval-operation-unknown) · Approval Operation Unknown · 422 - [`plan-limit-exceeded`](/ar/docs/errors/plan-limit-exceeded) · Plan Limit Exceeded · 402 - [`plan-compute-cap-exceeded`](/ar/docs/errors/plan-compute-cap-exceeded) · Plan Compute Cap Exceeded · 402 - [`abuse-report-not-pending`](/ar/docs/errors/abuse-report-not-pending) · Abuse Report Already Decided · 409 - [`not-abuse-suspended`](/ar/docs/errors/not-abuse-suspended) · Not Abuse-Suspended · 409 - [`account-suspended`](/ar/docs/errors/account-suspended) · Account Suspended · 402 - [`account-not-approved`](/ar/docs/errors/account-not-approved) · Account Not Approved · 403 - [`phone-not-verified`](/ar/docs/errors/phone-not-verified) · Phone Not Verified · 402 - [`account-standing`](/ar/docs/errors/account-standing) · Account Not In Good Standing · 402 - [`card-required`](/ar/docs/errors/card-required) · Card Required · 402 - [`usage-limit-exceeded`](/ar/docs/errors/usage-limit-exceeded) · Usage Limit Exceeded · 402 - [`budget-cap-exceeded`](/ar/docs/errors/budget-cap-exceeded) · Budget Cap Exceeded · 402 - [`plan-size-not-allowed`](/ar/docs/errors/plan-size-not-allowed) · Plan Size Not Allowed · 402 - [`workspace-has-services`](/ar/docs/errors/workspace-has-services) · Workspace Still Has Services · 409 - [`workspace-last-undeletable`](/ar/docs/errors/workspace-last-undeletable) · Last Workspace Cannot Be Deleted · 409 ## الـ Idempotency - [`invalid-idempotency-key`](/ar/docs/errors/invalid-idempotency-key) · Invalid Idempotency Key · 400 - [`idempotency-key-in-flight`](/ar/docs/errors/idempotency-key-in-flight) · Idempotent Request In Flight · 409 - [`idempotency-key-reused`](/ar/docs/errors/idempotency-key-reused) · Idempotency Key Reused · 422 ## أعطال لدينا أو لدى غيرنا - [`internal-error`](/ar/docs/errors/internal-error) · Internal Server Error · 500 - [`bad-gateway`](/ar/docs/errors/bad-gateway) · Bad Gateway · 502 - [`service-unavailable`](/ar/docs/errors/service-unavailable) · Service Unavailable · 503 - [`auth-unavailable`](/ar/docs/errors/auth-unavailable) · Identity Service Unavailable · 503 - [`auth-directory-unavailable`](/ar/docs/errors/auth-directory-unavailable) · Identity Service Unavailable · 503 - [`gateway-timeout`](/ar/docs/errors/gateway-timeout) · Gateway Timeout · 504 - [`error`](/ar/docs/errors/error) · Error · 405 - [`bucket-object-delete-failed`](/ar/docs/errors/bucket-object-delete-failed) · Bucket Object Delete Failed · 502 - [`tunnels-unavailable`](/ar/docs/errors/tunnels-unavailable) · Tunnels Unavailable · 503 - [`database-not-ready`](/ar/docs/errors/database-not-ready) · Database Not Ready · 503 - [`region-capacity-exhausted`](/ar/docs/errors/region-capacity-exhausted) · Region Capacity Exhausted · 503 - [`region-briefly-full`](/ar/docs/errors/region-briefly-full) · Region Briefly Full · 503 - [`logs-store-unavailable`](/ar/docs/errors/logs-store-unavailable) · Log Store Unavailable · 503 - [`no-backup-destination`](/ar/docs/errors/no-backup-destination) · Backups Unavailable · 409 - [`backup-purge-failed`](/ar/docs/errors/backup-purge-failed) · Backup Not Deleted · 502 - [`github-connect-unconfigured`](/ar/docs/errors/github-connect-unconfigured) · GitHub Connect Unconfigured · 503 - [`access-control-not-enabled`](/ar/docs/errors/access-control-not-enabled) · Access Control Not Enabled · 404 - [`billing-not-enabled`](/ar/docs/errors/billing-not-enabled) · Billing Not Enabled · 503 - [`billing-service-unavailable`](/ar/docs/errors/billing-service-unavailable) · Billing Service Unavailable · 503 - [`mail-transport-failed`](/ar/docs/errors/mail-transport-failed) · Mail Transport Failed · 503 Source: https://ghaym.me/docs/errors/validation-error.md # Validation Failed لم يجتز الطلب التحقق قبل تنفيذ أي شيء، فلم يكتب أي شيء. في `errors[]` عنصر لكل حقل لم ينجح، وكلها دفعة واحدة. عندما ترفضه فحوص الجسم نفسها، يكون الـ `detail` الجملة نفسها دائما، والتفاصيل في `errors[]`. ونطاق السجلات المخصص الذي ليس نطاقا صحيحا يعيد النوع نفسه، لكن الحل في `detail` ولا يوجد `errors[]`. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `errors`. ## الأسباب الشائعة - حقل فيه قيمة من نوع خاطئ، مثل نص مكان رقم أو object. - قيمة خارج مجموعة محددة، مثل `type` للخدمة غير `git` أو `database` أو `cache` أو `postgres` أو `mysql` أو `redis`. - حقل مطلوب ناقص، أو في الجسم حقل لا تعرفه الـ API. الحقل غير المعروف يرفض ولا يتجاهل، فالاسم المكتوب خطأ يفشل هنا. - قائمة الـ IP المسموحة فيها عناوين لا تصلح. لكل عنوان عنصر خاص به، مثل `ip_allowlist[2]`، ولا يسجل أي شيء. ## كيف تصلح الطلب - اقرأ `errors[]` لا `detail`. في كل عنصر `field`، وهو مسار بالنقاط داخل الجسم (`entries.0.kind` هو الـ `kind` لأول عنصر في `entries`)، ومعه `message` والقيمة `value` التي أرسلتها. - عندما يكون للحقل قيم محددة، يحمل عنصره `allowedValues`. أرسل واحدة منها كما هي مكتوبة تماما. - أصلح كل العناصر قبل أن تعيد المحاولة. المحاولة التي تصلح العنصر الأول فقط ستفشل في الباقي. - عندما لا يوجد `errors[]`، يخبرك الـ `detail` بما تغيره. - لا ترسل الجسم نفسه مرة أخرى، فلا شيء فيه سينجح لاحقا. ## مثال على الرد ```json { "type": "validation-error", "title": "Validation Failed", "status": 400, "detail": "One or more validation errors occurred", "errors": [ { "field": "type", "message": "type must be one of the following values: git, database, cache, postgres, mysql, redis", "value": "worker", "constraints": [ "isIn" ], "allowedValues": [ "git", "database", "cache", "postgres", "mysql", "redis" ] }, { "field": "name", "message": "name must be lowercase letters, digits, and single hyphens", "value": "My App", "constraints": [ "matches" ] } ], "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "docs": "https://ghaym.me/docs/errors/validation-error" } ``` Source: https://ghaym.me/docs/errors/bad-request.md # Bad Request رفضت الـ API الطلب بسبب قاعدة لا تستطيع فحوص الحقول التعبير عنها، والـ `detail` يسمي القاعدة. وعلى عكس [validation-error](/ar/docs/errors/validation-error)، لا يحمل `errors[]`: الشرح في `detail`. ويضيف الرفض لإطلاق لم يسم موقعا `openSites`، وهي المواقع المفتوحة للخدمات الجديدة. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - معرفان يجب أن ينتميا معا وهما ليسا كذلك، مثل بيئة من مشروع غير مشروع الخدمة. - لا تنطبق العملية على هذا النوع من الخدمات: خدمات الـ web وحدها تنشر وتأخذ domain خاصا. - معرف في الـ path غير سليم. يجب أن يكون UUID v7، أو slug عندما يقبل المسار slug. - إطلاق كان سينشئ خدمة دون أن يسمي موقعا، ولا شيء يختار لها واحدا. ## كيف تصلح الطلب - اقرأ `detail`. فهو مكتوب لهذه الحالة بالذات، ويسمي القاعدة التي خرقت. - عند `site_required`، مرر `--site` مع واحد من `openSites`. وعندما تكون `openSites` فارغة، يقول `detail`: `No site is open.` - تأكد أن كل معرف في الطلب ينتمي إلى المشروع نفسه. - لا تعد المحاولة دون تغيير، فالطلب نفسه سيرفض مرة أخرى. ## مثال على الرد ```json { "type": "bad-request", "title": "Bad Request", "status": 400, "detail": "Environment belongs to a different project", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "docs": "https://ghaym.me/docs/errors/bad-request" } ``` Source: https://ghaym.me/docs/errors/unprocessable-entity.md # Unprocessable Entity ترسل الـ API هذا النوع عندما يشير مرجع إلى خدمة أو قاعدة بيانات في موقع آخر. يُرفض المرجع بـ `code: reference_across_sites`، وحقوله تسمي طرفيه: `service` و`serviceSite` للخدمة التي تحمل المرجع، و`target` و`targetSite` للخدمة التي يسميها. والـ 422 الذي ترسله الـ API فعلا هو [idempotency-key-reused](/ar/docs/errors/idempotency-key-reused). لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - مرجع `${{Service.VAR}}` يسمي خدمة أو قاعدة بيانات في موقع آخر. ## كيف تصلح الطلب - اقرأ `targetSite` و`serviceSite`. المرجع يعمل داخل موقع واحد فقط، فوجهه إلى خدمة أو قاعدة بيانات في الموقع نفسه. - للوصول إلى خدمة web في موقع آخر، ضع رابطها العام، لا مرجعا. - لا تعد المحاولة دون تغيير، فالمرجع نفسه سيرفض مرة أخرى. ## مثال على الرد ```json { "type": "unprocessable-entity", "title": "Unprocessable Entity", "status": 422, "detail": "The request could not be processed", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "docs": "https://ghaym.me/docs/errors/unprocessable-entity" } ``` Source: https://ghaym.me/docs/errors/too-many-requests.md # Too Many Requests أرسل صاحب النداء إلى هذا المسار طلبات أكثر مما تسمح به نافذته، فرفضت الـ API هذا الطلب دون أن تنفذه. كل مسار يعد الطلبات من كل عنوان IP للعميل على حدة: 100 في الدقيقة عادة. ويستحق إعادة المحاولة، بعد الانتظار الذي يسميه الجواب. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - حلقة استعلام دون تأخير بين دورة وأخرى. - حلقة إعادة محاولة تعد كل فشل قابلا للإعادة، فتتسارع حتى تبلغ الحد. - عدة workers خلف عنوان IP واحد ينادون المسار نفسه. ## كيف تصلح الطلب - انتظر عدد الثواني الذي في الـ header `Retry-After`، ثم أعد المحاولة. - ضع تأخيرا في كل حلقة استعلام، وأطله عندما لا يتغير الجواب. - وزع العمل المتوازي على وقت أطول بدل أن ترسله كله دفعة واحدة. ## مثال على الرد ```json { "type": "too-many-requests", "title": "Too Many Requests", "status": 429, "detail": "ThrottlerException: Too Many Requests", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects", "method": "GET", "instance": "GET /v1/projects", "docs": "https://ghaym.me/docs/errors/too-many-requests" } ``` Source: https://ghaym.me/docs/errors/dry-run-unsupported.md # Dry Run Not Supported طلب النداء dry run على مسار لا يستطيع التخطيط له، فرفضته الـ API بدل أن تجري التغيير فعلا. الـ `supportedRoutes` يعدد المسارات التي ترد على dry run؛ و `POST /v1/agent-sessions//rollback` يقبل واحدا أيضا، مع أن القائمة لا تذكره. والـ `dryRun=false`، أو أي قيمة غير `true` أو `1` أو عدم وجود قيمة، لا يطلب dry run، وينفذ النداء فعلا. ولا فرق بين الأحرف الكبيرة والصغيرة: `dryRun=TRUE` هو dry run أيضا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `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" } ``` Source: https://ghaym.me/docs/errors/backups-unsupported.md # Backups Not Supported النسخ الاحتياطية لا تغطي إلا قواعد PostgreSQL و MySQL المدارة، وهذه الخدمة شيء آخر، فلم تأخذ الـ API نسخة. قراءة النسخ الاحتياطية لخدمة لا تعيد هذا الخطأ أبدا: الـ `supported` في الجواب يبين إن كانت النسخ تغطي الخدمة. والـ `serviceId` يسمي الخدمة التي رفضت. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `serviceId`. ## الأسباب الشائعة - الخدمة web service. - الخدمة كاش Redis، والنسخ الاحتياطية لا تغطي الكاش. - سمى النداء الخدمة الخطأ: الـ `serviceId` هو ما وصله. ## كيف تصلح الطلب - اقرأ `supported` من `GET /v1/services//backups` قبل أن تعرض نسخة احتياطية. - وإذا كان المقصود قاعدة PostgreSQL أو MySQL، فأرسل الـ id الخاص بها. - لا تعد المحاولة: نوع الخدمة لا يتغير. ## مثال على الرد ```json { "type": "backups-unsupported", "title": "Backups Not Supported", "detail": "Backups cover managed PostgreSQL and MySQL databases only.", "serviceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups", "status": 422, "docs": "https://ghaym.me/docs/errors/backups-unsupported" } ``` Source: https://ghaym.me/docs/errors/bucket-object-too-large.md # Bucket Object Too Large الملف أكبر من الـ 5 GiB التي تقبلها مسارات الرفع، فلم توقع الـ API له شيئا. هذه من مسارات الرفع التي يناديها متصفح الملفات في الـ console؛ أما التطبيق الذي يكتب بمفاتيح S3 الخاصة به فيتعامل مع المخزن مباشرة ولا يراها. والـ `sizeBytes` هو الحجم الذي أرسله النداء، و `maxBytes` أكبر حجم للملف، وكلاهما بالـ bytes. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `key`، `sizeBytes` و `maxBytes`. ## الأسباب الشائعة - الملف أكبر من 5 GiB، مثل صورة قرص أو أرشيف كبير. - أرسل النداء `sizeBytes` خطأ، مثل حجم بوحدة أخرى. ## كيف تصلح الطلب - قسم الملف إلى قطع أصغر من 5 GiB، أو اضغطه، ثم ارفع كل قطعة. - تأكد أن `sizeBytes` هو حجم الملف بالـ bytes. ## مثال على الرد ```json { "type": "bucket-object-too-large", "title": "Bucket Object Too Large", "detail": "'backups/site.tar' is 6442450944 bytes; the most per file is 5368709120", "code": "BUCKET_OBJECT_TOO_LARGE", "key": "backups/site.tar", "sizeBytes": 6442450944, "maxBytes": 5368709120, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads", "method": "POST", "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads", "status": 400, "docs": "https://ghaym.me/docs/errors/bucket-object-too-large" } ``` Source: https://ghaym.me/docs/errors/bucket-upload-invalid.md # Bucket Upload Invalid الرفع يسمي key أو جزءا لا تقبله الدفعة، فلم توقع الـ API شيئا. هذه من مسارات الرفع التي يناديها متصفح الملفات في الـ console؛ أما التطبيق الذي يكتب بمفاتيح S3 الخاصة به فيتعامل مع المخزن مباشرة ولا يراها. والـ `reason` يبين أيها: `outside-prefix` أو `folder-key` أو `part-out-of-range`. وكل واحد منها خطأ في الكود الذي ينادي، وليس حالة في المخزن. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `key` و `reason`. ## الأسباب الشائعة - `outside-prefix`: الـ key ليس تحت المجلد الذي فتحت الدفعة له. - `folder-key`: الـ key ينتهي بـ `/`، وهذا يسمي مجلدا وليس ملفا. - `part-out-of-range`: رقم الجزء بعد آخر جزء في الملف، حسب الحجم الذي أرسل عند توقيع الملف. ## كيف تصلح الطلب - ارفع key تحت مجلد الدفعة، أو افتح دفعة للمجلد الذي فيه الـ key. - أزل keys المجلدات: المجلد يبقى موجودا ما دام فيه ملفات. - احسب عدد الأجزاء من حجم الملف، كل جزء 16 MiB. ## مثال على الرد ```json { "type": "bucket-upload-invalid", "title": "Bucket Upload Invalid", "detail": "Cannot upload 'images/logo.png': outside-prefix", "code": "BUCKET_UPLOAD_INVALID", "key": "images/logo.png", "reason": "outside-prefix", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads", "method": "POST", "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads", "status": 400, "docs": "https://ghaym.me/docs/errors/bucket-upload-invalid" } ``` Source: https://ghaym.me/docs/errors/bucket-across-sites.md # Bucket Across Sites المخزن والخدمة في موقعين مختلفين، فرفضت الـ API التغيير. المخزن يربط بخدمة في موقعه وحده. و `detail` يسمي المخزن والخدمة، ولكل منهما موقعه. والـ API تتحقق من المواقع مرة أخرى عند التطبيق، فقد يأتي الرفض عنده أيضا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `service`، `serviceSite`، `target` و `targetSite`. ## الأسباب الشائعة - المخزن في موقع غير موقع الخدمة. - متغير يشير إلى مفتاح المخزن، محفوظ على خدمة في موقع آخر، يأخذ الرفض نفسه. ## كيف تصلح الطلب - اربط مخزنا في موقع الخدمة نفسه. ## مثال على الرد ```json { "type": "bucket-across-sites", "title": "Bucket Across Sites", "detail": "assets-sa is in riyadh-1 and web is in amman-1. A bucket connects only to a service in its own site.", "code": "bucket_across_sites", "service": "web", "serviceSite": "amman-1", "target": "assets-sa", "targetSite": "riyadh-1", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/entries", "method": "PUT", "instance": "PUT /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/entries", "status": 422, "docs": "https://ghaym.me/docs/errors/bucket-across-sites" } ``` Source: https://ghaym.me/docs/errors/not-a-database.md # Not A Database الخدمة المسماة هي web service، والـ tunnel لا يفتح إلا لقاعدة بيانات، فلم تفتح الـ API أي tunnel. الـ `service` هو اسم الخدمة. والـ CLI يطبع الرفض ويخرج بالرمز 2، مثل خطأ في طريقة الاستعمال. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `service`. ## الأسباب الشائعة - أعطي `ghaym cloud connect` اسم web service، مثل التطبيق بدل قاعدته. - توجد خدمتان اسماهما متقاربان، واختيرت الخاطئة منهما. ## كيف تصلح الطلب - شغل `ghaym cloud connect` باسم القاعدة: اعرض خدمات المشروع لتجدها. - ولكي تصل إلى الـ web service، استعمل عنوانها: الـ tunnel ليس لها. ## مثال على الرد ```json { "type": "not-a-database", "title": "Not A Database", "detail": "storefront is a web service. Tunnels open to databases only.", "service": "storefront", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 422, "docs": "https://ghaym.me/docs/errors/not-a-database" } ``` Source: https://ghaym.me/docs/errors/metrics-window-out-of-range.md # Metrics Window Out Of Range طلب مشغل من مسار مقاييس نافذة لا يقبلها، فلم تحسب الـ API شيئا. المقاييس يقرؤها مشغلو غيم عبر المسارات الإدارية. والنافذة عدد صحيح من الساعات أو الأيام، مثل `48h` أو `30d`، من ساعة حتى `maxWindowHours`، أي 8,760 ساعة أو 365 يوما. ودونها، يقرأ المسار `30d`. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `window` و `maxWindowHours`. ## الأسباب الشائعة - النافذة أطول من 365 يوما، مثل `400d`. - النافذة أقصر من ساعة، مثل `0h`. ## كيف تصلح الطلب - اطلب نافذة `365d` على الأكثر، بالـ `h` أو الـ `d`. - أزل النافذة لتقرأ آخر 30 يوما. ## مثال على الرد ```json { "type": "metrics-window-out-of-range", "title": "Metrics Window Out Of Range", "detail": "A window of '400d' is longer than the 8760h (365d) maximum this endpoint scans. Ask for a shorter window.", "window": "400d", "maxWindowHours": 8760, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/admin/metrics/one-shot-rate", "method": "GET", "instance": "GET /v1/admin/metrics/one-shot-rate", "status": 400, "docs": "https://ghaym.me/docs/errors/metrics-window-out-of-range" } ``` Source: https://ghaym.me/docs/errors/deploy-rate-limit-exceeded.md # Deploy Rate Limit Exceeded بدأ الـ workspace في النافذة المتحركة أقصى ما يسمح به الحد من الـ deployments، فلم تبدأ الـ API هذا الـ deployment. الحد 30 بداية في 60 دقيقة عادة، ويعد على كل الـ workspace مع أن الـ `detail` يقول لكل مستخدم. والـ `retryAt` هو الوقت الذي تخرج فيه أقدم بداية من العد وتفرغ مكانا، و `retryAfterSeconds` الانتظار حتى ذلك الوقت. والرجوع إلى deployment قديم لا يعد. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `limit`، `windowMinutes`، `retryAfterSeconds` و `retryAt`. ## الأسباب الشائعة - أجرى سكربت أو agent الـ deploy في حلقة، مثلا مع كل تغيير يحفظ. - أجرى عدة أعضاء أو مفاتيح deploy في الـ workspace نفسه داخل النافذة. ## كيف تصلح الطلب - انتظر حتى `retryAt`، ثم أجر deploy مرة واحدة. - اجمع التغييرات في deployments أقل بدل واحد لكل تغيير. - ولكي تعود إلى نسخة أقدم في هذه الأثناء، ارجع: `ghaym cloud deployments rollback ` لا يعد. ## مثال على الرد ```json { "type": "deploy-rate-limit-exceeded", "title": "Deploy Rate Limit Exceeded", "detail": "This account has started 30 deployments in the last 60 minutes, which is the per-user limit. Try again after 2026-07-28T09:49:05.000Z (about 1145 seconds).", "limit": 30, "windowMinutes": 60, "retryAfterSeconds": 1145, "retryAt": "2026-07-28T09:49:05.000Z", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "status": 429, "docs": "https://ghaym.me/docs/errors/deploy-rate-limit-exceeded" } ``` Source: https://ghaym.me/docs/errors/reserved-slug.md # Reserved Slug اسم الخدمة سينشئ عنوانا عاما فيه اسم غيم أو اسم ماركة معروفة، فلم تنشئ الـ API شيئا. اسم خدمة الويب، أو اسم الـ repo الخاص بها إذا لم يعط اسم، هو بداية عنوان ghaym.app الخاص بها. والـ `slug` هو الاسم المرفوض. ولا تفحص إلا الخدمات الجديدة، فتبقى الموجودة بأسمائها. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `slug`. ## الأسباب الشائعة - الاسم، عندما يقسم عند الشرطات، فيه كلمة `ghaym`. - الاسم يحتوي ماركة مثل `paypal` أو `whatsapp` في أي مكان منه. - لم يعط اسم، واسم الـ repo واحد من هذه. ## كيف تصلح الطلب - اختر اسما آخر، إذا وافق المستخدم، وأرسله عبر `--name`: `ghaym cloud services create --project --type --name `. - لا تعد الطلب نفسه، فالاسم نفسه يرفض في كل مرة. ## مثال على الرد ```json { "type": "reserved-slug", "title": "Reserved Slug", "detail": "\"paypal-login\" is a reserved name and cannot be used as a subdomain", "slug": "paypal-login", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 400, "docs": "https://ghaym.me/docs/errors/reserved-slug" } ``` Source: https://ghaym.me/docs/errors/host-not-gated.md # This address does not ask visitors to sign in. طلب من خطوة تسجيل الدخول أن ترسل رمزا إلى عنوان لا يطلب من زواره تسجيل الدخول، فلم ترسل أي رمز. متصفح الزائر يمر بهذه الخطوة بعد أن يسجل الدخول في غيم، وهو في طريقه إلى خدمة للأعضاء فقط. وهي لا تعطي رمزا لمرة واحدة إلا لعنوان مفتوح لخدمة مضبوطة للأعضاء فقط، فلا تستطيع أن ترسل أحدا إلى مكان آخر. والـ `host` هو العنوان الذي طلب. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `host`. ## الأسباب الشائعة - توقفت الخدمة عن طلب تسجيل الدخول، مثلا عبر `--no-members-only`، والزائر يسجل الدخول. - العنوان لا يخص أي خدمة على غيم، أو عدل الرابط يدويا. ## كيف تصلح الطلب - افتح عنوان الخدمة مرة أخرى: إذا كان ما زال يطلب تسجيل الدخول، يعود المتصفح من هذه الخطوة برمز جديد. - وإذا كان يجب أن تكون الخدمة للأعضاء فقط، فاضبطها كذلك عبر `ghaym cloud access set --members-only` وطبق ذلك. - لا تركب هذا الرابط يدويا: صفحة تسجيل الدخول الخاصة بالخدمة هي التي تنشئه. ## مثال على الرد ```json { "type": "host-not-gated", "title": "This address does not ask visitors to sign in.", "detail": "storefront-k3x9.jo.ghaym.app is not a members-only address", "host": "storefront-k3x9.jo.ghaym.app", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/access/continue", "method": "GET", "instance": "GET /v1/access/continue", "status": 400, "docs": "https://ghaym.me/docs/errors/host-not-gated" } ``` Source: https://ghaym.me/docs/errors/plan-not-self-selectable.md # Plan Not Self Selectable الخطة المطلوبة تمنح ولا تختار، فأبقت الـ API الحساب على خطته الحالية. والـ `planKey` يسمي الخطة التي طلبت. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `planKey`. ## الأسباب الشائعة - سمى `ghaym cloud billing set-plan` أو `PUT /v1/billing/account/plan` خطة لا يمكن اختيارها. ## كيف تصلح الطلب - اختر خطة يعرضها `ghaym cloud billing plans` على أنها قابلة للاختيار، وانتقل إليها عبر `ghaym cloud billing set-plan --plan `. ## مثال على الرد ```json { "type": "plan-not-self-selectable", "title": "Plan Not Self Selectable", "detail": "The custom plan is granted, not chosen. Pick one of the plans listed by GET /v1/billing/plans as selectable.", "planKey": "custom", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/billing/account/plan", "method": "PUT", "instance": "PUT /v1/billing/account/plan", "status": 403, "docs": "https://ghaym.me/docs/errors/plan-not-self-selectable" } ``` Source: https://ghaym.me/docs/errors/month-out-of-range.md # Month Out Of Range الشهر المطلوب خارج الشهرين اللذين يغطيهما تفصيل الاستهلاك، فلم تعد الـ API شيئا. التفصيل يغطي هذا الشهر والشهر الماضي، بتوقيت UTC، والـ `earliestMonth` و `latestMonth` يسميانهما. ودون `month`، يعرض هذا الشهر. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `earliestMonth` و `latestMonth`. ## الأسباب الشائعة - الـ `month` يسمي شهرا أقدم من الشهر الماضي. - الـ `month` يسمي شهرا لم يأت بعد. ## كيف تصلح الطلب - اطلب شهرا من `earliestMonth` إلى `latestMonth`. - ولشهر أقدم، اقرأ فاتورته: `ghaym cloud billing invoices list`، ثم `ghaym cloud billing invoices get `. ## مثال على الرد ```json { "type": "month-out-of-range", "title": "Month Out Of Range", "detail": "The breakdown covers 2026-06 to 2026-07 only. Older months are the payer's issued invoices.", "earliestMonth": "2026-06", "latestMonth": "2026-07", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/billing/usage/breakdown", "method": "GET", "instance": "GET /v1/billing/usage/breakdown", "status": 400, "docs": "https://ghaym.me/docs/errors/month-out-of-range" } ``` Source: https://ghaym.me/docs/errors/workspace-header-required.md # Workspace Header Required لم يسم النداء أي workspace، فلم ينفذ أي شيء. كل نداء خاص بـ workspace يرسل `X-Ghaym-Workspace` مع معرف الـ workspace، ولا يحتاجه عرض الـ workspaces ولا إنشاؤها ولا تغيير أسمائها. ولا تختار الـ API أي workspace للنداء الذي يتركه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `header`. ## الأسباب الشائعة - أرسل النداء دون `X-Ghaym-Workspace`، من script أو client يبني طلباته بنفسه. ## كيف تصلح الطلب - اعرض الـ workspaces الخاصة بصاحب النداء بـ `ghaym cloud workspaces list` وأرسل واحدا من هذه المعرفات في `X-Ghaym-Workspace`. - الـ EventSource لا يرسل headers: في مسارات البث `GET /v1/services//logs` و`GET /v1/deployments//logs` و`GET /v1/agent-sessions//stream`، أضف `?workspace=` بدلا منه. - ومن الـ CLI، أضف `--workspace `. ## مثال على الرد ```json { "type": "workspace-header-required", "title": "Workspace Header Required", "detail": "Name the workspace this request runs in with the X-Ghaym-Workspace header.", "header": "X-Ghaym-Workspace", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects", "method": "GET", "instance": "GET /v1/projects", "status": 400, "docs": "https://ghaym.me/docs/errors/workspace-header-required" } ``` Source: https://ghaym.me/docs/errors/test-email-throttled.md # Test Email Throttled خرجت رسالة تجربة لهذا الـ workspace في الدقيقة نفسها، فلم ترسل الـ API أخرى. الحد واحدة في الدقيقة لكل workspace، وليس لكل شخص، ويعد بدقيقة الساعة. والتجربة لا تذهب إلا إلى بريد من ينادي. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - طلبت رسالة التجربة مرتين، أو من عضوين، في الدقيقة نفسها. ## كيف تصلح الطلب - انتظر حتى الدقيقة التالية، ثم أرسلها مرة أخرى. - وابحث عن الرسالة الأولى في البريد قبل أن تعيد. ## مثال على الرد ```json { "type": "test-email-throttled", "title": "Test Email Throttled", "detail": "A test message was already sent for this workspace in the last minute. Wait a moment and try again.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/notifications/test", "method": "POST", "instance": "POST /v1/notifications/test", "status": 429, "docs": "https://ghaym.me/docs/errors/test-email-throttled" } ``` Source: https://ghaym.me/docs/errors/unauthorized.md # Authentication Required لم تعرف الـ API من ينادي، لأن الطلب لم يحمل أي بيانات دخول تستطيع استعمالها. والـ token المنتهي يصل إلى هنا أيضا. أما الـ token الذي قرأته الـ API ولن تقبله أبدا فيعيد [invalid-token](/ar/docs/errors/invalid-token). لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - الـ header `Authorization` غير موجود، أو ليس بصيغة `Bearer `. - انتهى الـ access token. عمر الـ access tokens قصير عن قصد. - وصل مع الطلب cookie جلسة المتصفح فقط، وقد انتهت الجلسة. ## كيف تصلح الطلب - دع الـ CLI `ghaym` يسجل الدخول عنك: ضع مفتاح API في `GHAYM_TOKEN`، وهو يستبدله بـ access token ويجدده عندما ينتهي. - في النداء المباشر عبر HTTP، أرسل `Authorization: Bearer `، وخذ token جديدا عندما يعود هذا الخطأ. وإذا رفض الـ token الجديد أيضا، فتوقف واسأل المستخدم. - لا تطبع الـ token ولا المفتاح في السجلات، ولا تكتب أيا منهما في ملفات العمل. ## مثال على الرد ```json { "type": "unauthorized", "title": "Authentication Required", "status": 401, "detail": "No JWT token or valid session cookie provided", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects", "method": "GET", "instance": "GET /v1/projects", "docs": "https://ghaym.me/docs/errors/unauthorized" } ``` Source: https://ghaym.me/docs/errors/invalid-token.md # Invalid Token قرأت الـ API الـ bearer token ولن تقبله، فإعادة المحاولة بالـ token نفسه لن تنجح. الـ `detail` يذكر أي فحص رفضه. وعندما لم تستطع الـ API فحص الـ token أصلا، تعيد [auth-unavailable](/ar/docs/errors/auth-unavailable)، وهذا يستحق إعادة المحاولة. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - يحمل الـ header مفتاح الـ API نفسه. تأخذ الـ API الـ access token الذي يستبدل به المفتاح، والمفتاح ليس JSON Web Token موقعا. - الـ token موقع بمفتاح لا تنشره خدمة الهوية: إما مزور، وإما صنع في مكان آخر. - الـ token موقع بسر مشترك، وهي صيغة لم تعد الـ API تقبلها، أو بخوارزمية لا تقبلها. ## كيف تصلح الطلب - خذ access token جديدا. مع الـ CLI `ghaym`، ضع مفتاح API في `GHAYM_TOKEN` ودعه يجري الاستبدال. - تخلص من الـ token المرفوض بدل أن تعيد المحاولة به. - وإذا رفض token جديد أيضا، فتوقف وأخبر المستخدم، واذكر `detail` و `requestId`. ## مثال على الرد ```json { "type": "invalid-token", "title": "Invalid Token", "detail": "The bearer token is not a signed JSON Web Token.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects", "method": "GET", "instance": "GET /v1/projects", "status": 401, "docs": "https://ghaym.me/docs/errors/invalid-token" } ``` Source: https://ghaym.me/docs/errors/forbidden.md # Access Forbidden النوع الاحتياطي لـ 403 ليس له نوع باسمه، ولا يوجد مسار في الـ API يرسله اليوم. الصلاحية المرفوضة، أو دور المقعد الأقل مما يحتاجه النداء، يعيد [forbidden-access](/ar/docs/errors/forbidden-access)، وهو يسمي الناقص. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - خطأ 403 صدر دون نوع خاص به ووصل إلى معالج الأخطاء. ## كيف تصلح الطلب - لا تعد المحاولة، ولا تجرب endpoint آخر على أمل أن يكون أقل تقييدا. - اعرض `detail` على المستخدم ودعه يقرر: تغيير الصلاحيات قراره هو. ## مثال على الرد ```json { "type": "forbidden", "title": "Access Forbidden", "status": 403, "detail": "Forbidden resource", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "DELETE", "instance": "DELETE /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "docs": "https://ghaym.me/docs/errors/forbidden" } ``` Source: https://ghaym.me/docs/errors/insufficient-permission.md # Insufficient Permission الـ 403 الذي تعلنه وثيقة OpenAPI الخاصة بالـ API، وفيه `requiredPermission` يسمي الصلاحية التي تنقص صاحب النداء. وقت التشغيل، تعيد الصلاحية المرفوضة [forbidden-access](/ar/docs/errors/forbidden-access) بدلا منه، فتعامل مع الاثنين. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `requiredPermission`. ## الأسباب الشائعة - لا يملك الحساب الصلاحية التي تحتاجها العملية، مثل `cloud:projects:delete`. ## كيف تصلح الطلب - اقرأ `requiredPermission` وأخبر المستخدم بالصلاحية الناقصة تحديدا. - لا تعد المحاولة، ولا تحاول إجراء التغيير نفسه من endpoint آخر. ## مثال على الرد ```json { "type": "insufficient-permission", "title": "Insufficient Permission", "status": 403, "detail": "Your account is not permitted to perform this action (missing: cloud:projects:delete)", "requiredPermission": "cloud:projects:delete", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "DELETE", "instance": "DELETE /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "docs": "https://ghaym.me/docs/errors/insufficient-permission" } ``` Source: https://ghaym.me/docs/errors/approval-required.md # Approval Required يجب أن يوافق شخص على هذا النداء قبل تنفيذه، فحجزته الـ API ولم تغير شيئا. الحالة 202 ليست خطأ: قبل النداء وهو ينتظر شخصا يوافق عليه أو يرفضه. والنداء الذي يسمي agent هو وحده الذي يحجز، والقرار يظهر على `pollUrl`. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `approvalId`، `pollUrl`، `expiresAt`، `operation`، `projectId` و `approvalPolicy`. ## الأسباب الشائعة - يحمل النداء header `X-Ghaym-Agent` أو `X-Ghaym-Session` أو `X-Ghaym-Intent`، فيحسب نداء agent. والنداء الذي لا يحمل أيا منها يحسب نداء شخص، ولا يحجز أبدا. - سياسة الموافقة في المشروع `standard` أو `strict`، والنداء يحذف مشروعا أو بيئة أو خدمة أو domain، أو يطبق تغييرات مجهزة تحذف متغيرا أو خدمة أو نسخة قاعدة. وفي `sandbox` لا يحجز أي شيء. - السياسة `strict`، والنداء يطلق خدمة كلفتها الشهرية المتوقعة فوق الحد المحدد. - طلب agent إرجاع جلسة بـ `POST /v1/agent-sessions//rollback`، تحت أي سياسة غير `sandbox`. وهنا يكون `operation` هو `session.rollback`. ## كيف تصلح الطلب - لا ترسل النداء مرة أخرى: بعد الموافقة عليه، تنفذ الـ API النداء المحجوز بنفسها. والإرسال الثاني بالـ `X-Ghaym-Session` نفسه يعيد لك الموافقة المنتظرة نفسها، والإرسال دون جلسة يحجز كموافقة ثانية. - استعلم من `pollUrl` حتى يصبح `status` غير `pending`: ينتهي إلى `approved` أو `denied` أو `expired`. ومن الـ CLI، شغل `ghaym cloud approvals wait `، ويخرج الـ CLI بالرمز 6 عندما يحجز نداء. - أخبر المستخدم بما ينتظر: `operation` يسمي النداء، والموافقة تنتهي عند `expiresAt`. - لكي تفحص نداء دون حجز أي شيء، أرسله مع `?dryRun=true` أولا. التجربة لا تحجز أبدا. ## مثال على الرد ```json { "type": "approval-required", "title": "Approval Required", "detail": "This project's 'standard' approval policy holds project.delete for a human decision. Nothing has been changed. Poll /v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402 until its status is no longer 'pending'; it expires at 2026-07-29T09:30:00.000Z.", "status": 202, "approvalId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "pollUrl": "/v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "expiresAt": "2026-07-29T09:30:00.000Z", "operation": "project.delete", "projectId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "approvalPolicy": "standard", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "DELETE", "instance": "DELETE /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "docs": "https://ghaym.me/docs/errors/approval-required" } ``` Source: https://ghaym.me/docs/errors/untrusted-origin.md # Untrusted Origin كتابة مسجلة الدخول بكوكي جلسة غيم جاءت من صفحة لا تثق بها الـ API، فرفضتها قبل أن تقرأ الجلسة. المتصفح يرسل الكوكي مع أي طلب، حتى طلب صفحة مؤذية، فالكتابة التي تعتمد عليه يجب أن تأتي من صفحات غيم نفسها. والقراءة لا تفحص أبدا، ولا النداء الذي يحمل bearer token يعمل. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - صفحة على موقع آخر أرسلت `POST` أو `PUT` أو `PATCH` أو `DELETE` إلى الـ API، وأضاف المتصفح الكوكي. - script أو أداة أرسلت كتابة نسخ فيها كوكي الجلسة، دون header `Origin` أو `Sec-Fetch-Site` تثق به الـ API. - أرسل bearer token لكنه لم يعمل، فعادت الـ API إلى الكوكي الذي جاء معه. ## كيف تصلح الطلب - من الكود، سجل الدخول بـ bearer token، مثل token مفتاح API، بدل الكوكي. - ومن المتصفح، أجر التغيير من الـ console. - وإذا أرسل bearer token، فأصلحه أولا: الكوكي يستعمل فقط عندما يفشل الـ token. ## مثال على الرد ```json { "type": "untrusted-origin", "title": "Untrusted Origin", "detail": "Cookie-authenticated requests that change state must come from an allowed origin. Send the request from the console, or authenticate with a bearer token.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects", "method": "POST", "instance": "POST /v1/projects", "status": 403, "docs": "https://ghaym.me/docs/errors/untrusted-origin" } ``` Source: https://ghaym.me/docs/errors/database-connect-forbidden.md # Cannot Connect To Databases مقعد من ينادي في الـ workspace لا يسمح بالاتصال بقواعد البيانات، فلم تفتح الـ API أي tunnel. الـ `role` هو المقعد الذي حكم عليه، و `allowedRoles` المقاعد التي تمر. وعندما يكون `viaKey` بقيمة `true`، فهذا يعني أن API key أجرى النداء بمقعد من أنشأه، والـ `email` يسمي هذا الشخص. والـ CLI يخرج بالرمز 3. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `permission`، `role`، `viaKey`، `email`، `workspaceName` و `allowedRoles`. ## الأسباب الشائعة - مقعد من ينادي `viewer`، والـ viewer لا يستطيع فتح tunnel لقاعدة بيانات. - أنشأ الـ API key شخص مقعده الآن `viewer`: المفتاح يعمل بمقعد من أنشأه كما هو اليوم. ## كيف تصلح الطلب - أخبر المستخدم بما ينقص بالضبط، واذكر `detail`، ومع المفتاح `email`. - تغيير المقعد يجريه admin في الـ workspace. وعندما يتم، شغل الأمر نفسه مرة أخرى. - لا تعد المحاولة دون تغيير: كل طريق إلى القاعدة يجري الفحص نفسه. ## مثال على الرد ```json { "type": "database-connect-forbidden", "title": "Cannot Connect To Databases", "detail": "Your seat in this workspace is 'viewer'; connecting to databases needs admin or developer", "permission": "databases:connect", "role": "viewer", "viaKey": false, "email": "sara@example.com", "workspaceName": "Acme", "allowedRoles": [ "admin", "developer" ], "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 403, "docs": "https://ghaym.me/docs/errors/database-connect-forbidden" } ``` Source: https://ghaym.me/docs/errors/installation-not-held.md # Installation Not Held حساب GitHub الذي سجل الدخول لا يصل إلى التثبيت المسمى، فلم تربط الـ API شيئا. لا تربط إلا التثبيتات التي يصل إليها حساب GitHub الخاص بالمستخدم نفسه. والجواب نفسه سواء كان التثبيت موجودا أم لا، فلا يكشف شيئا عن تثبيتات غيره. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `installationId`. ## الأسباب الشائعة - التثبيت لحساب GitHub أو organisation ليس المستخدم فيه. - عدل الـ `installation_id` في رابط عودة GitHub يدويا. ## كيف تصلح الطلب - ابدأ الربط من جديد واختر تثبيتا من القائمة التي يعرضها. - وإذا كانت الـ repos لـ organisation، فاطلب من صاحبها أن يعطي المستخدم وصولا، أو أن يثبت الـ app. ## مثال على الرد ```json { "type": "installation-not-held", "title": "Installation Not Held", "detail": "Your GitHub account does not have access to that installation.", "installationId": "48210377", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/git/installations/claim", "method": "POST", "instance": "POST /v1/git/installations/claim", "status": 403, "docs": "https://ghaym.me/docs/errors/installation-not-held" } ``` Source: https://ghaym.me/docs/errors/forbidden-access.md # Access Denied الـ API تعرف من ينادي، لكن مقعده أو صلاحياته لا تسمح بهذا النداء. الـ `requiredPermission` يسمي ما ينقص. عندما يكون المقعد أقل من المطلوب، يعدد غالبا المقاعد التي تمر، ويكون الـ `resourceType` هو `Workspace`. وعندما تنقص الحساب صلاحية، يعدد الصلاحيات الناقصة، مثل `cloud:projects:delete`، ويكون الـ `resourceType` هو `Cloud`. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `requiredPermission`، `resourceType` و `resourceId`. ## الأسباب الشائعة - مقعد من ينادي في الـ workspace هو `viewer`، والنداء يكتب. كل كتابة تحتاج `developer` أو أعلى. - النداء يخص المال، ولا يستطيع إجراءه إلا أدوار المنظمة التي يسميها، مثل `owner` و `admin`. - الحساب لا يملك صلاحية يحتاجها المسار، مثل صلاحية مسار إداري. - تطبيق changeset يحذف خدمة أو نسخة قاعدة يحتاج `cloud:projects:delete`. وعندها يكون `resourceType` هو `Changeset`. ## كيف تصلح الطلب - اقرأ `requiredPermission` وأخبر المستخدم بما ينقص بالضبط، واذكر `detail`. - لا تعد المحاولة، ولا تحاول إجراء التغيير نفسه عبر endpoint آخر: كل المسارات تجري الفحص نفسه. - تغيير المقعد يجريه admin في الـ workspace، وليس شيئا تلتف عليه. ## مثال على الرد ```json { "type": "forbidden-access", "title": "Access Denied", "detail": "Your seat in this workspace is 'viewer'; this action needs admin or developer", "requiredPermission": "admin, developer", "resourceType": "Workspace", "resourceId": "current", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "DELETE", "instance": "DELETE /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 403, "docs": "https://ghaym.me/docs/errors/forbidden-access" } ``` Source: https://ghaym.me/docs/errors/invalid-access-code.md # The sign-in code is invalid or has expired. بادل الـ edge الخاص بغيم رمز تسجيل دخول غير معروف أو منته أو مستعمل أو منشأ لعنوان آخر، فلم يدخل الزائر. لا ينادي هذا المسار إلا الـ edge الخاص بغيم، وهو يدخل زائرا إلى خدمة للأعضاء فقط، ولا يناديه التطبيق أو الـ agent أبدا. والرمز يعيش 60 ثانية ويعمل مرة واحدة، والحالات الأربع لها الجواب نفسه، فلا يبين أيها حدث. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - مر أكثر من 60 ثانية بين تسجيل الدخول ووصول المتصفح إلى الخدمة. - فتح الرابط الذي فيه الرمز مرتين، مثلا بإعادة تحميل الصفحة، وكان الرمز قد استعمل. - الرمز منشأ لعنوان غير الذي قدم إليه. ## كيف تصلح الطلب - يفتح الزائر عنوان الخدمة مرة أخرى، فيبدأ بذلك تسجيل دخول جديد. - لا تشارك الرابط الذي فيه الرمز ولا تحفظه: يعمل مرة واحدة. ## مثال على الرد ```json { "type": "invalid-access-code", "title": "The sign-in code is invalid or has expired.", "detail": "The code is unknown, expired, already used, or was issued for another host", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/edge/access/exchange", "method": "POST", "instance": "POST /v1/edge/access/exchange", "status": 400, "docs": "https://ghaym.me/docs/errors/invalid-access-code" } ``` Source: https://ghaym.me/docs/errors/agent-cannot-approve.md # Agent Cannot Approve حاول agent أن يوافق على نداء محجوز أو يرفضه، ولا يستطيع القرار إلا الشخص، فالموافقة ما زالت تنتظر. يعد النداء نداء agent عندما يحتوي header `X-Ghaym-Agent` أو `X-Ghaym-Session` أو `X-Ghaym-Intent`، مهما كان الـ token الخاص به. الـ agent يحمل token الشخص نفسه، فالـ headers هي التي تفرق بينهما. والـ `approvalId` يسمي الموافقة. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `approvalId`. ## الأسباب الشائعة - أرسل agent الطلب `POST /v1/approvals//approve` أو `/deny` مع الـ headers التي تعرف به. ## كيف تصلح الطلب - اطلب من المستخدم أن يقرر: يوافق أو يرفض من الـ console، أو يشغل `ghaym cloud approvals approve ` بنفسه. - وانتظر القرار عبر `ghaym cloud approvals wait `. - لا تزل الـ headers لتتجاوز الفحص: سيسجل القرار عندها كأنه قرار الشخص. ## مثال على الرد ```json { "type": "agent-cannot-approve", "title": "Agent Cannot Approve", "detail": "Approval 0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402 can only be decided by a person. Send this request without the agent identity headers, from a human session.", "approvalId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/approve", "method": "POST", "instance": "POST /v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/approve", "status": 403, "docs": "https://ghaym.me/docs/errors/agent-cannot-approve" } ``` Source: https://ghaym.me/docs/errors/approval-only-initiator-may-decide.md # Only The Initiator May Decide لا يستطيع القرار في الموافقة إلا الشخص الذي طلبها الـ agent الخاص به، وقد حاول شخص آخر، فلم تتغير. أعضاء الـ workspace يرون موافقات بعضهم، لكن صاحبها وحده هو الذي يقرر. والـ `initiatorUserId` هو هذا الشخص. وهذا الفحص يجري قبل فحص الانتظار، فيعود حتى لموافقة قرر فيها. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `approvalId` و `initiatorUserId`. ## الأسباب الشائعة - حاول زميل في الـ workspace نفسه أن يوافق عليها أو يرفضها. - دخل الشخص بحساب غير الحساب الذي يعمل معه الـ agent الخاص به. ## كيف تصلح الطلب - اطلب من الشخص الذي يسميه `initiatorUserId` أن يقرر فيها. - ولكي تجري التغيير نفسه باسمك، أرسل النداء بنفسك: النداء الذي لا يحتوي headers الـ agent لا يحجز أبدا. ## مثال على الرد ```json { "type": "approval-only-initiator-may-decide", "title": "Only The Initiator May Decide", "detail": "Approval 0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402 can only be approved or denied by the person whose agent raised it.", "approvalId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "initiatorUserId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/approve", "method": "POST", "instance": "POST /v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/approve", "status": 403, "docs": "https://ghaym.me/docs/errors/approval-only-initiator-may-decide" } ``` Source: https://ghaym.me/docs/errors/api-key-revoked.md # API Key Revoked مفتاح الـ API الذي وراء النداء لم يعد يعمل، مع أن الـ token الخاص به لم ينته، فلم تفتح الـ API أي tunnel. الـ token يعيش أطول من مفتاح ألغي بعد إصدار الـ token، لذلك يفحص فتح الـ tunnel المفتاح نفسه. ولا يصل هذا إلا إلى النداء الذي معه token مفتاح، ولا تصل إليه جلسة الـ console أبدا. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - ألغي المفتاح بعد أن استبدل بالـ token. - تجاوز المفتاح تاريخ انتهائه. ## كيف تصلح الطلب - اطلب من المستخدم مفتاحا يعمل، واستبدله بـ token جديد، ثم اتصل مرة أخرى. - لا تعد المحاولة بالـ token نفسه، فالجواب لن يتغير. ## مثال على الرد ```json { "type": "api-key-revoked", "title": "API Key Revoked", "detail": "The API key this call was made with was revoked or has expired.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 401, "docs": "https://ghaym.me/docs/errors/api-key-revoked" } ``` Source: https://ghaym.me/docs/errors/not-found.md # Resource Not Found لا يوجد مسار في الـ API يطابق الطلب، أي أن الـ endpoint نفسه غير موجود. أما المورد المفقود على مسار موجود فيعيد نوعا خاصا به، مثل [project-not-found](/ar/docs/errors/project-not-found)، فتميز بين الحالتين دون أن تقرأ نصا. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - المسار مكتوب خطأ، أو تنقصه البادئة `/v1`. - الـ method خاطئ لمسار موجود، مثل أن ترسل `POST` إلى مجموعة تخدم `GET` فقط. - الـ endpoint مفترض ولم يتحقق منه. ليس للـ HTTP API مرجع عام، فقد يكون endpoint يبدو بديهيا غير موجود. ## كيف تصلح الطلب - قارن `path` بالمسار الذي قصدته، مع البادئة. - لا تتحسس الـ endpoints بتجريب صيغ مختلفة. استعمل الـ CLI `ghaym` لتشغيل غيم. ## مثال على الرد ```json { "type": "not-found", "title": "Resource Not Found", "status": 404, "detail": "The requested endpoint '/v1/projcts' does not exist. Please check the API documentation for available endpoints.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projcts", "method": "GET", "instance": "GET /v1/projcts", "docs": "https://ghaym.me/docs/errors/not-found" } ``` Source: https://ghaym.me/docs/errors/resource-not-found.md # Resource Not Found الـ 404 الذي تعلنه وثيقة OpenAPI الخاصة بالـ API لكل مورد، ولا يرسله أي مسار اليوم. كل مورد مفقود غيره يعيد نوعا خاصا به، مثل [project-not-found](/ar/docs/errors/project-not-found). وكلها تحمل `resourceType` و `resourceId`. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المورد مفقود، أو لا يراه صاحب الطلب. ## كيف تصلح الطلب - طابق `type` على اللاحقة `-not-found` لا على هذا الـ slug، لكي تتعامل مع كل مورد مفقود بالطريقة نفسها. - تحقق من المعرف في المسار مقابل `resourceId`، فهو يسمي المورد الذي بحث عنه الطلب. - وتجد [كل أنواع المورد المفقود](/ar/docs/errors) في الفهرس. ## مثال على الرد ```json { "type": "resource-not-found", "title": "Resource Not Found", "detail": "Resource with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403' was not found", "resourceType": "Resource", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403/env/resolved", "method": "GET", "instance": "GET /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403/env/resolved", "status": 404, "docs": "https://ghaym.me/docs/errors/resource-not-found" } ``` Source: https://ghaym.me/docs/errors/project-not-found.md # Project Not Found لم تعثر الـ API على مشروع بهذا المعرف في الـ workspace الذي أرسل منه النداء. المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. الـ path يقبل معرف المشروع أو الـ slug الخاص به، والـ `resourceId` هو الذي أرسل. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر. - حذف المشروع بين النداء الذي عرضه في القائمة وهذا النداء. - أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اطلب القائمة من جديد بـ `ghaym cloud projects list` وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا. - وإذا كان المعرف صحيحا وحديثا، فأرسل `X-Ghaym-Workspace` باسم الـ workspace الذي فيه المورد. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "project-not-found", "title": "Project Not Found", "detail": "Project with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Project", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "GET", "instance": "GET /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/project-not-found" } ``` Source: https://ghaym.me/docs/errors/environment-not-found.md # Environment Not Found لم تعثر الـ API على بيئة بهذا المعرف في الـ workspace الذي أرسل منه النداء. المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر. - حذفت البيئة بين النداء الذي عرضها في القائمة وهذا النداء. - أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. - البيئة تابعة لمشروع غير الذي في الـ path: لكل مشروع `production` خاص به. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اطلب القائمة من جديد بـ `ghaym cloud environments list ` وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا. - وإذا كان المعرف صحيحا وحديثا، فأرسل `X-Ghaym-Workspace` باسم الـ workspace الذي فيه المورد. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "environment-not-found", "title": "Environment Not Found", "detail": "Environment with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "Environment", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "method": "GET", "instance": "GET /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 404, "docs": "https://ghaym.me/docs/errors/environment-not-found" } ``` Source: https://ghaym.me/docs/errors/service-not-found.md # Service Not Found لم تعثر الـ API على خدمة بهذا المعرف في الـ workspace الذي أرسل منه النداء. المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. الـ path يقبل معرف الخدمة أو الـ slug الخاص بها، والـ `resourceId` هو الذي أرسل. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر. - حذفت الخدمة بين النداء الذي عرضها في القائمة وهذا النداء. - أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اطلب القائمة من جديد بـ `ghaym cloud services list ` وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا. - وإذا كان المعرف صحيحا وحديثا، فأرسل `X-Ghaym-Workspace` باسم الـ workspace الذي فيه المورد. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "service-not-found", "title": "Service Not Found", "detail": "Service with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Service", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "GET", "instance": "GET /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/service-not-found" } ``` Source: https://ghaym.me/docs/errors/serviceenvironment-not-found.md # ServiceEnvironment Not Found الخدمة موجودة والبيئة موجودة، لكن الخدمة لا تعمل في هذه البيئة. الـ `resourceId` يحمل ما بحثت عنه الـ API: `/`، أو معرفا واحدا فقط. وفي الـ domain الخاص، هو معرف الخدمة وحده. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - النداء ينشر الخدمة أو يغير فيها في بيئة لا يعمل فيها أي شيء منها. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اذكر بيئة تعمل فيها الخدمة. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "serviceenvironment-not-found", "title": "ServiceEnvironment Not Found", "detail": "ServiceEnvironment with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "ServiceEnvironment", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments?environmentId=0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments?environmentId=0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 404, "docs": "https://ghaym.me/docs/errors/serviceenvironment-not-found" } ``` Source: https://ghaym.me/docs/errors/deployment-not-found.md # Deployment Not Found لم تعثر الـ API على deployment بهذا المعرف في الـ workspace الذي أرسل منه النداء. المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر. - حذف الـ deployment بين النداء الذي عرضه في القائمة وهذا النداء. - أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اطلب القائمة من جديد بـ `ghaym cloud deployments list` وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا. - وإذا كان المعرف صحيحا وحديثا، فأرسل `X-Ghaym-Workspace` باسم الـ workspace الذي فيه المورد. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "deployment-not-found", "title": "Deployment Not Found", "detail": "Deployment with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Deployment", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/deployments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "GET", "instance": "GET /v1/deployments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/deployment-not-found" } ``` Source: https://ghaym.me/docs/errors/domain-not-found.md # Domain Not Found لم تعثر الـ API على domain خاص بهذا المعرف في الـ workspace الذي أرسل منه النداء. المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر. - حذف الـ domain الخاص بين النداء الذي عرضه في القائمة وهذا النداء. - أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. - الـ domain على خدمة غير التي في الـ path. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اطلب القائمة من جديد بـ `ghaym cloud domains list ` وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا. - وإذا كان المعرف صحيحا وحديثا، فأرسل `X-Ghaym-Workspace` باسم الـ workspace الذي فيه المورد. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "domain-not-found", "title": "Domain Not Found", "detail": "Domain with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "Domain", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/domains/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "method": "DELETE", "instance": "DELETE /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/domains/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 404, "docs": "https://ghaym.me/docs/errors/domain-not-found" } ``` Source: https://ghaym.me/docs/errors/changeset-not-found.md # Changeset Not Found ليس في البيئة changeset مفتوح، فلا يوجد شيء تطبقه أو تلغيه أو تزيله. هنا الـ `resourceId` هو معرف البيئة، لا معرف changeset: يعثر على الـ changeset المفتوح عن طريق بيئته. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - لم يجهز أي شيء على هذه البيئة. - طبق الـ changeset أو ألغي من قبل، من صاحب النداء نفسه أو من غيره. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - جهز تغييرا أولا بـ `ghaym cloud changes stage`، أو `PUT .../changeset/entries`: هذا يفتح changeset. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "changeset-not-found", "title": "Changeset Not Found", "detail": "Changeset with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "Changeset", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/apply", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/apply", "status": 404, "docs": "https://ghaym.me/docs/errors/changeset-not-found" } ``` Source: https://ghaym.me/docs/errors/instance-not-found.md # Instance Not Found لم يعثر مسار للمشغلين على instance بهذا المعرف. المشغلون وحدهم يصلون إلى المسارات التي ترسله. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: لا يطابق أي سجل. - أنشأ مشغل آخر الـ instance: كل مشغل يرى ما يخصه فقط. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "instance-not-found", "title": "Instance Not Found", "detail": "Instance with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Instance", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/admin/instances/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "GET", "instance": "GET /v1/admin/instances/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/instance-not-found" } ``` Source: https://ghaym.me/docs/errors/installation-not-found.md # Installation Not Found لا يعرف GitHub ولا هذا الـ workspace تثبيت الـ GitHub App الذي ذكره الطلب. المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. في الـ claim، الـ `resourceId` هو رقم التثبيت لدى GitHub، ولم يتعرف عليه GitHub. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر. - حذف تثبيت الـ GitHub App بين النداء الذي عرضه في القائمة وهذا النداء. - أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. - أزيل الـ app من GitHub قبل أن ينتهي الـ claim. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اطلب القائمة من جديد بـ `ghaym cloud git installations` وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا. - وإذا كان المعرف صحيحا وحديثا، فأرسل `X-Ghaym-Workspace` باسم الـ workspace الذي فيه المورد. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. - ثبت الـ app من جديد من العنوان الذي يطبعه `ghaym cloud git install`. ## مثال على الرد ```json { "type": "installation-not-found", "title": "Installation Not Found", "detail": "GitHub does not recognize this installation for the Ghaym Cloud app.", "resourceType": "Installation", "resourceId": "48210377", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/git/installations/claim", "method": "POST", "instance": "POST /v1/git/installations/claim", "status": 404, "docs": "https://ghaym.me/docs/errors/installation-not-found" } ``` Source: https://ghaym.me/docs/errors/repository-not-found.md # Repository Not Found الـ repo الذي ذكره الطلب ليس مما تستطيع الـ API الوصول إليه عن طريق GitHub. المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. هنا الـ `resourceId` هو الـ repo بصيغة `owner/repo`، والـ `detail` يذكر أي فحص فشل: لا يوجد تثبيت مربوط يغطيه، أو رد GitHub بأنه غير موجود. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر. - حذف الـ repo بين النداء الذي عرضه في القائمة وهذا النداء. - أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. - لا يوجد تثبيت GitHub App في هذا الـ workspace يغطي الـ repo: لم يعط الـ app وصولا إليه. - تغير اسم الـ repo أو نقل أو حذف على GitHub. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اطلب القائمة من جديد وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا. - وإذا كان المعرف صحيحا وحديثا، فأرسل `X-Ghaym-Workspace` باسم الـ workspace الذي فيه المورد. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. - إذا كان الـ repo صحيحا، فأعط الـ app وصولا إليه من GitHub، ثم أرسل النداء نفسه مرة أخرى. - اعرض ما يستطيع هذا الـ workspace الوصول إليه بـ `ghaym cloud git installations`. ## مثال على الرد ```json { "type": "repository-not-found", "title": "Repository Not Found", "detail": "GitHub repository 'acme/storefront' is not available through your connected GitHub installations.", "resourceType": "Repository", "resourceId": "acme/storefront", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/git/branches", "method": "GET", "instance": "GET /v1/git/branches", "status": 404, "docs": "https://ghaym.me/docs/errors/repository-not-found" } ``` Source: https://ghaym.me/docs/errors/region-not-found.md # Region Not Found لا تعرض الـ API أي region بهذا المفتاح. الكتالوج واحد لكل workspace، فالمشكلة في المفتاح، لا في الصلاحية. والـ `resourceId` يحمل المفتاح الذي بحثت عنه الـ API. يعثر على الـ region بالـ slug الخاص به، مثل `amman-1`، مهما كانت حالته. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المفتاح خاطئ أو مختلق. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - أرسل مفتاحا من `ghaym cloud regions list`. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "region-not-found", "title": "Region Not Found", "detail": "Region with ID 'eu-central-1' was not found", "resourceType": "Region", "resourceId": "eu-central-1", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/regions/eu-central-1/sizes", "method": "GET", "instance": "GET /v1/regions/eu-central-1/sizes", "status": 404, "docs": "https://ghaym.me/docs/errors/region-not-found" } ``` Source: https://ghaym.me/docs/errors/plan-not-found.md # Plan Not Found لم يعثر مسار للمشغلين على خطة بهذا المعرف. المشغلون وحدهم يصلون إلى المسارات التي ترسله. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: لا يطابق أي سجل. - الخطة موجودة لكن لا شيء منها معروض للبيع، وهذا يعيد الـ 404 نفسه. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "plan-not-found", "title": "Plan Not Found", "detail": "Plan with ID 'ghaym-s9' was not found", "resourceType": "Plan", "resourceId": "ghaym-s9", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/admin/instances", "method": "POST", "instance": "POST /v1/admin/instances", "status": 404, "docs": "https://ghaym.me/docs/errors/plan-not-found" } ``` Source: https://ghaym.me/docs/errors/instance-size-not-found.md # Instance size Not Found حجم الـ instance الذي ذكره الطلب غير معروض في الـ region الذي تعمل فيه الخدمة. الكتالوج واحد لكل workspace، فالمشكلة في المفتاح، لا في الصلاحية. والـ `resourceId` يحمل المفتاح الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المفتاح خاطئ أو مختلق. - الحجم معروض في region آخر، لا في هذا: لكل region أحجامه. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - أرسل مفتاحا من `ghaym cloud regions sizes `. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "instance-size-not-found", "title": "Instance size Not Found", "detail": "Instance size 'large' is not available in this region", "resourceType": "Instance size", "resourceId": "large", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "PATCH", "instance": "PATCH /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/instance-size-not-found" } ``` Source: https://ghaym.me/docs/errors/billing-plan-not-found.md # Billing plan Not Found لا تعرض الـ API أي خطة فوترة بهذا المفتاح. الكتالوج واحد لكل workspace، فالمشكلة في المفتاح، لا في الصلاحية. والـ `resourceId` يحمل المفتاح الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المفتاح خاطئ أو مختلق. - في المفتاح خطأ إملائي، أو يسمي خطة لم تعد معروضة. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - أرسل مفتاحا من `ghaym cloud billing plans`. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "billing-plan-not-found", "title": "Billing plan Not Found", "detail": "Billing plan with ID 'enterprise' was not found", "resourceType": "Billing plan", "resourceId": "enterprise", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/billing/account/plan", "method": "PUT", "instance": "PUT /v1/billing/account/plan", "status": 404, "docs": "https://ghaym.me/docs/errors/billing-plan-not-found" } ``` Source: https://ghaym.me/docs/errors/billing-account-not-found.md # Billing account Not Found لم يعثر مسار للمشغلين على حساب فوترة بهذا المعرف. المشغلون وحدهم يصلون إلى المسارات التي ترسله. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: لا يطابق أي سجل. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "billing-account-not-found", "title": "Billing account Not Found", "detail": "Billing account with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Billing account", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/billing/admin/account?accountId=0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "GET", "instance": "GET /v1/billing/admin/account?accountId=0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/billing-account-not-found" } ``` Source: https://ghaym.me/docs/errors/invoice-not-found.md # Invoice Not Found لم تعثر الـ API على فاتورة بهذا المعرف في الـ workspace الذي أرسل منه النداء. المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر. - أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اطلب القائمة من جديد بـ `ghaym cloud billing invoices list` وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا. - وإذا كان المعرف صحيحا وحديثا، فأرسل `X-Ghaym-Workspace` باسم الـ workspace الذي فيه المورد. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "invoice-not-found", "title": "Invoice Not Found", "detail": "Invoice with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Invoice", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/billing/invoices/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "GET", "instance": "GET /v1/billing/invoices/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/invoice-not-found" } ``` Source: https://ghaym.me/docs/errors/offering-not-found.md # Offering Not Found لم يعثر مسار للمشغلين على عرض تسعير بهذا المعرف. المشغلون وحدهم يصلون إلى المسارات التي ترسله. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: لا يطابق أي سجل. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "offering-not-found", "title": "Offering Not Found", "detail": "Offering with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Offering", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/admin/pricing/offerings/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "PATCH", "instance": "PATCH /v1/admin/pricing/offerings/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/offering-not-found" } ``` Source: https://ghaym.me/docs/errors/abuse-report-not-found.md # Abuse report Not Found لم يعثر مسار للمشغلين على بلاغ إساءة بهذا المعرف. المشغلون وحدهم يصلون إلى المسارات التي ترسله. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: لا يطابق أي سجل. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "abuse-report-not-found", "title": "Abuse report Not Found", "detail": "Abuse report with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Abuse report", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/abuse/admin/reports/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "GET", "instance": "GET /v1/abuse/admin/reports/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/abuse-report-not-found" } ``` Source: https://ghaym.me/docs/errors/agentsession-not-found.md # AgentSession Not Found لم تعثر الـ API على جلسة agent بهذا المعرف في الـ workspace الذي أرسل منه النداء. معرف الجلسة هو قيمة `X-Ghaym-Session` التي اختارها الـ agent، والـ `resourceId` يحمله. والجلسة الموجودة في workspace آخر تعيد الـ 404 نفسه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - لم يرسل أي نداء كتابة ولا نداء محجوز بهذا المعرف في `X-Ghaym-Session`: القراءة لا تفتح جلسة. - الجلسة في workspace غير الذي أرسل منه النداء: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. - في المعرف خطأ كتابي. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اعرض الجلسات بـ `ghaym cloud sessions list` وخذ المعرف من جوابها. - أرسل `X-Ghaym-Workspace` باسم الـ workspace الذي عمل فيه الـ agent. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "agentsession-not-found", "title": "AgentSession Not Found", "detail": "AgentSession with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "AgentSession", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/agent-sessions/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "GET", "instance": "GET /v1/agent-sessions/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/agentsession-not-found" } ``` Source: https://ghaym.me/docs/errors/approval-not-found.md # Approval Not Found لم تعثر الـ API على موافقة بهذا المعرف في الـ workspace الذي أرسل منه النداء. الـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. والموافقة الموجودة في workspace آخر تعيد الـ 404 نفسه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - أرسل الاستعلام في workspace غير الذي أرسل فيه النداء المحجوز: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. - في المعرف خطأ كتابي. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - خذ المعرف من `approvalId` أو `pollUrl` في النداء المحجوز، أو اعرضها بـ `ghaym cloud approvals list`. - استعلم بالـ header `X-Ghaym-Workspace` نفسه الذي أرسل مع النداء المحجوز. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "approval-not-found", "title": "Approval Not Found", "detail": "Approval with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Approval", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "GET", "instance": "GET /v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/approval-not-found" } ``` Source: https://ghaym.me/docs/errors/backup-not-found.md # Backup Not Found ليس لقاعدة البيانات التي في الـ path نسخة احتياطية بهذا المعرف. لا يعثر على النسخة الاحتياطية إلا تحت قاعدة بياناتها، والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. وقاعدة البيانات غير الموجودة في الـ workspace تعيد [service-not-found](/ar/docs/errors/service-not-found) أولا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - النسخة الاحتياطية تابعة لقاعدة بيانات غير التي في الـ path. - حذفت النسخة الاحتياطية. - في المعرف خطأ كتابي. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اعرض النسخ الاحتياطية لقاعدة البيانات بـ `GET /v1/services//backups` وخذ المعرف من جوابها. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "backup-not-found", "title": "Backup Not Found", "detail": "Backup with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "Backup", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/restore", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/restore", "status": 404, "docs": "https://ghaym.me/docs/errors/backup-not-found" } ``` Source: https://ghaym.me/docs/errors/bucket-not-found.md # Bucket Not Found لم تعثر الـ API على bucket بهذا المعرف في الـ workspace الذي أرسل منه النداء. المورد الموجود في workspace آخر يعيد الـ 404 نفسه، لا 403، فلا تستطيع تمييزه عن مورد غير موجود. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: خطأ كتابي، أو معرف ناقص، أو معرف منسوخ من workspace آخر. - حذف الـ bucket بين النداء الذي عرضه في القائمة وهذا النداء. - أرسل النداء في workspace غير الذي فيه المورد: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اطلب القائمة من جديد وخذ المعرف من جوابها، لا من قيمة محفوظة أو مكتوبة يدويا. - وإذا كان المعرف صحيحا وحديثا، فأرسل `X-Ghaym-Workspace` باسم الـ workspace الذي فيه المورد. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "bucket-not-found", "title": "Bucket Not Found", "detail": "Bucket with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Bucket", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "GET", "instance": "GET /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/bucket-not-found" } ``` Source: https://ghaym.me/docs/errors/bucketconnection-not-found.md # BucketConnection Not Found الخدمة لا تقرأ هذا الـ bucket، وليس لها ربط مجهز به، فلا يوجد ما يفك ربطه. هنا الـ `resourceId` هو `/`. والخدمة غير الموجودة في الـ workspace تعيد الـ 404 الخاص بها أولا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - لم يربط الـ bucket بهذه الخدمة قط، أو فك ربطه من قبل. - الـ bucket مربوط بخدمة غير التي في البند. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اقرأ الـ bucket بـ `GET /v1/buckets/`: الـ `connections` الخاصة به تعدد الخدمات المربوط بها. - وإذا كان الهدف فك ربطه، فلم يبق شيء تفعله: الـ bucket غير مربوط. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "bucketconnection-not-found", "title": "BucketConnection Not Found", "detail": "BucketConnection with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "BucketConnection", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/entries", "method": "PUT", "instance": "PUT /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/entries", "status": 404, "docs": "https://ghaym.me/docs/errors/bucketconnection-not-found" } ``` Source: https://ghaym.me/docs/errors/database-size-not-found.md # Database size Not Found حجم قاعدة البيانات الذي ذكره الطلب غير معروض في الـ region الذي تعمل فيه قاعدة البيانات. الكتالوج واحد لكل workspace، فالمشكلة في المفتاح، لا في الصلاحية. والـ `resourceId` يحمل المفتاح الذي بحثت عنه الـ API. وقاعدة البيانات التي تنشأ دون حجم تأخذ الحجم الأساسي، وهو لا يرفض أبدا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المفتاح خاطئ أو مختلق. - الحجم معروض في region آخر، لا في هذا: لكل region أحجامه. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - أرسل مفتاحا من `ghaym cloud regions sizes --database`. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "database-size-not-found", "title": "Database size Not Found", "detail": "Database size 'db-4096' is not available in this region", "resourceType": "Database size", "resourceId": "db-4096", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 404, "docs": "https://ghaym.me/docs/errors/database-size-not-found" } ``` Source: https://ghaym.me/docs/errors/invite-not-found.md # Invite Not Found لم تعثر الـ API على دعوة مفتوحة بهذا المعرف، أو بالـ token الخاص بهذا الرابط. على مسارات الـ workspace نفسه، الـ `resourceId` هو معرف الدعوة. وعلى مسارات الرابط، تحت `/v1/invites/`، هو الـ token، والـ token غير المعروف والملغى يبدوان متشابهين. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - قبلت الدعوة أو ألغيت: وكلاهما يحذفها. - أرسلت الدعوة مرة أخرى: الإرسال من جديد يعطيها token جديدا، ويتوقف الرابط القديم. - انتهت صلاحية الدعوة، وأزيلت بعدها بـ 7 أيام. - حذف الـ workspace الذي تخصه الدعوة. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اعرض الدعوات المفتوحة بـ `GET /v1/workspaces//members`: تجدها تحت `invites`. - اطلب دعوة جديدة من صاحب الـ workspace أو من admin. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "invite-not-found", "title": "Invite Not Found", "detail": "Invite with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "Invite", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/workspaces/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/members/invites/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "method": "DELETE", "instance": "DELETE /v1/workspaces/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/members/invites/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 404, "docs": "https://ghaym.me/docs/errors/invite-not-found" } ``` Source: https://ghaym.me/docs/errors/member-not-found.md # Member Not Found ليس في الـ workspace الذي في الـ path عضو بهذا الـ user id. هنا الـ `resourceId` هو الـ user id الذي ذكره الـ path. ومن أرسلت إليه دعوة لا يصبح عضوا حتى يقبلها. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - أزيل الشخص من الـ workspace. - أرسلت إلى الشخص دعوة ولم يقبلها، فليس له مقعد. - المعرف لدعوة أو لـ workspace، لا الـ user id الخاص بالشخص. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اعرض الأعضاء بـ `GET /v1/workspaces//members` وخذ `userId` من جوابها. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "member-not-found", "title": "Member Not Found", "detail": "Member with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "Member", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/workspaces/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/members/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "method": "DELETE", "instance": "DELETE /v1/workspaces/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/members/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 404, "docs": "https://ghaym.me/docs/errors/member-not-found" } ``` Source: https://ghaym.me/docs/errors/provider-not-found.md # Provider Not Found لم يعثر مسار للمشغلين على مزود بهذا المعرف. المشغلون وحدهم يصلون إلى المسارات التي ترسله. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. وعندما ينشأ عرض تسعير، يكون الـ `resourceId` مفتاح المزود بدلا من ذلك. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: لا يطابق أي سجل. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "provider-not-found", "title": "Provider Not Found", "detail": "Provider with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Provider", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/admin/providers/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "PATCH", "instance": "PATCH /v1/admin/providers/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/provider-not-found" } ``` Source: https://ghaym.me/docs/errors/restore-not-found.md # Restore Not Found لم تعثر الـ API على استرجاع بهذا المعرف في الـ workspace الذي أرسل منه النداء. الـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. والخدمة التي في الـ path تفحص أولا، فالخدمة غير الموجودة في الـ workspace تعيد [service-not-found](/ar/docs/errors/service-not-found) بدلا منه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف ليس الـ `restoreId` الذي رد به نداء الاسترجاع. - بدأ الاسترجاع في workspace غير الذي أرسل منه النداء. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - استعمل الـ `restoreId` من جواب نداء الاسترجاع. - أرسل `X-Ghaym-Workspace` باسم الـ workspace الذي بدأ فيه الاسترجاع. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "restore-not-found", "title": "Restore Not Found", "detail": "Restore with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "Restore", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/restores/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "method": "GET", "instance": "GET /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/restores/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 404, "docs": "https://ghaym.me/docs/errors/restore-not-found" } ``` Source: https://ghaym.me/docs/errors/service-environment-not-found.md # Service environment Not Found لم يعثر مسار للمشغلين على خدمة في هذه البيئة بهذا المعرف. المشغلون وحدهم يصلون إلى المسارات التي ترسله. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. هنا الـ `resourceId` هو `/`، ولا يعمل أي شيء من الخدمة في هذه البيئة. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: لا يطابق أي سجل. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "service-environment-not-found", "title": "Service environment Not Found", "detail": "Service environment with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "Service environment", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/abuse/admin/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/suspend", "method": "POST", "instance": "POST /v1/abuse/admin/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/suspend", "status": 404, "docs": "https://ghaym.me/docs/errors/service-environment-not-found" } ``` Source: https://ghaym.me/docs/errors/slot-not-found.md # Slot Not Found ليس لقاعدة البيانات نسخة جاهزة في هذه البيئة، فلا يوجد شيء تنسخه احتياطيا. هنا الـ `resourceId` هو `/`، والبيئة هي الـ `environmentId` الذي في الجسم. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - قاعدة البيانات لا تعمل في هذه البيئة. - قاعدة البيانات ما زالت تجهز هناك: بيانات الدخول الخاصة بها غير جاهزة. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - أرسل `environmentId` لبيئة تعمل فيها قاعدة البيانات. - وإذا كانت قاعدة البيانات جديدة، فانتظر حتى تعمل، ثم أرسل النداء مرة أخرى. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "slot-not-found", "title": "Slot Not Found", "detail": "Slot with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "Slot", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups", "status": 404, "docs": "https://ghaym.me/docs/errors/slot-not-found" } ``` Source: https://ghaym.me/docs/errors/tunnel-not-found.md # Tunnel Not Found لم تعثر الـ API على tunnel بهذا المعرف فتحه صاحب النداء. الـ tunnel ملك للشخص الذي فتحه، مهما كان الـ workspace: الـ tunnel الخاص بزميلك يعيد الـ 404 نفسه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - فتح شخص آخر الـ tunnel. - في المعرف خطأ كتابي. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - افتح tunnel خاصا بك بـ `POST /v1/services//tunnels`. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "tunnel-not-found", "title": "Tunnel Not Found", "detail": "Tunnel with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Tunnel", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/tunnels/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "DELETE", "instance": "DELETE /v1/tunnels/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 404, "docs": "https://ghaym.me/docs/errors/tunnel-not-found" } ``` Source: https://ghaym.me/docs/errors/upload-batch-not-found.md # Upload batch Not Found ليس في الـ bucket الذي في الـ path دفعة رفع بهذا المعرف بدأها صاحب النداء. لا يعثر على الدفعة إلا تحت الـ bucket الخاص بها، في الـ workspace الذي يعمل فيه النداء، للعضو الذي بدأها. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - بدأ عضو آخر الدفعة. - الدفعة على bucket غير الذي في الـ path. - أرسل النداء في workspace غير الذي فيه الدفعة: يعمل النداء في الـ workspace الذي يسميه الـ header `X-Ghaym-Workspace`، أو `?workspace=` في البث حين يغيب الـ header. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - ابدأ دفعة خاصة بك على هذا الـ bucket بـ `POST /v1/buckets//upload-batches`، واستعمل المعرف الذي يرد به. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "upload-batch-not-found", "title": "Upload batch Not Found", "detail": "Upload batch with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found", "resourceType": "Upload batch", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/complete", "method": "POST", "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/complete", "status": 404, "docs": "https://ghaym.me/docs/errors/upload-batch-not-found" } ``` Source: https://ghaym.me/docs/errors/user-not-found.md # User Not Found لم يعثر مسار للمشغلين على حساب بهذا المعرف. المشغلون وحدهم يصلون إلى المسارات التي ترسله. والـ `resourceId` يحمل المعرف الذي بحثت عنه الـ API. هنا الـ `resourceId` هو البريد الإلكتروني الذي ذكره النداء، ويطابق مهما كانت الأحرف كبيرة أو صغيرة. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - المعرف خاطئ: لا يطابق أي سجل. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "user-not-found", "title": "User Not Found", "detail": "User with ID 'someone@example.com' was not found", "resourceType": "User", "resourceId": "someone@example.com", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/abuse/admin/account/suspend", "method": "POST", "instance": "POST /v1/abuse/admin/account/suspend", "status": 404, "docs": "https://ghaym.me/docs/errors/user-not-found" } ``` Source: https://ghaym.me/docs/errors/workspace-not-found.md # Workspace Not Found الـ workspace الذي ذكره النداء ليس من الـ workspaces التي ينتمي إليها صاحب النداء، فلم ينفذ أي شيء. هنا الـ `resourceId` يحمل معرف الـ workspace الذي أرسله النداء. والـ workspace غير الموجود، والذي ليس صاحب النداء عضوا فيه، والمحذوف، كلها تعيد الـ 404 نفسه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType` و `resourceId`. ## الأسباب الشائعة - القيمة ليست معرف workspace: أرسل اسم مكان المعرف. - صاحب النداء ليس عضوا في هذا الـ workspace، أو أزيل منه. - حذف الـ workspace. ## كيف تصلح الطلب - اقرأ `resourceId` وقارنه بالقيمة التي قصدت إرسالها. - اعرض الـ workspaces الخاصة بصاحب النداء بـ `ghaym cloud workspaces list` وأرسل واحدا من هذه المعرفات. - لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء. ## مثال على الرد ```json { "type": "workspace-not-found", "title": "Workspace Not Found", "detail": "Workspace with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found", "resourceType": "Workspace", "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects", "method": "GET", "instance": "GET /v1/projects", "status": 404, "docs": "https://ghaym.me/docs/errors/workspace-not-found" } ``` Source: https://ghaym.me/docs/errors/conflict.md # Resource Conflict الطلب صحيح لكنه يتعارض مع حالة المورد الحالية، فرفضته الـ API بدل أن تنفذه. أما التعارض على قيمة مكررة فيعيد نوعا خاصا به، مثل [project-conflict](/ar/docs/errors/project-conflict). لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - نداء آخر طبق الـ changeset أو ألغاه، ثم حاول هذا الطلب استعماله. - قاعدة على المورد نفسه ترفض العملية: بيئة `production` لا تحذف. ## كيف تصلح الطلب - اقرأ `detail`، ففيه القاعدة التي رفضت الطلب. - اقرأ المورد من جديد قبل أن تقرر. حالته تغيرت، فالخطة المبنية على الحالة القديمة أصبحت قديمة. - لا تعد المحاولة دون تفكير. إذا طبق نداء آخر الـ changeset، فإعادة المحاولة لا تطبق شيئا وتخفي السباق. ## مثال على الرد ```json { "type": "conflict", "title": "Resource Conflict", "status": 409, "detail": "The changeset is no longer open", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/apply", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/apply", "docs": "https://ghaym.me/docs/errors/conflict" } ``` Source: https://ghaym.me/docs/errors/bucket-name-taken.md # Bucket Name Taken يوجد مخزن آخر له هذا الاسم أصلا، فلم تنشئ الـ API مخزنا. المخزن له اسم واحد في كل المواقع وكل الـ workspaces، وليس في هذا فقط. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code` و `name`. ## الأسباب الشائعة - يوجد مخزن في أي workspace وأي موقع يستعمل الاسم. - تسابق طلبا إنشاء بالاسم نفسه، وسبق الطلب الآخر. ## كيف تصلح الطلب - اختر اسما آخر وأنشئ المخزن من جديد. - لا تعد المحاولة بالاسم نفسه: سيبقى محجوزا ما دام ذلك المخزن موجودا. ## مثال على الرد ```json { "type": "bucket-name-taken", "title": "Bucket Name Taken", "detail": "Bucket name 'assets' is already taken", "code": "BUCKET_NAME_TAKEN", "name": "assets", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets", "method": "POST", "instance": "POST /v1/buckets", "status": 409, "docs": "https://ghaym.me/docs/errors/bucket-name-taken" } ``` Source: https://ghaym.me/docs/errors/bucket-already-connected.md # Bucket Already Connected الخدمة تقرأ مخزنا في هذه البيئة أصلا، أو لها مخزن مجهز للربط فيها، بأسماء المتغيرات التي كان هذا الربط سيستعملها، فلم تجهز الـ API شيئا. الربط يعطي الخدمة ستة متغيرات، `S3_ENDPOINT` والباقي، أو الأسماء نفسها بعد بادئة، مثل `UPLOADS_S3_ENDPOINT`. والـ `prefix` هي البادئة المطلوبة، و `null` للأسماء دون بادئة. وتطبيق الـ changeset يأخذ الجواب نفسه إذا أخذ مخزن آخر الأسماء بعد تجهيز الربط، وعندها لا يطبق أي شيء منه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `serviceId` و `prefix`. ## الأسباب الشائعة - ربط مخزن آخر بالخدمة دون بادئة، والأول يحجز الأسماء دون بادئة. - البادئة المطلوبة يحجزها ربط آخر على الخدمة في هذه البيئة، أو ربط مجهز. ## كيف تصلح الطلب - اربط مرة أخرى ببادئة لا تحجزها الخدمة: حروف كبيرة، أولها حرف، 21 حرفا على الأكثر. - اعرض روابط الخدمة في هذه البيئة عبر `GET /v1/services//buckets?environmentId=` لترى أي البادئات محجوزة؛ ودون `environmentId`، يعرض النداء روابط الـ production. - ولكي تعطي مخزنا مربوطا أسماء أخرى، اربطه مرة أخرى بالبادئة الجديدة: فينتقل إليها. ## مثال على الرد ```json { "type": "bucket-already-connected", "title": "Bucket Already Connected", "detail": "Service '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' already has a bucket connected under the bare S3_* names; pass another prefix", "code": "BUCKET_ALREADY_CONNECTED_TO_SERVICE", "serviceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "prefix": null, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/entries", "method": "PUT", "instance": "PUT /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/entries", "status": 409, "docs": "https://ghaym.me/docs/errors/bucket-already-connected" } ``` Source: https://ghaym.me/docs/errors/bucket-object-exists.md # Bucket Object Exists ملف يفترض أن يكون جديدا يسمي key فيه ملف أصلا، فلم تكتب الـ API فوقه. هذه من مسارات الرفع التي يناديها متصفح الملفات في الـ console؛ أما التطبيق الذي يكتب بمفاتيح S3 الخاصة به فيتعامل مع المخزن مباشرة ولا يراها. طلب الرفع ملفا جديدا عبر `expectNew`، وامتلأ الـ key بعد الفحص الذي سبقه. والـ `sizeBytes` و `lastModified` يصفان الملف الموجود الآن. والرفع على أجزاء يبقى مفتوحا، فتستطيع أن تستبدل به ذلك الملف أو أن تلغيه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `bucketId`، `key`، `sizeBytes` و `lastModified`. ## الأسباب الشائعة - كتب رفع آخر، أو التطبيق نفسه، الـ key نفسه بين فحص التعارض وهذا الرفع. - رفع الملف نفسه مرتين في الوقت نفسه. ## كيف تصلح الطلب - اسأل المستخدم إن كان يريد استبدال الملف الموجود، واعرض `sizeBytes` و `lastModified`. - ولكي تستبدله، وقع الرفع من جديد، أو أكمل الرفع على أجزاء، مع `expectNew` بقيمة `false`. - ولكي تبقيه، تخط الملف، وألغ الرفع على أجزاء عبر `.../uploads/abort`. ## مثال على الرد ```json { "type": "bucket-object-exists", "title": "Bucket Object Exists", "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' already holds 'uploads/report.pdf'", "code": "BUCKET_OBJECT_EXISTS", "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "key": "uploads/report.pdf", "sizeBytes": 482113, "lastModified": "2026-07-28T09:12:44.000Z", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads", "method": "POST", "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads", "status": 409, "docs": "https://ghaym.me/docs/errors/bucket-object-exists" } ``` Source: https://ghaym.me/docs/errors/project-conflict.md # Project Conflict يوجد مشروع آخر في هذا الـ workspace له قيمة `name` نفسها، فلم يكتب أي شيء. الـ `conflictField` يسمي الحقل، والـ `conflictValue` القيمة التي رفضت. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType`، `conflictField` و `conflictValue`. ## الأسباب الشائعة - يوجد مشروع آخر في هذا الـ workspace يستعمل قيمة `name` نفسها. - أرسل طلب الإنشاء نفسه مرتين ونجح الأول، فوجد الثاني نتيجته. - طلب تغيير الاسم اسما يحمله مشروع آخر في الـ workspace نفسه. ## كيف تصلح الطلب - اقرأ `conflictField` و `conflictValue`، فهما يذكران أي قيمة رفضت. - اختر قيمة `name` أخرى، أو اجلب المشروع الذي له هذه القيمة واستعمله. - وإذا كان التكرار من إعادة محاولتك أنت، فاعتبر النداء منجزا، لا فاشلا. - وأرسل header اسمه `Idempotency-Key` مع نداءات الكتابة، فتعيد المحاولة الثانية جواب الأولى بدل أن تصطدم بها. ## مثال على الرد ```json { "type": "project-conflict", "title": "Project Conflict", "detail": "A project with name 'storefront' already exists", "resourceType": "Project", "conflictField": "name", "conflictValue": "storefront", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects", "method": "POST", "instance": "POST /v1/projects", "status": 409, "docs": "https://ghaym.me/docs/errors/project-conflict" } ``` Source: https://ghaym.me/docs/errors/environment-conflict.md # Environment Conflict توجد بيئة أخرى في هذا المشروع لها قيمة `name` نفسها، فلم يكتب أي شيء. الـ `conflictField` يسمي الحقل، والـ `conflictValue` القيمة التي رفضت. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `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" } ``` Source: https://ghaym.me/docs/errors/service-conflict.md # Service Conflict توجد خدمة أخرى في هذا المشروع لها قيمة `name` نفسها، فلم يكتب أي شيء. الـ `conflictField` يسمي الحقل، والـ `conflictValue` القيمة التي رفضت. يكون `name` في كل الحالات تقريبا، وقد يصطدم موقعان أنشئا في اللحظة نفسها بالاسم نفسه على `slug` بدلا منه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType`، `conflictField` و `conflictValue`. ## الأسباب الشائعة - توجد خدمة أخرى في هذا المشروع تستعمل قيمة `name` نفسها. - أرسل طلب الإنشاء نفسه مرتين ونجح الأول، فوجد الثاني نتيجته. ## كيف تصلح الطلب - اقرأ `conflictField` و `conflictValue`، فهما يذكران أي قيمة رفضت. - اختر قيمة `name` أخرى، أو اجلب الخدمة التي لها هذه القيمة واستعملها. - وإذا كان التكرار من إعادة محاولتك أنت، فاعتبر النداء منجزا، لا فاشلا. - وأرسل header اسمه `Idempotency-Key` مع نداءات الكتابة، فتعيد المحاولة الثانية جواب الأولى بدل أن تصطدم بها. ## مثال على الرد ```json { "type": "service-conflict", "title": "Service Conflict", "detail": "A service with name 'storefront' already exists", "resourceType": "Service", "conflictField": "name", "conflictValue": "storefront", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 409, "docs": "https://ghaym.me/docs/errors/service-conflict" } ``` Source: https://ghaym.me/docs/errors/domain-conflict.md # Domain Conflict يوجد domain خاص آخر على المنصة له قيمة `hostname` نفسها، فلم يكتب أي شيء. الـ `conflictField` يسمي الحقل، والـ `conflictValue` القيمة التي رفضت. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `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" } ``` Source: https://ghaym.me/docs/errors/envvar-conflict.md # EnvVar Conflict يضبط الـ changeset متغيرا جديدا أنشأته كتابة أخرى في اللحظة نفسها، فلم يطبق أي شيء منه. الـ `conflictField` يسمي الحقل، والـ `conflictValue` القيمة التي رفضت. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType`، `conflictField` و `conflictValue`. ## الأسباب الشائعة - كتب إطلاق خدمة المفتاح نفسه أثناء تطبيق الـ changeset. تطبيق مفتاح موجود يستبدله، فهذا لا يحدث إلا مع مفتاح جديد. ## كيف تصلح الطلب - اقرأ `conflictField` و `conflictValue`، فهما يذكران أي قيمة رفضت. - طبق الـ changeset مرة أخرى: المفتاح أصبح موجودا، فستستبدل القيمة المجهزة قيمته. ## مثال على الرد ```json { "type": "envvar-conflict", "title": "EnvVar Conflict", "detail": "A envvar with key 'DATABASE_URL' already exists", "resourceType": "EnvVar", "conflictField": "key", "conflictValue": "DATABASE_URL", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/apply", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/apply", "status": 409, "docs": "https://ghaym.me/docs/errors/envvar-conflict" } ``` Source: https://ghaym.me/docs/errors/offering-conflict.md # Offering Conflict يوجد عرض تسعير آخر في الكتالوج له قيمة `plan × region × provider × adapter` نفسها، فلم يكتب أي شيء. الـ `conflictField` يسمي الحقل، والـ `conflictValue` القيمة التي رفضت. المشغلون وحدهم يصلون إلى المسار الذي يرسله. والمزود الذي لم يذكر يظهر `none`. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType`، `conflictField` و `conflictValue`. ## الأسباب الشائعة - يوجد عرض تسعير آخر في الكتالوج يستعمل قيمة `plan × region × provider × adapter` نفسها. - أرسل طلب الإنشاء نفسه مرتين ونجح الأول، فوجد الثاني نتيجته. ## كيف تصلح الطلب - اقرأ `conflictField` و `conflictValue`، فهما يذكران أي قيمة رفضت. - اختر قيمة `plan × region × provider × adapter` أخرى، أو اجلب عرض التسعير الذي له هذه القيمة واستعمله. - وإذا كان التكرار من إعادة محاولتك أنت، فاعتبر النداء منجزا، لا فاشلا. - وأرسل header اسمه `Idempotency-Key` مع نداءات الكتابة، فتعيد المحاولة الثانية جواب الأولى بدل أن تصطدم بها. ## مثال على الرد ```json { "type": "offering-conflict", "title": "Offering Conflict", "detail": "A offering with plan × region × provider × adapter 'medium × amman-1 × none × ghaym' already exists", "resourceType": "Offering", "conflictField": "plan × region × provider × adapter", "conflictValue": "medium × amman-1 × none × ghaym", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/admin/pricing/offerings", "method": "POST", "instance": "POST /v1/admin/pricing/offerings", "status": 409, "docs": "https://ghaym.me/docs/errors/offering-conflict" } ``` Source: https://ghaym.me/docs/errors/instance-size-conflict.md # Instance size Conflict يوجد حجم instance آخر في الكتالوج له قيمة `key` نفسها، فلم يكتب أي شيء. الـ `conflictField` يسمي الحقل، والـ `conflictValue` القيمة التي رفضت. المشغلون وحدهم يصلون إلى المسار الذي يرسله. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType`، `conflictField` و `conflictValue`. ## الأسباب الشائعة - يوجد حجم instance آخر في الكتالوج يستعمل قيمة `key` نفسها. - أرسل طلب الإنشاء نفسه مرتين ونجح الأول، فوجد الثاني نتيجته. ## كيف تصلح الطلب - اقرأ `conflictField` و `conflictValue`، فهما يذكران أي قيمة رفضت. - اختر قيمة `key` أخرى، أو اجلب حجم الـ instance الذي له هذه القيمة واستعمله. - وإذا كان التكرار من إعادة محاولتك أنت، فاعتبر النداء منجزا، لا فاشلا. - وأرسل header اسمه `Idempotency-Key` مع نداءات الكتابة، فتعيد المحاولة الثانية جواب الأولى بدل أن تصطدم بها. ## مثال على الرد ```json { "type": "instance-size-conflict", "title": "Instance size Conflict", "detail": "A instance size with key 'medium' already exists", "resourceType": "Instance size", "conflictField": "key", "conflictValue": "medium", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/admin/sizes", "method": "POST", "instance": "POST /v1/admin/sizes", "status": 409, "docs": "https://ghaym.me/docs/errors/instance-size-conflict" } ``` Source: https://ghaym.me/docs/errors/provider-conflict.md # Provider Conflict يوجد مزود آخر على المنصة له قيمة `key` نفسها، فلم يكتب أي شيء. الـ `conflictField` يسمي الحقل، والـ `conflictValue` القيمة التي رفضت. المشغلون وحدهم يصلون إلى المسار الذي يرسله. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `resourceType`، `conflictField` و `conflictValue`. ## الأسباب الشائعة - يوجد مزود آخر على المنصة يستعمل قيمة `key` نفسها. - أرسل طلب الإنشاء نفسه مرتين ونجح الأول، فوجد الثاني نتيجته. ## كيف تصلح الطلب - اقرأ `conflictField` و `conflictValue`، فهما يذكران أي قيمة رفضت. - اختر قيمة `key` أخرى، أو اجلب المزود الذي له هذه القيمة واستعمله. - وإذا كان التكرار من إعادة محاولتك أنت، فاعتبر النداء منجزا، لا فاشلا. - وأرسل header اسمه `Idempotency-Key` مع نداءات الكتابة، فتعيد المحاولة الثانية جواب الأولى بدل أن تصطدم بها. ## مثال على الرد ```json { "type": "provider-conflict", "title": "Provider Conflict", "detail": "A provider with key 'example-dc' already exists", "resourceType": "Provider", "conflictField": "key", "conflictValue": "example-dc", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/admin/providers", "method": "POST", "instance": "POST /v1/admin/providers", "status": 409, "docs": "https://ghaym.me/docs/errors/provider-conflict" } ``` Source: https://ghaym.me/docs/errors/invalid-deployment-state-transition.md # Invalid Deployment State Transition لا تستطيع الرجوع إلى هذا الـ deployment، لأنه ليس deployment انتهى وحل محله واحد أحدث. الرجوع يشغل image من deployment أقدم مرة أخرى، لذلك يجب أن يكون الهدف `superseded` أو `rolled_back`. والـ `from` هي حالة الهدف الفعلية، ولم يتغير شيء. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `deploymentId`، `from` و `to`. ## الأسباب الشائعة - الهدف هو الـ deployment الذي يعمل الآن. - الهدف لم ينته أصلا: فشل، أو ألغي، أو ما زال قيد البناء أو النشر. ## كيف تصلح الطلب - اعرض deployments الخدمة واختر واحدا حالته `superseded` أو `rolled_back`. - ولكي تنشر الكود الحالي من جديد، أنشئ deployment جديدا. - لا تعد الرجوع نفسه، فحالة الهدف لن تتغير وحدها. ## مثال على الرد ```json { "type": "invalid-deployment-state-transition", "title": "Invalid Deployment State Transition", "detail": "Deployment '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' cannot move from 'running' to 'deploying'", "deploymentId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "from": "running", "to": "deploying", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/deployments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/rollback", "method": "POST", "instance": "POST /v1/deployments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/rollback", "status": 409, "docs": "https://ghaym.me/docs/errors/invalid-deployment-state-transition" } ``` Source: https://ghaym.me/docs/errors/invalid-instance-state-transition.md # Invalid Instance State Transition طلب مشغل من instance انتقالا لا يستطيع إجراءه من حالته، فلم يتغير شيء. الـ instances يشغلها مشغلو غيم عبر المسارات الإدارية. والـ `from` هي حالة الـ instance الفعلية، و `to` الحالة التي طلبها النداء. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `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" } ``` Source: https://ghaym.me/docs/errors/instance-quota-exceeded.md # Instance Quota Exceeded لدى المشغل من الـ instances أقصى ما تسمح به الحصة، فلم تنشئ الـ API instance جديدا. الـ instances يشغلها مشغلو غيم عبر المسارات الإدارية. والـ `limit` هو الحصة، 2 عادة، وهو حد ثابت وليس معدلا، لذلك هو 403 وليس 429. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `userId` و `limit`. ## الأسباب الشائعة - كل أماكن الحصة فيها instance لم يهدم. ## كيف تصلح الطلب - اهدم instance لم تعد له حاجة، ثم أعد المحاولة. - لا تعد المحاولة في حلقة، فالحصة لا تفرغ وحدها. ## مثال على الرد ```json { "type": "instance-quota-exceeded", "title": "Instance Quota Exceeded", "detail": "Instance limit of 2 reached; destroy an instance or contact support to raise it", "userId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "limit": 2, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/admin/instances", "method": "POST", "instance": "POST /v1/admin/instances", "status": 403, "docs": "https://ghaym.me/docs/errors/instance-quota-exceeded" } ``` Source: https://ghaym.me/docs/errors/invalid-repo-url.md # Invalid Repository URL رابط الـ repo ليس رابط repo على GitHub، فلم تستطع الـ API قراءة الـ branches الخاصة به ولا إعداداته. الـ `repoUrl` يعيد إليك القيمة التي رفضت. وGitHub هو المصدر الوحيد الذي يبني منه غيم كلاود. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `repoUrl`. ## الأسباب الشائعة - الرابط يشير إلى host آخر: GitLab أو Bitbucket أو خادم Git خاص بك. - القيمة `owner/repo` وحدها ليست رابطا. - الرابط يشير إلى ملف أو branch داخل الـ repo، وليس إلى الـ repo نفسه. ## كيف تصلح الطلب - أرسل `https://github.com//`، ولا شيء بعد الاسم إلا `.git` إذا أردت. - اقرأ `repoUrl` لترى ما وصل بالضبط، فقد يفسد الـ shell الرابط في الطريق. - وإذا لم يكن الكود على GitHub، فقل ذلك بدل أن تجرب صيغة أخرى. ## مثال على الرد ```json { "type": "invalid-repo-url", "title": "Invalid Repository URL", "detail": "Only GitHub repository URLs are supported (e.g. https://github.com/owner/repo).", "repoUrl": "https://gitlab.com/acme/storefront", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/git/branches", "method": "GET", "instance": "GET /v1/git/branches", "status": 400, "docs": "https://ghaym.me/docs/errors/invalid-repo-url" } ``` Source: https://ghaym.me/docs/errors/repo-unavailable.md # Repository Unavailable لم يرد GitHub على قراءة الـ API للـ repo بشيء يمكن استخدامه، فالعطل عند GitHub. لا توجد مشكلة في الطلب. أما الـ repo الذي يقول GitHub إنه غير موجود فيعيد [repository-not-found](/ar/docs/errors/repository-not-found). إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `repoPath`. ## الأسباب الشائعة - كان GitHub متوقفا أو يحد من الطلبات في تلك اللحظة. - رد GitHub بخطأ آخر غير عدم الوجود. ## كيف تصلح الطلب - أعد المحاولة بعد تأخير: هذه من الحالات القليلة التي تكون فيها إعادة المحاولة دون تغيير هي الصواب. - لا تستنتج أن الـ repo غير موجود. - وإذا استمر ذلك بضع دقائق، فراجع حالة GitHub نفسه قبل أن تحمل غيم العطل. ## مثال على الرد ```json { "type": "repo-unavailable", "title": "Repository Unavailable", "detail": "Could not reach GitHub to read this repository. Please try again shortly.", "repoPath": "acme/storefront", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/git/branches", "method": "GET", "instance": "GET /v1/git/branches", "status": 502, "docs": "https://ghaym.me/docs/errors/repo-unavailable" } ``` Source: https://ghaym.me/docs/errors/invalid-installation-state.md # Invalid Installation State الـ token الذي يربط تثبيت GitHub بالشخص الذي بدأه رفض، فلم يربط شيء. الـ token موقع للمستخدم وللـ workspace اللذين بدآ الربط، وعمره 10 دقائق. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - مر أكثر من 10 دقائق بين بدئك الربط وإكماله على GitHub. - أكمل الربط مستخدم غير الذي بدأه، أو في workspace غير الذي بدأ فيه. - الـ token عدل أو ركب يدويا. ## كيف تصلح الطلب - ابدأ الربط من جديد من الـ console وأكمله مرة واحدة. - لا تركب الـ callback يدويا، فالـ token لا يمكن تخمينه. - هذه الحالة تحتاج المستخدم: الـ agent لا يستطيع إكمال تثبيت GitHub وحده. ## مثال على الرد ```json { "type": "invalid-installation-state", "title": "Invalid Installation State", "detail": "The GitHub install session is invalid or has expired. Restart the connect flow.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/git/installations/claim", "method": "POST", "instance": "POST /v1/git/installations/claim", "status": 401, "docs": "https://ghaym.me/docs/errors/invalid-installation-state" } ``` Source: https://ghaym.me/docs/errors/installation-revoked.md # Installation Revoked لم يعد GitHub يعرف تثبيت الـ GitHub App الذي كانت الـ API تستعمله، فأزالت الـ API ربطها به. زال الربط من كل workspace كان لديه، وهذا ما يعنيه الـ 410. والنداء التالي الذي يسميه يعيد [installation-not-found](/ar/docs/errors/installation-not-found). إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `installationId`. ## الأسباب الشائعة - أزيل الـ app من حساب GitHub أو من الـ organisation. - سحب صاحب الـ organisation صلاحية الـ app. ## كيف تصلح الطلب - أعد ربط GitHub من الـ console، وامنح الوصول إلى الـ repos التي تنشر منها. - لا تعد المحاولة، فالتثبيت لن يعود وحده. - وأخبر المستخدم. تثبيت GitHub App من جديد قرار صاحب الـ repo. ## مثال على الرد ```json { "type": "installation-revoked", "title": "Installation Revoked", "detail": "The GitHub App installation was removed on GitHub. Reconnect to continue.", "installationId": "48210377", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/git/installations/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/repos", "method": "GET", "instance": "GET /v1/git/installations/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/repos", "status": 410, "docs": "https://ghaym.me/docs/errors/installation-revoked" } ``` Source: https://ghaym.me/docs/errors/backups-disabled.md # Backups Are Off النسخ الاحتياطية معطلة لهذه القاعدة في هذه البيئة، فلم تأخذ الـ API نسخة. لكل بيئة مفتاحها الخاص. وعندما تعطل النسخ الاحتياطية في بيئة، تتوقف نسختها الليلية، وترفض النسخة اليدوية فيها أيضا. والنسخ التي أخذت من قبل تبقى، وتستطيع استرجاعها. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `serviceId`. ## الأسباب الشائعة - عطل أحدهم النسخ الاحتياطية لهذه القاعدة في هذه البيئة، من الـ console أو عبر `backupsEnabled: false`. ## كيف تصلح الطلب - اسأل المستخدم قبل أن تشغل النسخ الاحتياطية: هذا إعداده، والنسخة الليلية تعود للعمل معه. - ولكي تشغلها، أرسل `PATCH /v1/services/?environmentId=` مع `backupsEnabled: true`، ثم خذ النسخة؛ ودون `environmentId`، يشغل النداء نسخ الـ production. - لا تعد المحاولة دون تغيير، فالإعداد لا يتغير وحده. ## مثال على الرد ```json { "type": "backups-disabled", "title": "Backups Are Off", "detail": "Backups are switched off for this database. Turn them on first.", "serviceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups", "status": 422, "docs": "https://ghaym.me/docs/errors/backups-disabled" } ``` Source: https://ghaym.me/docs/errors/backup-in-flight.md # Backup Already Running توجد نسخة احتياطية لهذه القاعدة تنتظر أو تعمل الآن، فلم تبدأ الـ API نسخة أخرى. تعمل نسخة واحدة في كل مرة لكل قاعدة في كل بيئة، سواء كانت النسخة الليلية أو نسخة يدوية. والـ `environmentId` يسمي البيئة. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `serviceId` و `environmentId`. ## الأسباب الشائعة - كانت النسخة الليلية تعمل عندما طلبت نسخة يدوية. - طلبت نسخة يدوية مرتين، مثل نقرة مزدوجة أو إعادة محاولة بعد timeout. ## كيف تصلح الطلب - اقرأ النسخ الاحتياطية للقاعدة وانتظر حتى تصبح النسخة الجارية `ready` أو `failed`. - قد تكون النسخة الجارية هي ما يريده المستخدم: راجع وقتها قبل أن تأخذ نسخة أخرى. - لا تعد المحاولة في حلقة سريعة، فقد تستغرق النسخة دقائق. ## مثال على الرد ```json { "type": "backup-in-flight", "title": "Backup Already Running", "detail": "A backup of this database is already running. Wait for it to finish.", "serviceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "environmentId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups", "status": 409, "docs": "https://ghaym.me/docs/errors/backup-in-flight" } ``` Source: https://ghaym.me/docs/errors/backup-not-restorable.md # Backup Not Restorable لا تسترجع إلا النسخة التي حالتها `ready`، وهذه ليست كذلك، فلم تبدأ الـ API استرجاعا. تكون النسخة `pending` أو `running` أثناء أخذها، ثم `ready` أو `failed`. والـ `backupId` يسمي النسخة التي رفضت. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `backupId`. ## الأسباب الشائعة - النسخة ما زالت قيد الأخذ. - فشلت النسخة، فلا يوجد ما تسترجعه منها. ## كيف تصلح الطلب - انتظر النسخة التي حالتها `pending` أو `running` حتى تصبح `ready`، ثم استرجعها. - أو اختر نسخة أخرى حالتها `ready`. - لا تعد المحاولة على نسخة `failed`: لن تصبح `ready` أبدا. ## مثال على الرد ```json { "type": "backup-not-restorable", "title": "Backup Not Restorable", "detail": "This backup is not ready, so it cannot be restored.", "backupId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/restore", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/restore", "status": 409, "docs": "https://ghaym.me/docs/errors/backup-not-restorable" } ``` Source: https://ghaym.me/docs/errors/backup-held-by-restore.md # Backup In Use يوجد استرجاع يقرأ هذه النسخة الآن، فلم تحذفها الـ API. تستطيع حذف النسخة عندما لا يعود الاسترجاع `pending` ولا `provisioning` ولا `restoring`. ولم يتغير شيء. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `backupId`. ## الأسباب الشائعة - طلب حذف النسخة والاسترجاع منها ما زال جاريا. ## كيف تصلح الطلب - تابع الاسترجاع عبر `GET /v1/services//restores/` حتى ينتهي، ثم احذف النسخة. - لا تعد المحاولة في حلقة سريعة، فقد يستغرق الاسترجاع دقائق. ## مثال على الرد ```json { "type": "backup-held-by-restore", "title": "Backup In Use", "detail": "A restore is reading this backup. Wait for it to finish, then delete it.", "backupId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "method": "DELETE", "instance": "DELETE /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 409, "docs": "https://ghaym.me/docs/errors/backup-held-by-restore" } ``` Source: https://ghaym.me/docs/errors/backup-engine-version-unsupported.md # Engine Version No Longer Supported أخذت النسخة من إصدار لمحركها لم يعد غيم كلاود يقدمه، فلم تبدأ الـ API استرجاعا. الاسترجاع ينشئ قاعدة جديدة على إصدار النسخة نفسه، لذلك يجب أن يكون الإصدار ما زال متوفرا. وتتوفر PostgreSQL بالإصدارات 16 و 17 و 18، و MySQL بالإصدار 8.4، والـ `engineVersion` هو إصدار النسخة. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `engineVersion`. ## الأسباب الشائعة - كانت القاعدة على إصدار سحب لاحقا، وهذه النسخة من تلك الفترة. ## كيف تصلح الطلب - اختر نسخة أخذت على إصدار ما زال متوفرا، إن وجدت. - أخبر المستخدم، واذكر `engineVersion`: هذه النسخة لا يمكن استرجاعها هنا. - لا تعد المحاولة: الإصدار الذي سحب لا يعود. ## مثال على الرد ```json { "type": "backup-engine-version-unsupported", "title": "Engine Version No Longer Supported", "detail": "This backup was taken from PostgreSQL 15, which is no longer offered, so it cannot be restored.", "engineVersion": "15", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/restore", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/restore", "status": 422, "docs": "https://ghaym.me/docs/errors/backup-engine-version-unsupported" } ``` Source: https://ghaym.me/docs/errors/bucket-not-ready.md # Bucket Not Ready المخزن ليس جاهزا، فليس لدى الـ API مفتاح تعطيه ولا ملفات تعرضها. حالة المخزن تظهر في `detail` فقط: الـ API تكتب رمز الـ HTTP في `status` فوقها. اقرأ المخزن لتعرف حالته. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code` و `bucketId`. ## الأسباب الشائعة - أنشئ المخزن قبل قليل وما زال `pending` أو `provisioning`. - فشل إنشاء المخزن، فهو `failed`. - طلبت مفاتيحه، أو طلب تغييرها، قبل أن يجهز. ## كيف تصلح الطلب - اقرأ المخزن عبر `GET /v1/buckets/` وانتظر ما دام الـ `status` الخاص به `pending` أو `provisioning`، ثم أعد المحاولة. - وإذا كان الـ `status` الخاص به `failed`، فأخبر المستخدم واذكر `detail`. ## مثال على الرد ```json { "type": "bucket-not-ready", "title": "Bucket Not Ready", "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' has no credentials while it is provisioning", "code": "BUCKET_NOT_READY", "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 409, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/credentials", "method": "GET", "instance": "GET /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/credentials", "docs": "https://ghaym.me/docs/errors/bucket-not-ready" } ``` Source: https://ghaym.me/docs/errors/bucket-provisioning.md # Bucket Provisioning المخزن ما زال قيد الإنشاء، فلم تحذفه الـ API. لو حذفته الـ API الآن لبقي مخزن فارغ لا يملكه أحد. وتقبل الـ API الحذف بعد أن يجهز المخزن أو يفشل إنشاؤه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code` و `bucketId`. ## الأسباب الشائعة - أنشئ المخزن قبل قليل وما زال الـ `status` الخاص به `provisioning`. ## كيف تصلح الطلب - اقرأ المخزن عبر `GET /v1/buckets/`، وانتظر حتى يصبح الـ `status` الخاص به `ready` أو `failed`، ثم احذفه من جديد. - وإذا توقف إنشاؤه، يصبح الـ `status` الخاص به `failed` بعد 15 دقيقة وينجح الحذف. ## مثال على الرد ```json { "type": "bucket-provisioning", "title": "Bucket Provisioning", "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' is still being created; delete it once it is ready or has failed", "code": "BUCKET_PROVISIONING", "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "DELETE", "instance": "DELETE /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 409, "docs": "https://ghaym.me/docs/errors/bucket-provisioning" } ``` Source: https://ghaym.me/docs/errors/bucket-key-missing.md # Bucket Key Missing ليس للمخزن مفتاح يعرض أو يوقع به، فلم تستطع الـ API الوصول إلى ملفاته. لا يوجد ما يعيق المخزن: إصدار مفتاح جديد له بعد عودة الحساب فشل في المنتصف. وتغيير مفاتيحه يصدر مفتاحا ويحل هذا الأمر. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code` و `bucketId`. ## الأسباب الشائعة - علق الحساب ثم عاد، وفشل إصدار مفتاح جديد للمخزن في المنتصف. ## كيف تصلح الطلب - غير مفاتيح المخزن عبر `POST /v1/buckets//credentials/rotate`، ثم أعد المحاولة. - الخدمة المربوطة بالمخزن تقرأ المفتاح الجديد من الـ deploy التالي لها، فأجر لها redeploy. ## مثال على الرد ```json { "type": "bucket-key-missing", "title": "Bucket Key Missing", "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' has no key; rotate its credentials to issue one", "code": "BUCKET_KEY_MISSING", "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/objects", "method": "GET", "instance": "GET /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/objects", "status": 409, "docs": "https://ghaym.me/docs/errors/bucket-key-missing" } ``` Source: https://ghaym.me/docs/errors/bucket-suspended.md # Bucket Suspended المخزن موقوف، فرفضت الـ API أي شيء يستعمل مفتاحه أو قد يرفع التوقيف. يكون الـ `reason` هو `abuse` عندما أوقف مشغل المخزن، أو `account` عندما يكون الحساب معلقا وذهب مفتاح المخزن معه. وعرض المخازن وقراءة هذا المخزن يبقيان متاحين، فيظهر الـ `suspension` الخاص به. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `bucketId` و `reason`. ## الأسباب الشائعة - أوقف مشغل المخزن بعد بلاغ إساءة استخدام. - الحساب معلق، فسحب مفتاح كل مخزن. - قرأ النداء المفتاح أو غيره، أو غير الإعدادات، أو حذف المخزن، أو رفع، أو عرض ملفاته أو أنشأ لها روابط، والتوقيف ما زال قائما. ## كيف تصلح الطلب - لا تعد المحاولة، ولا تجرب مسارا آخر: كلها تجري الفحص نفسه. - مع `account`، يرفع التوقيف عندما يرفع تعليق الحساب: بتسديد دفعة فشلت، أو برفع حد الاستهلاك الذي بلغ، أو عندما يرفع الدعم توقيف الإساءة. - مع `abuse`، لا يرفع التوقيف إلا الدعم: اطلب من المستخدم أن يتواصل مع الدعم. ## مثال على الرد ```json { "type": "bucket-suspended", "title": "Bucket Suspended", "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' is suspended for 'abuse' and cannot be used until the hold is lifted", "code": "BUCKET_SUSPENDED", "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "reason": "abuse", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/credentials", "method": "GET", "instance": "GET /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/credentials", "status": 409, "docs": "https://ghaym.me/docs/errors/bucket-suspended" } ``` Source: https://ghaym.me/docs/errors/bucket-folder-deleting.md # Bucket Folder Deleting يوجد حذف مجلد جار على هذا المسار، فرفضت الـ API الكتابة فيه أو الحذف منه. الـ `prefix` هو المجلد الذي يحذف. الرفع عليه، وحذفه، أو حذف ملف فيه أو مجلد يحيط به، تنتظر كلها حتى ينتهي، وباقي المخزن يعمل كالمعتاد. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `bucketId` و `prefix`. ## الأسباب الشائعة - رفع ملف إلى مجلد والمجلد قيد الحذف. - حذف ملف في المجلد وحذف المجلد جار. - بدأ حذف مجلد على المجلد نفسه، أو على مجلد داخله أو يحيط به. ## كيف تصلح الطلب - تابع حذف المجلد عبر `GET /v1/buckets//folder-deletes`، وأعد المحاولة عندما ينتهي. - ارفع الملف إلى مجلد آخر إذا كان لا يستطيع الانتظار. ## مثال على الرد ```json { "type": "bucket-folder-deleting", "title": "Bucket Folder Deleting", "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' is deleting 'uploads/2025/'", "code": "BUCKET_FOLDER_DELETING", "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "prefix": "uploads/2025/", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads", "method": "POST", "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads", "status": 409, "docs": "https://ghaym.me/docs/errors/bucket-folder-deleting" } ``` Source: https://ghaym.me/docs/errors/bucket-quota-reached.md # Bucket Quota Reached امتلأ المخزن أثناء رفع الملف، فرفضه المخزن ولم يحفظ أي شيء من الملف. هذه من مسارات الرفع التي يناديها متصفح الملفات في الـ console؛ أما التطبيق الذي يكتب بمفاتيح S3 الخاصة به فيتعامل مع المخزن مباشرة ولا يراها. ويظهر عند جمع أجزاء ملف أكبر من 16 MiB، ويلغى الرفع معه. وهو 409 وليس 403: الخطأ في حالة المخزن، وليس في مقعد من ينادي. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `bucketId` و `key`. ## الأسباب الشائعة - كتب التطبيق إلى المخزن في الوقت نفسه واستهلك آخر مساحة فيه. - كان المخزن شبه ممتلئ قبل أن يبدأ الرفع. ## كيف تصلح الطلب - أفرغ مساحة بحذف ملفات لم يعد المستخدم يحتاجها، إذا وافق، ثم ارفع الملف من البداية. - أو امنح مخازن الحساب مساحة أكبر بخطة أكبر: `ghaym cloud billing set-plan --plan `. وتغيير الخطة قرار المستخدم. - لا تكمل الرفع مرة أخرى: لقد ذهب، فابدأ رفعا جديدا. ## مثال على الرد ```json { "type": "bucket-quota-reached", "title": "Bucket Quota Reached", "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' has no room left for 'videos/launch.mp4'; nothing of it was kept", "code": "BUCKET_QUOTA_REACHED", "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "key": "videos/launch.mp4", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads/complete", "method": "POST", "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads/complete", "status": 409, "docs": "https://ghaym.me/docs/errors/bucket-quota-reached" } ``` Source: https://ghaym.me/docs/errors/bucket-upload-batch-closed.md # Bucket Upload Batch Closed انتهت دفعة الرفع، فلن توقع الـ API أي شيء آخر تحتها. هذه من مسارات الرفع التي يناديها متصفح الملفات في الـ console؛ أما التطبيق الذي يكتب بمفاتيح S3 الخاصة به فيتعامل مع المخزن مباشرة ولا يراها. والدفعة تجمع ملفات رفعة واحدة. وحالة الدفعة تظهر في `detail` فقط: الـ API تكتب رمز الـ HTTP في `status` فوقها. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code` و `batchId`. ## الأسباب الشائعة - أكملت الدفعة أصلا، من هذا العميل أو من tab آخر. - انتهى آخر رابط موقع فيها والدفعة ما زالت مفتوحة، فأغلقها التنظيف الدوري. - نداء آخر يكمل الدفعة الآن: والـ `detail` يقول عندها `closing`. ## كيف تصلح الطلب - ابدأ دفعة جديدة عبر `POST /v1/buckets//upload-batches`، ووقع الملفات المتبقية تحتها. - ما وصل حفظ وسجل: اعرض المجلد قبل أن ترفع ملفا مرة أخرى. ## مثال على الرد ```json { "type": "bucket-upload-batch-closed", "title": "Bucket Upload Batch Closed", "detail": "Upload batch '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' is expired; start a new one", "code": "BUCKET_UPLOAD_BATCH_CLOSED", "batchId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 409, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads", "method": "POST", "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads", "docs": "https://ghaym.me/docs/errors/bucket-upload-batch-closed" } ``` Source: https://ghaym.me/docs/errors/bucket-upload-incomplete.md # Bucket Upload Incomplete المخزن لا يحتوي كل أجزاء الملف بحجمها الكامل، فلم تجمعها الـ API. هذه من مسارات الرفع التي يناديها متصفح الملفات في الـ console؛ أما التطبيق الذي يكتب بمفاتيح S3 الخاصة به فيتعامل مع المخزن مباشرة ولا يراها. الأجزاء تقرأ من المخزن، وليس من النداء أبدا. والـ `missingPartNumbers` يعدد الأجزاء الناقصة أو القصيرة، والرفع يبقى مفتوحا لها. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `key` و `missingPartNumbers`. ## الأسباب الشائعة - فشل رفع جزء أو انقطع، مثلا عندما ينقطع الاتصال. - أكمل الرفع قبل أن تنتهي كل الأجزاء. ## كيف تصلح الطلب - وقع الأجزاء التي في `missingPartNumbers` من جديد عبر `.../uploads/parts`، وأرسلها، ثم أكمل مرة أخرى. - لا تكمل مرة أخرى قبل أن ترسل هذه الأجزاء: سيكون الجواب نفسه. ## مثال على الرد ```json { "type": "bucket-upload-incomplete", "title": "Bucket Upload Incomplete", "detail": "'videos/launch.mp4' is missing 2 part(s)", "code": "BUCKET_UPLOAD_INCOMPLETE", "key": "videos/launch.mp4", "missingPartNumbers": [ 3, 7 ], "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads/complete", "method": "POST", "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads/complete", "status": 409, "docs": "https://ghaym.me/docs/errors/bucket-upload-incomplete" } ``` Source: https://ghaym.me/docs/errors/bucket-upload-not-open.md # Bucket Upload Not Open الدفعة لا تحتوي رفعا على أجزاء لهذا الـ key، فلم توقع الـ API أي جزء ولم تجمع شيئا. هذه من مسارات الرفع التي يناديها متصفح الملفات في الـ console؛ أما التطبيق الذي يكتب بمفاتيح S3 الخاصة به فيتعامل مع المخزن مباشرة ولا يراها. الملف الأكبر من 16 MiB يرفع على أجزاء، ورفعه يفتح عند توقيع الملف. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `batchId` و `key`. ## الأسباب الشائعة - لم يوقع الملف في هذه الدفعة أبدا، أو وقع قطعة واحدة لأنه 16 MiB أو أقل. - رفعه أكمل أو ألغي أصلا. ## كيف تصلح الطلب - وقع الملف من جديد عبر `.../uploads` لكي يفتح رفعه، ثم أرسل أجزاءه. - وإذا كان قد أكمل، فالملف في المخزن أصلا: اعرض المجلد لتتأكد. ## مثال على الرد ```json { "type": "bucket-upload-not-open", "title": "Bucket Upload Not Open", "detail": "Upload batch '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' has no open multipart upload for 'videos/launch.mp4'", "code": "BUCKET_UPLOAD_NOT_OPEN", "batchId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "key": "videos/launch.mp4", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads/parts", "method": "POST", "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/uploads/parts", "status": 409, "docs": "https://ghaym.me/docs/errors/bucket-upload-not-open" } ``` Source: https://ghaym.me/docs/errors/database-provisioning.md # Database Provisioning القاعدة ما زالت قيد الإنشاء في هذه البيئة، فلم يفتح أي tunnel. الـ `service` و `environment` يسميان القاعدة والبيئة التي طلبت فيها. والـ CLI يخرج بالرمز 5. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `service` و `environment`. ## الأسباب الشائعة - أنشئت القاعدة، أو البيئة، قبل قليل. - توجد إعادة لتجهيز كان فاشلا أو موقوفا، وهي جارية. ## كيف تصلح الطلب - انتظر حتى تجهز القاعدة، ثم شغل الأمر نفسه مرة أخرى. - اترك فترة بين كل محاولة وأخرى بدل أن تعيد في حلقة سريعة. ## مثال على الرد ```json { "type": "database-provisioning", "title": "Database Provisioning", "detail": "orders-db is still provisioning in staging.", "service": "orders-db", "environment": "staging", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 409, "docs": "https://ghaym.me/docs/errors/database-provisioning" } ``` Source: https://ghaym.me/docs/errors/database-failed.md # Database Failed To Provision فشل تجهيز القاعدة في هذه البيئة، فلا يوجد ما يصل إليه الـ tunnel. الـ `service` و `environment` يسميان القاعدة والبيئة التي طلبت فيها. والـ CLI يخرج بالرمز 5. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `service` و `environment`. ## الأسباب الشائعة - توقف تجهيز القاعدة في هذه البيئة على خطأ. ## كيف تصلح الطلب - أعد التجهيز، ثم اتصل عندما تجهز القاعدة. الأمر `ghaym cloud services retry-provisioning ` يعيد التجهيز في الـ production فقط؛ ولأي بيئة أخرى، أرسل `POST /v1/services//provisioning/retry?environmentId=`. - وإذا فشل مرة أخرى، فأخبر المستخدم واذكر `detail`. ## مثال على الرد ```json { "type": "database-failed", "title": "Database Failed To Provision", "detail": "orders-db failed to provision in staging.", "service": "orders-db", "environment": "staging", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 409, "docs": "https://ghaym.me/docs/errors/database-failed" } ``` Source: https://ghaym.me/docs/errors/database-cap-blocked.md # Plan Full لا تستطيع القاعدة العمل لأن حد الموارد في الخطة ممتلئ، فلم تفتح الـ API أي tunnel. أرقام الحد لا تأتي إلا عندما كان إيقاظ القاعدة سيتجاوز الحد، وتقرأ كما في [plan-compute-cap-exceeded](/ar/docs/errors/plan-compute-cap-exceeded). والقاعدة التي أوقفها الحد عند التجهيز ترسل `service` و `environment` فقط. والـ CLI يخرج بالرمز 7. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `service`، `environment`، `planKey`، `unit`، `capValue`، `currentTotal` و `projectedTotal`. ## الأسباب الشائعة - أوقفت القاعدة عند التجهيز لأن الخطة لا تتسع لها. - طلب النداء إيقاظ القاعدة، وكان إيقاظها سيتجاوز بالحساب حده. ## كيف تصلح الطلب - أفرغ مساحة أولا: اجعل خدمة أخرى تنام، أو أوقف واحدة، أو اختر حجما أصغر. - أو انتقل إلى خطة حدها أعلى: `ghaym cloud billing set-plan --plan `. وتغيير الخطة قرار المستخدم. - والقاعدة التي أوقفت عند التجهيز تحتاج إعادة تجهيز عندما تتوفر مساحة. الأمر `ghaym cloud services retry-provisioning ` يعيد التجهيز في الـ production فقط؛ ولأي بيئة أخرى، أرسل `POST /v1/services//provisioning/retry?environmentId=`. ## مثال على الرد ```json { "type": "database-cap-blocked", "title": "Plan Full", "detail": "orders-db can't start: your plan is full.", "service": "orders-db", "environment": "staging", "planKey": "solo", "unit": "ram-gb", "capValue": 8, "currentTotal": 8, "projectedTotal": 9, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 402, "docs": "https://ghaym.me/docs/errors/database-cap-blocked" } ``` Source: https://ghaym.me/docs/errors/database-suspended.md # Database Suspended القاعدة معلقة، فلم تفتح الـ API لها tunnel. الـ `reason` يبين السبب: `payment_failed` أو `usage_limit` أو `exposure_ceiling` أو `abuse`، أو `null` عندما لم يسجل سبب. والـ CLI يخرج بالرمز 7. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `service`، `environment` و `reason`. ## الأسباب الشائعة - فشلت دفعة وعلق الحساب: `payment_failed`. - بلغ الحساب حد الاستهلاك الذي وضعه بنفسه: `usage_limit`. - أوقف مشغل القاعدة أو الحساب: `abuse`. ## كيف تصلح الطلب - مع `payment_failed`، تحتاج فوترة الحساب إلى تسديد؛ ومع `usage_limit`، يحتاج الحد إلى رفع. وكلاهما قرار المستخدم. - مع `abuse`، لا يرفع التوقيف إلا الدعم. - لا تعد المحاولة قبل رفع التوقيف: الجواب لن يتغير. ## مثال على الرد ```json { "type": "database-suspended", "title": "Database Suspended", "detail": "orders-db is suspended in staging.", "service": "orders-db", "environment": "staging", "reason": "payment_failed", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 402, "docs": "https://ghaym.me/docs/errors/database-suspended" } ``` Source: https://ghaym.me/docs/errors/database-stopped.md # Database Stopped أوقف أحدهم القاعدة في هذه البيئة، فلم تفتح الـ API أي tunnel. الـ `service` و `environment` يسميان القاعدة والبيئة التي طلبت فيها. والـ `--wake` يوقظ القاعدة النائمة، ولا يوقظ الموقوفة أبدا. والـ CLI يخرج بالرمز 5. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `service` و `environment`. ## الأسباب الشائعة - أوقف عضو القاعدة من الـ console أو من الـ API. - أعطي `--wake`، لكن القاعدة موقوفة وليست نائمة. ## كيف تصلح الطلب - اسأل المستخدم قبل أن تشغلها: أوقفت عن قصد. - ولكي تشغلها، أرسل `POST /v1/services//start?environmentId=`، ثم شغل الأمر نفسه مرة أخرى؛ ودون `environmentId`، يشغل النداء الـ production. ## مثال على الرد ```json { "type": "database-stopped", "title": "Database Stopped", "detail": "orders-db is stopped in staging.", "service": "orders-db", "environment": "staging", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 409, "docs": "https://ghaym.me/docs/errors/database-stopped" } ``` Source: https://ghaym.me/docs/errors/database-asleep.md # Database Asleep القاعدة نائمة والنداء لم يطلب إيقاظها، فلم تفتح الـ API أي tunnel. فتح الـ tunnel لا يوقظ القاعدة خفية أبدا. والـ `flag` يسمي خيار الـ CLI الذي يوقظها. والـ CLI يخرج بالرمز 5. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `service`، `environment` و `flag`. ## الأسباب الشائعة - نامت بيئة القاعدة، ونامت القاعدة معها. - انقطع الـ tunnel مدة كافية لتنام القاعدة قبل أن يفتح من جديد. ## كيف تصلح الطلب - شغل الأمر مرة أخرى مع `--wake`: `ghaym cloud connect orders-db --env staging --wake`. - ومن الـ API، أرسل `wake: true` في الـ body الذي يفتح الـ tunnel. - وما دام الـ tunnel مفتوحا، تحسب القاعدة مستعملة وتبقى مستيقظة. ## مثال على الرد ```json { "type": "database-asleep", "title": "Database Asleep", "detail": "orders-db is asleep in staging. Add --wake to wake it and connect.", "service": "orders-db", "environment": "staging", "flag": "--wake", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 409, "docs": "https://ghaym.me/docs/errors/database-asleep" } ``` Source: https://ghaym.me/docs/errors/tunnel-closed.md # Tunnel Closed انتهى الـ tunnel ولن يعود، فرفضت الـ API الـ heartbeat الخاص به. الـ `reason` يبين ما أنهاه، و `openSeconds` المدة التي بقي فيها مفتوحا، و `keyName` الـ API key الذي فتح به، و `null` دون مفتاح. والـ `workspaceName` لا يأتي عندما يكون الـ workspace قد حذف. والـ tunnel يعيش على lease مدته 90 ثانية، وكل heartbeat يجدده. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `tunnelId`، `reason`، `openSeconds`، `keyName` و `workspaceName`. ## الأسباب الشائعة - `closed`: أغلق الـ tunnel، مثلا بـ Ctrl-C. - `connection_lost`: لم يصل heartbeat قبل أن ينتهي الـ lease. والـ CLI يفتح tunnel جديدا مكانه. - `key_revoked` أو `member_removed` أو `role_changed`: المفتاح أو المقعد الذي فتح به لم يعد يسمح بالاتصال، والـ CLI يخرج بالرمز 3. - `database_deleted` أو `environment_deleted`: حذفت القاعدة أو بيئتها، والـ CLI يخرج بالرمز 4. - `database_stopped`: أوقفت القاعدة، والـ CLI يخرج بالرمز 5. - `workspace_suspended`: علق الـ workspace، والـ CLI يخرج بالرمز 7. ## كيف تصلح الطلب - بعد `closed` أو `connection_lost`، افتح tunnel جديدا؛ والـ CLI يفعل ذلك وحده للذي انقطع. - وبعد أي `reason` آخر، أصلح ما يسميه قبل أن تفتح واحدا جديدا: مفتاح جديد، أو عودة المقعد، أو قاعدة تعمل. - لا ترسل heartbeats أخرى لهذا الـ tunnel: سيبقى مغلقا. ## مثال على الرد ```json { "type": "tunnel-closed", "title": "Tunnel Closed", "detail": "The tunnel is closed: key_revoked.", "tunnelId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "reason": "key_revoked", "openSeconds": 1843, "keyName": "laptop", "workspaceName": "Acme", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/tunnels/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/heartbeat", "method": "POST", "instance": "POST /v1/tunnels/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/heartbeat", "status": 410, "docs": "https://ghaym.me/docs/errors/tunnel-closed" } ``` Source: https://ghaym.me/docs/errors/service-suspended.md # Service Suspended الخدمة معلقة في هذه البيئة، فلم تشغلها الـ API ولم تجر لها deploy ولم ترجعها. التعليق من المنصة، وليس من المستخدم، والتشغيل لا يرفعه. والخدمة تعود للعمل وحدها عندما يرفع التعليق. والـ `environmentId` يسمي البيئة التي هي معلقة فيها. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `serviceId` و `environmentId`. ## الأسباب الشائعة - فشلت دفعة، أو بلغ الحساب حد الاستهلاك الخاص به، فعلقت خدمات الحساب معه. - أوقف مشغل الخدمة. ## كيف تصلح الطلب - أخبر المستخدم، واذكر `detail`: تسديد الحساب يرفع تعليق الدفعة التي فشلت، ورفع الحد يرفع تعليق حد الاستهلاك، والدعم يرفع توقيف المشغل. - لا تشغل ولا تجر deploy ولا ترجع مرة أخرى قبل رفع التعليق: كلها ترفض بالطريقة نفسها. ## مثال على الرد ```json { "type": "service-suspended", "title": "Service Suspended", "detail": "This service is suspended and cannot be started. Settle the account, or ask support to lift the hold, and it starts back on its own.", "serviceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "environmentId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/start", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/start", "status": 409, "docs": "https://ghaym.me/docs/errors/service-suspended" } ``` Source: https://ghaym.me/docs/errors/provisioning-not-retryable.md # Provisioning Not Retryable القاعدة ليست موقوفة ولا فاشلة في هذه البيئة، فلا يوجد تجهيز تعيده، ولم تغير الـ API شيئا. لا يعاد إلا تجهيز القاعدة التي حالة تجهيزها `cap_blocked` أو `failed`، والـ `provisionStatus` يبين أين هي الآن. والأمر `ghaym cloud services retry-provisioning ` يرسل هذا النداء. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `serviceId`، `environmentId` و `provisionStatus`. ## الأسباب الشائعة - القاعدة `ready` أصلا، أو عادت إلى `pending` أو `provisioning`. - أرسلت إعادتان في الوقت نفسه وسبقت الأخرى: والـ `provisionStatus` يكون عندها `pending`. - القاعدة تعمل لكنها تتعطل باستمرار (`crash_looping`): التجهيز نجح، فلا يوجد ما تعيده. - لم يرسل النداء `environmentId`، كما هو حال الأمر `ghaym cloud services retry-provisioning ` دائما، فوصل إلى الـ production، والقاعدة الموقوفة أو الفاشلة في بيئة أخرى. ## كيف تصلح الطلب - اقرأ الخدمة واعمل على أساس حالتها: انتظر ما دامت `pending` أو `provisioning`. - ولكي تعيد التجهيز في البيئة التي القاعدة موقوفة أو فاشلة فيها، أرسل `POST /v1/services//provisioning/retry?environmentId=`. - وللقاعدة التي تتعطل باستمرار، اقرأ سجلاتها عبر `ghaym cloud services logs `، أو اختر حجما أكبر إذا كانت الذاكرة تنفد. ## مثال على الرد ```json { "type": "provisioning-not-retryable", "title": "Provisioning Not Retryable", "detail": "This database slot is 'ready'; provisioning can only be retried from cap_blocked or failed.", "serviceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "environmentId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad403", "provisionStatus": "ready", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/provisioning/retry", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/provisioning/retry", "status": 409, "docs": "https://ghaym.me/docs/errors/provisioning-not-retryable" } ``` Source: https://ghaym.me/docs/errors/exposure-ceiling-exceeded.md # Exposure Ceiling Exceeded بلغ استهلاك هذا الشهر السقف الذي وضعته الفوترة على ما يمكن أن يستدينه الحساب، فلم تبدأ الـ API أي شيء جديد. هذا ليس حد الاستهلاك الذي يضعه الحساب بنفسه: الفوترة تضع هذا السقف، ولا يحركه إلا تسديد المبلغ المفتوح، أو رفع الدعم له. وكذلك ما يزيد السعة دون deploy: بيئة جديدة في مشروع فيه قاعدة بيانات، ونشر changeset يضيف نسخة من قاعدة أو يرفع عدد الـ replicas أو الـ readers، وتغيير حجم قاعدة إلى ذاكرة أكبر، وإعادة محاولة التجهيز. والمبالغ نصوص بعملة `currency`، بخاناتها العشرية: ثلاث للدينار، واثنتان للريال. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `currency`، `usageJod`، `exposureCeilingJod` و `billingUrl`. ## الأسباب الشائعة - استهلك الحساب هذا الشهر أقصى ما تسمح له الفوترة باستدانته، وكان إطلاق أو deploy أو تشغيل أو إيقاظ أو تغيير يزيد السعة سيزيد عليه. ## كيف تصلح الطلب - اطلب من المستخدم أن يسدد المبلغ المفتوح على `billingUrl`، أو أن يتواصل مع الدعم ليرفعوا السقف. وكلاهما في يده. - الخدمات التي تعمل تبقى تعمل: الاستهلاك الجديد فقط يرفض. - لا تعد المحاولة قبل أن يسدد المبلغ المفتوح: الجواب لن يتغير. ## مثال على الرد ```json { "type": "exposure-ceiling-exceeded", "title": "Exposure Ceiling Exceeded", "detail": "This month's usage (250.000 JOD) has reached the 250.000 JOD exposure ceiling on this account. Settle the open balance at https://auth.ghaym.me/account/billing, or contact support to have the ceiling raised.", "currency": "JOD", "usageJod": "250.000", "exposureCeilingJod": "250.000", "billingUrl": "https://auth.ghaym.me/account/billing", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "status": 402, "docs": "https://ghaym.me/docs/errors/exposure-ceiling-exceeded" } ``` Source: https://ghaym.me/docs/errors/github-authorization-failed.md # GitHub Authorization Failed رفض GitHub أن يكمل تسجيل الدخول الذي بدأه الربط، فلم يربط شيء. الـ `reason` هو رمز الخطأ الخاص بـ GitHub نفسه، أو `no-access-token`. وهو 400 وليس 401، لكي يبقي الـ console المستخدم مسجلا الدخول في غيم. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `reason`. ## الأسباب الشائعة - الرمز الذي أعاده GitHub كان قد استعمل، أو انتهى. - اكتمل الربط من تبويب قديم أو بعد إعادة تحميل. - إعدادات الـ GitHub App في النسخة لا تطابق العنوان الذي عاد إليه GitHub. ## كيف تصلح الطلب - ابدأ الربط من جديد من الـ console، أو عبر `ghaym cloud git install`، وأكمله مرة واحدة. - هذه الحالة تحتاج المستخدم: الـ agent لا يستطيع أن يكمل تسجيل الدخول في GitHub وحده. ## مثال على الرد ```json { "type": "github-authorization-failed", "title": "GitHub Authorization Failed", "detail": "GitHub did not complete the authorization. Start the connect flow again.", "reason": "bad_verification_code", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/git/installations/connect", "method": "POST", "instance": "POST /v1/git/installations/connect", "status": 400, "docs": "https://ghaym.me/docs/errors/github-authorization-failed" } ``` Source: https://ghaym.me/docs/errors/custom-domain-required.md # Connect a domain first to turn off the ghaym.app address. التغيير يطلب من الخدمة ألا تجيب إلا على الـ domains الخاصة بها، ولن يجيب أي منها في هذه البيئة، فلم تغير الـ API شيئا. الـ `environmentName` يسمي البيئة. والفحص يجري عندما يجهز التغيير، ومرة أخرى عندما يطبق، لأن domain قد يزال، أو قد يتحرك الـ DNS الخاص به، في المنتصف. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `environmentName`. ## الأسباب الشائعة - وضع `--reach custom-domain` لبيئة ليس فيها للخدمة أي domain يعمل. - الخدمة خاصة هناك، ولا يشير أي domain من الـ domains الخاصة بها إلى غيم بعد، فلن يجيب أي منها عندما تفتح. - أزيل domain، أو تحرك الـ DNS الخاص به، بعد أن جهز التغيير، فرفض تطبيقه. ## كيف تصلح الطلب - أضف domain عبر `ghaym cloud domains add `، وتحقق منه عبر `ghaym cloud domains verify `، ثم ضع `--reach custom-domain` مرة أخرى. - أو أبق عنوان ghaym.app مفتوحا عبر `--reach public`. - وإذا رفض التطبيق، فأصلح الـ DNS الخاص بالـ domain، ثم طبق التغييرات مرة أخرى. ## مثال على الرد ```json { "type": "custom-domain-required", "title": "Connect a domain first to turn off the ghaym.app address.", "detail": "The service has no live custom domain in staging, so it would have no address there", "environmentName": "staging", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/entries", "method": "PUT", "instance": "PUT /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/entries", "status": 409, "docs": "https://ghaym.me/docs/errors/custom-domain-required" } ``` Source: https://ghaym.me/docs/errors/ip-allowlist-while-private.md # The IP list has no effect while the service is private. Undo private first. التغيير يضع قائمة IP في مكان تكون فيه الخدمة خاصة، والخدمة الخاصة ليس لها عنوان عام تصفيه القائمة، فلم تجهز الـ API شيئا. الـ `environmentName` يسمي البيئة. والوصول المعتبر هو المجهز لها، أو المنشور إذا لم يكن هناك شيء مجهز. وجعل الخدمة خاصة يزيل أيضا أي تغيير في قائمة الـ IP كان ينتظر. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `environmentName`. ## الأسباب الشائعة - الخدمة خاصة في هذه البيئة، و `ghaym cloud access ips add` أو `ips remove` جهز لها قائمة. - الوضع الخاص مجهز وينتظر التطبيق، وجاءت القائمة بعده. ## كيف تصلح الطلب - أزل الوضع الخاص أولا: جهز وصولا آخر عبر `ghaym cloud access set --reach public --env `، ثم أضف القائمة. - أو أبق الخدمة خاصة: لا تصل إليها إلا خدمات المشروع، فلا تحتاج قائمة. - لا تعد الطلب نفسه، فالجواب يبقى نفسه ما دامت الخدمة خاصة. ## مثال على الرد ```json { "type": "ip-allowlist-while-private", "title": "The IP list has no effect while the service is private. Undo private first.", "detail": "The service is private in staging, so an IP list would have no effect there", "environmentName": "staging", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/entries", "method": "PUT", "instance": "PUT /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/environments/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/changeset/entries", "status": 409, "docs": "https://ghaym.me/docs/errors/ip-allowlist-while-private" } ``` Source: https://ghaym.me/docs/errors/last-domain-custom-only.md # This is the last live domain here, and the ghaym.app address is off. Turn it on first. الـ domain هو آخر domain يعمل لبيئة لا تجيب إلا على الـ domains الخاصة بها، فأبقته الـ API بدل أن تترك الخدمة دون عنوان. الـ `hostname` يسمي الـ domain. والـ domain الذي لا يعمل لا يأخذ معه عنوانا، فيزال دائما. والتغيير المجهز للـ domains فقط لا يمنع الإزالة، وتطبيقه يفحص من جديد. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `hostname`. ## الأسباب الشائعة - البيئة لا تجيب إلا على الـ domains الخاصة بها، وقد وضعت بـ `--reach custom-domain`، وهذا الـ domain الوحيد الذي يعمل فيها. - أخذت إزالة أخرى الـ domain الآخر الذي يعمل للبيئة من قبل. ## كيف تصلح الطلب - أعد تشغيل عنوان ghaym.app عبر `ghaym cloud access set --reach public --env `، وطبقه، ثم أزل الـ domain. - أو اجعل الخدمة خاصة أولا عبر `--reach private`، إذا لم يكن هناك ما يلزم أن يصل إليها من خارج المشروع. - أو أضف الـ domain الجديد وتحقق منه قبل أن تزيل القديم. ## مثال على الرد ```json { "type": "last-domain-custom-only", "title": "This is the last live domain here, and the ghaym.app address is off. Turn it on first.", "detail": "shop.example.com is the last live domain of an environment open on its custom domains only; turn the ghaym.app address back on or make it private first", "hostname": "shop.example.com", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/domains/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "method": "DELETE", "instance": "DELETE /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/domains/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 409, "docs": "https://ghaym.me/docs/errors/last-domain-custom-only" } ``` Source: https://ghaym.me/docs/errors/approval-not-pending.md # Approval Not Pending كانت الموافقة قد قبلت أو رفضت أو انتهت، فلا يقرر فيها مرة أخرى ولم ينفذ شيء. حالة الموافقة تظهر في `detail` فقط: الـ API تكتب رمز الـ HTTP في `status` فوقها. والموافقة التي تجاوزت `expiresAt` الخاص بها تصبح `expired` حالما يقرؤها أحد. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `approvalId`. ## الأسباب الشائعة - كانت قد قبلت أو رفضت، من الـ console أو الـ CLI أو من تبويب آخر. - لم يقرر فيها أحد في وقتها: الموافقة تعيش 24 ساعة عادة. ## كيف تصلح الطلب - اقرأها عبر `ghaym cloud approvals get ` لترى ما تقرر وما نفذ. - وإذا انتهت أو رفضت والتغيير ما زال مطلوبا، فأرسل النداء الأصلي مرة أخرى: سيطلب موافقة جديدة. - لا تعد القرار، فالجواب لن يتغير. ## مثال على الرد ```json { "type": "approval-not-pending", "title": "Approval Not Pending", "detail": "Approval 0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402 is 'expired' and can no longer be decided. Only a pending approval can be approved or denied.", "approvalId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 409, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/approve", "method": "POST", "instance": "POST /v1/approvals/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/approve", "docs": "https://ghaym.me/docs/errors/approval-not-pending" } ``` Source: https://ghaym.me/docs/errors/approval-operation-unknown.md # Approval Operation Unknown النداء الذي قبل يسمي عملية لم تعد الـ API تنفذها، فلم ينفذ شيء، مع أن الموافقة تبقى مقبولة. لا يعود كجواب خطأ. الموافقة تعيد 200 مع الموافقة نفسها، والتي يكون `execution` الخاص بها `failed` ويحتوي `error` فيها هذا النوع والعنوان و `detail` و `operation` فقط. الـ `detail` يقول ارفضها، لكن الموافقة المقبولة لا يمكن رفضها: تعيد [approval-not-pending](/ar/docs/errors/approval-not-pending). إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `operation`. ## الأسباب الشائعة - حجز النداء قبل تحديث للـ API أزال عمليته، وقبل بعده. ## كيف تصلح الطلب - أرسل النداء الأصلي مرة أخرى، لكي يحجز أو ينفذ بعملية تعرفها الـ API. - وأخبر المستخدم أن التغيير الذي وافق عليه لم يحدث، واذكر `operation`. ## مثال ```json { "type": "approval-operation-unknown", "title": "Approval Operation Unknown", "detail": "Operation 'environment.clone' is no longer supported, so this approval cannot be executed. Deny it and issue the call again.", "operation": "environment.clone" } ``` Source: https://ghaym.me/docs/errors/plan-limit-exceeded.md # Plan Limit Exceeded خطة الحساب لا تسمح بواحد آخر من هذا النوع، فلم تنشئ الـ API أي شيء. الـ `limit` يسمي الحد، و `limitValue` ما تسمح به الخطة، و `currentCount` ما لدى الحساب أصلا. والحل تغيير الخطة أو إزالة واحد، وليس بطاقة أبدا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `planKey`، `limit`، `limitValue` و `currentCount`. ## الأسباب الشائعة - لدى الحساب من المشاريع أو الخدمات أو buckets أو الأعضاء أقصى ما تسمح به الخطة، أو لدى المشروع من البيئات أقصى ما تسمح به، أو تحمل buckets الحساب من GB أقصى ما تسمح به الخطة. ومع الـ buckets، يكون الـ `code` هو `CAP_BLOCKED`. - استعلام سجلات يعود إلى الوراء أبعد مما تحفظه الخطة، أو النداء يطلب نسخا أو نسخا احتياطية يدوية أكثر مما تسمح به الخطة. ## كيف تصلح الطلب - أخبر المستخدم أي حد انتهى، من `limit` و `limitValue` و `currentCount`. - أزل واحدا لم تعد له حاجة، إذا وافق المستخدم، ثم أعد المحاولة. - أو انتقل إلى خطة فيها مجال أكبر: `ghaym cloud billing set-plan --plan `. وتغيير الخطة قرار المستخدم. - لا تعد المحاولة دون تغيير، فالعدد لا ينخفض وحده. والـ 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" } ``` Source: https://ghaym.me/docs/errors/plan-compute-cap-exceeded.md # Plan Compute Cap Exceeded التغيير كان سيجعل RAM أو vCPUs مستيقظة في الوقت نفسه أكثر مما تسمح به خطة الحساب، فلم تغير الـ API شيئا. الـ `unit` إما `ram-gb` وإما `vcpu`، و `capValue` حد الخطة، و `currentTotal` ما هو مستيقظ الآن، و `projectedTotal` ما يحتاجه التغيير. والحد لا يعد إلا ما هو مستيقظ، ولا يوقف إلا الزيادة: ما يعمل يبقى يعمل. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `planKey`، `unit`، `capValue`، `currentTotal` و `projectedTotal`. ## الأسباب الشائعة - أول deploy، أو تشغيل، أو إيقاظ، أو خدمة جديدة، كان سيشغل موارد فوق الحد. - حجم أكبر أو نسخ أكثر كانت ستزيد ما هو مستيقظ فوق الحد. ## كيف تصلح الطلب - أفرغ مساحة أولا: اجعل خدمة تنام، أو أوقف واحدة، أو اختر حجما أصغر. كل واحد منها يفرغ حصته فورا. - أو انتقل إلى خطة حدها أعلى: `ghaym cloud billing set-plan --plan `. وتغيير الخطة قرار المستخدم. - أخبر المستخدم بالأرقام، من `capValue` و `currentTotal` و `projectedTotal`. ## مثال على الرد ```json { "type": "plan-compute-cap-exceeded", "title": "Plan Compute Cap Exceeded", "detail": "The solo plan allows 8 GB of RAM across everything awake at once; this change would need 9, and 7 is awake already. Put a service to sleep, stop one, choose a smaller size, or move to a plan with more headroom with PUT /v1/billing/account/plan.", "planKey": "solo", "unit": "ram-gb", "capValue": 8, "currentTotal": 7, "projectedTotal": 9, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "status": 402, "docs": "https://ghaym.me/docs/errors/plan-compute-cap-exceeded" } ``` Source: https://ghaym.me/docs/errors/abuse-report-not-pending.md # Abuse Report Already Decided حاول مشغل أن يقرر في بلاغ إساءة كان قد حل أو رفض، فلم يتغير شيء. لا يصل إلا المشغلون إلى المسارات التي ترسله. والـ `reportId` يسمي البلاغ. وحالة البلاغ تظهر في `detail` فقط: الـ API تكتب رمز الـ HTTP في `status` فوقها. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `reportId`. ## الأسباب الشائعة - قرر فيه مشغل آخر من قبل. - أرسل نداء الحل أو الرفض مرتين. ## كيف تصلح الطلب - اقرأ البلاغ لترى ما تقرر فيه. - لا تعد المحاولة، فالبلاغ الذي قرر فيه يبقى كذلك. ## مثال على الرد ```json { "type": "abuse-report-not-pending", "title": "Abuse Report Already Decided", "detail": "This abuse report was already dismissed; it cannot be decided again.", "reportId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 409, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/abuse/admin/reports/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/resolve", "method": "POST", "instance": "POST /v1/abuse/admin/reports/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/resolve", "docs": "https://ghaym.me/docs/errors/abuse-report-not-pending" } ``` Source: https://ghaym.me/docs/errors/not-abuse-suspended.md # Not Abuse-Suspended طلب مشغل رفع تعليق إساءة عن شيء غير معلق بسبب إساءة، فلم يتغير شيء. لا يصل إلا المشغلون إلى المسارات التي ترسله. والـ `subject` إما `Billing account` أو `Service environment` أو `Bucket`، والـ `id` يسميه، والـ `currentReason` هو التعليق المفروض عليه، أو `null` إذا لم يكن عليه شيء. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `subject`، `id` و `currentReason`. ## الأسباب الشائعة - الحساب معلق بسبب `payment_failed` أو `usage_limit`، وما يرفعهما هو المال، وليس هذا المسار. - ليس معلقا أصلا، أو كان تعليقه قد رفع. ## كيف تصلح الطلب - اقرأ `currentReason`: تعليق الدفع ينتهي عندما تقول الفوترة إن وضع الحساب سليم وإن لديه طريقة دفع، وتعليق حد الاستهلاك عندما يعود استهلاك الشهر تحت الحد: في شهر جديد، أو عندما يرفع الحد أو يزال. - لا تعد المحاولة، فهذه المسارات لا ترفع إلا تعليق الإساءة. ## مثال على الرد ```json { "type": "not-abuse-suspended", "title": "Not Abuse-Suspended", "detail": "Billing account '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' is suspended for 'payment_failed', which this endpoint may not lift. Only an abuse suspension can be resumed here.", "subject": "Billing account", "id": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "currentReason": "payment_failed", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/abuse/admin/account/resume", "method": "POST", "instance": "POST /v1/abuse/admin/account/resume", "status": 409, "docs": "https://ghaym.me/docs/errors/not-abuse-suspended" } ``` Source: https://ghaym.me/docs/errors/account-suspended.md # Account Suspended الحساب معلق، فلن تطلق الـ API ولن تجري deploy لأي شيء عليه حتى يرفع التعليق. الـ `reason` يبين السبب، ومن ثم ما يرفعه. ولا يعد تنازليا إلا `payment_failed` عبر `retentionDaysRemaining`، وهي الأيام الباقية قبل أن تحذف بيانات الحساب. أما `usage_limit` و `abuse` فلا يحذفان شيئا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `reason`، `currency`، `retentionDaysRemaining` و `billingUrl`. ## الأسباب الشائعة - فشلت دفعة ولم تحل (`payment_failed`). - بلغ استهلاك الشهر حد الاستهلاك الذي وضعه الحساب (`usage_limit`). - أوقف مشغل الحساب بسبب إساءة (`abuse`). ## كيف تصلح الطلب - لـ `payment_failed`، اطلب من المستخدم أن يحدث البطاقة على `billingUrl` قبل أن تنتهي الأيام. - لـ `usage_limit`، يرفع مالك المنظمة أو أحد مشرفيها الحد أو يزيله عبر `PUT /v1/billing/account/usage-limit`. - لـ `abuse`، اطلب من المستخدم أن يتواصل مع الدعم. - اقرأ ما يعيق الطلب عبر `ghaym cloud billing eligibility`، أو `GET /v1/billing/eligibility`، قبل أن تعيد المحاولة. ## مثال على الرد ```json { "type": "account-suspended", "title": "Account Suspended", "detail": "This account is suspended (payment_failed): a payment failed and was not recovered. Update the card on file at https://auth.ghaym.me/account/billing to resume it. Its data is kept for 23 more day(s). Read the current state from GET /v1/billing/eligibility.", "reason": "payment_failed", "currency": null, "retentionDaysRemaining": 23, "billingUrl": "https://auth.ghaym.me/account/billing", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "status": 402, "docs": "https://ghaym.me/docs/errors/account-suspended" } ``` Source: https://ghaym.me/docs/errors/account-not-approved.md # Account Not Approved لم تعتمد غيم الحساب للنشر بعد، فلم تغير الـ API شيئا. أي أحد يستطيع إنشاء حساب وفتح الـ console وربط GitHub. أما وضع شيء على المنصة فينتظر أن تعتمد غيم صاحب الحساب، و `approved` في `GET /v1/billing/eligibility` يخبرك بذلك مسبقا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`. ## الأسباب الشائعة - أنشأ مالك المنظمة حسابا ولم تعتمده غيم بعد. ## كيف تصلح الطلب - أخبر المستخدم أن النشر يفتح عندما تعتمد غيم الحساب، وأنه لا شيء عليه إلا الانتظار. - لا تعد المحاولة قبل أن يعتمد الحساب، فالجواب لن يتغير. ## مثال على الرد ```json { "type": "account-not-approved", "title": "Account Not Approved", "detail": "This account has not been approved to deploy yet. Everything else is open; deploying starts once Ghaym approves the account. Check readiness up front with GET /v1/billing/eligibility.", "code": "account_not_approved", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 403, "docs": "https://ghaym.me/docs/errors/account-not-approved" } ``` Source: https://ghaym.me/docs/errors/phone-not-verified.md # Phone Not Verified ليس في الحساب رقم هاتف مؤكد، والنشر يحتاجه، فلم تغير الـ API شيئا. عند الإطلاق أو الـ deploy، الرقم الذي يفحص هو رقم مالك المنظمة. والرقم يؤكد على صفحة حساب غيم على `accountUrl`، وليس عبر Cloud API. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `accountUrl`. ## الأسباب الشائعة - سجل مالك المنظمة لكنه لم يدخل الرمز الذي وصله عبر SMS. ## كيف تصلح الطلب - اطلب من المستخدم أن يؤكد رقما على `accountUrl`: هذا في يده، برمز يصله عبر SMS. - اقرأ ما يعيق الطلب عبر `ghaym cloud billing eligibility`، أو `GET /v1/billing/eligibility`، قبل أن تعيد المحاولة. - لا تعد المحاولة قبل أن يؤكد الرقم، فالجواب لن يتغير. ## مثال على الرد ```json { "type": "phone-not-verified", "title": "Phone Not Verified", "detail": "This account has no verified phone number, which is required before anything can be deployed. Verify one on the Ghaym account page at https://auth.ghaym.me/account. Check readiness up front with GET /v1/billing/eligibility.", "accountUrl": "https://auth.ghaym.me/account", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 402, "docs": "https://ghaym.me/docs/errors/phone-not-verified" } ``` Source: https://ghaym.me/docs/errors/account-standing.md # Account Not In Good Standing الفوترة لا تعد وضع الحساب سليما، فلن تطلق الـ API ولن تجري deploy لأي شيء عليه. الـ `standing` يكون `delinquent` عندما تفشل دفعة ولا تسدد، أو `closed` عندما يغلق مشغل حساب الفوترة. وهذا الجواب لا يوقف أي شيء يعمل أصلا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `standing` و `billingUrl`. ## الأسباب الشائعة - فشل سحب ولم تحدث البطاقة المسجلة (`delinquent`). - أغلق حساب الفوترة (`closed`). ## كيف تصلح الطلب - لـ `delinquent`، اطلب من المستخدم أن يحدث البطاقة على `billingUrl`. - لـ `closed`، اطلب من المستخدم أن يتواصل مع الدعم ليعيدوا فتحه. - اقرأ ما يعيق الطلب عبر `ghaym cloud billing eligibility`، أو `GET /v1/billing/eligibility`، قبل أن تعيد المحاولة. ## مثال على الرد ```json { "type": "account-standing", "title": "Account Not In Good Standing", "detail": "A payment for this account failed, so nothing may be provisioned until it is settled. Update the card on file at https://auth.ghaym.me/account/billing.", "standing": "delinquent", "billingUrl": "https://auth.ghaym.me/account/billing", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "status": 402, "docs": "https://ghaym.me/docs/errors/account-standing" } ``` Source: https://ghaym.me/docs/errors/card-required.md # Card Required ليس في الحساب بطاقة مسجلة، فلن تشغل الـ API له compute. البطاقة، أو الدفع بفاتورة اتفق عليه مشغل، يسمح للحساب بتشغيل compute. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `billingUrl`. ## الأسباب الشائعة - لم يضف الحساب بطاقة أبدا. ## كيف تصلح الطلب - اطلب من المستخدم أن يضيف بطاقة على `billingUrl`: هذا في يده. - ثم أرسل النداء نفسه مرة أخرى. - اقرأ ما يعيق الطلب عبر `ghaym cloud billing eligibility`، أو `GET /v1/billing/eligibility`، قبل أن تعيد المحاولة. ## مثال على الرد ```json { "type": "card-required", "title": "Card Required", "detail": "A card on file is required to run compute. Add one at https://auth.ghaym.me/account/billing.", "billingUrl": "https://auth.ghaym.me/account/billing", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 402, "docs": "https://ghaym.me/docs/errors/card-required" } ``` Source: https://ghaym.me/docs/errors/usage-limit-exceeded.md # Usage Limit Exceeded بلغ استهلاك هذا الشهر حد الاستهلاك الذي وضعه الحساب بنفسه، فلم تبدأ الـ API أي شيء جديد. يرفض الإطلاق والـ deploy والتشغيل والإيقاظ، ومعها `ghaym cloud connect --wake`. وكذلك ما يزيد السعة دون deploy: بيئة جديدة في مشروع فيه قاعدة بيانات، ونشر changeset يضيف نسخة من قاعدة أو يرفع عدد الـ replicas أو الـ readers، وتغيير حجم قاعدة إلى ذاكرة أكبر، وإعادة محاولة التجهيز. وهو ليس الحد الذي تضعه الفوترة، [سقف الدين](/ar/docs/errors/exposure-ceiling-exceeded). والمبالغ نصوص بعملة `currency`، بخاناتها العشرية: ثلاث للدينار، واثنتان للريال. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `currency`، `usageJod` و `usageLimitJod`. ## الأسباب الشائعة - استهلكت الخدمات هذا الشهر أقصى ما يسمح به الحد. - خفض الحد إلى ما دون ما استهلكه الشهر. ## كيف تصلح الطلب - أخبر المستخدم: مالك المنظمة أو أحد مشرفيها يرفع الحد أو يزيله عبر `PUT /v1/billing/account/usage-limit`. - أو انتظر الشهر التالي، عندما يبدأ الاستهلاك من الصفر من جديد. - لا تعد المحاولة قبل ذلك، فالجواب لن يتغير. ## مثال على الرد ```json { "type": "usage-limit-exceeded", "title": "Usage Limit Exceeded", "detail": "This month's usage (40.000 JOD) has reached the 40.000 JOD usage limit set on this account. Raise or clear it with PUT /v1/billing/account/usage-limit.", "currency": "JOD", "usageJod": "40.000", "usageLimitJod": "40.000", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/start", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/start", "status": 402, "docs": "https://ghaym.me/docs/errors/usage-limit-exceeded" } ``` Source: https://ghaym.me/docs/errors/budget-cap-exceeded.md # Budget Cap Exceeded السعر الشهري للخدمة الجديدة سيرفع مصروف المشروع هذا الشهر فوق سقف ميزانيته، فلم تنشئ الـ API شيئا. لا تفحص إلا الخدمة الجديدة التي لها سعر شهري ثابت: الـ `projectedSpendJod` هو `currentSpendJod` زائد `estimatedMonthlyJod`. والخدمات التي تعمل أصلا لا يوقفها السقف أبدا. والمبالغ نصوص بعملة `currency`، بخاناتها العشرية: ثلاث للدينار، واثنتان للريال. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `projectId`، `currency`، `currentSpendJod`، `estimatedMonthlyJod`، `projectedSpendJod` و `budgetCapJod`. ## الأسباب الشائعة - مصروف المشروع حتى الآن، مع السعر الشهري للخدمة الجديدة، فوق السقف الذي وضع عبر `--budget-cap`. - الحجم المطلوب يكلف أكثر مما يتبقى من السقف. ## كيف تصلح الطلب - اسأل المستخدم قبل أن ترفع السقف عبر `ghaym cloud projects update --budget-cap `، أو تزيله عبر `--budget-cap none`. - أو أطلق حجما أصغر. - وافحص مصروف المشروع أولا عبر `ghaym cloud billing spend `. ## مثال على الرد ```json { "type": "budget-cap-exceeded", "title": "Budget Cap Exceeded", "detail": "This would bring the project's projected monthly spend to 54.500 JOD, past its 50.000 JOD budget cap. Raise the cap with PATCH /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401, or choose a smaller resource.", "projectId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "currency": "JOD", "currentSpendJod": "42.500", "estimatedMonthlyJod": "12.000", "projectedSpendJod": "54.500", "budgetCapJod": "50.000", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 402, "docs": "https://ghaym.me/docs/errors/budget-cap-exceeded" } ``` Source: https://ghaym.me/docs/errors/plan-size-not-allowed.md # Plan Size Not Allowed خطة الحساب لا تشغل الحجم المطلوب، فلم تغير الـ API شيئا. الـ `allowedSizeSlugs` يعرض الأحجام التي تشغلها الخطة. ويعود عند تغيير الحجم، أو لخدمة ويب جديدة أعطيت حجما، أو لبيئة جديدة تنسخ حجم خدمة ويب. وقائمة أحجام الـ region نفسها تفحص أولا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `planKey`، `requestedSizeSlug` و `allowedSizeSlugs`. ## الأسباب الشائعة - خطة الحساب تشغل أحجاما أقل مما يعرضه الـ region، وطلب حجم من خارجها. ## كيف تصلح الطلب - اختر حجما من `allowedSizeSlugs`. - أو، إذا وافق المستخدم، انتقل إلى خطة تبيع هذا الحجم عبر `ghaym cloud billing set-plan --plan `. ## مثال على الرد ```json { "type": "plan-size-not-allowed", "title": "Plan Size Not Allowed", "detail": "The custom plan runs nano only, not 'micro'. Choose an allowed size, or move to a plan that sells the bigger ones.", "planKey": "custom", "requestedSizeSlug": "micro", "allowedSizeSlugs": [ "nano" ], "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "PATCH", "instance": "PATCH /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 402, "docs": "https://ghaym.me/docs/errors/plan-size-not-allowed" } ``` Source: https://ghaym.me/docs/errors/workspace-has-services.md # Workspace Still Has Services ما زالت للـ workspace خدمات، فلم تحذفه الـ API. حذف الـ workspace لا يسقط خدماته معه أبدا. والـ `serviceNames` يعرضها بأسمائها، والـ `serviceCount` يعدها. وبعد أن تذهب الخدمات، يرفض حذف workspace ما زالت له مخازن بالطريقة نفسها، كـ `workspace-has-buckets`. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `workspaceId`، `serviceCount` و `serviceNames`. ## الأسباب الشائعة - ما زالت توجد خدمة في مشروع من مشاريع الـ workspace، سواء كانت تعمل أو نائمة أو موقوفة. ## كيف تصلح الطلب - اسأل المستخدم قبل أن تحذف أي خدمة: بياناتها تذهب معها. - احذف كل واحدة عبر `ghaym cloud services delete --env --apply`، ثم مخازنه، ثم احذف الـ workspace مرة أخرى. ## مثال على الرد ```json { "type": "workspace-has-services", "title": "Workspace Still Has Services", "detail": "This workspace still owns 2 service(s) — orders-db, storefront. Destroy them first, then delete the workspace.", "workspaceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "serviceCount": 2, "serviceNames": [ "orders-db", "storefront" ], "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/workspaces/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "DELETE", "instance": "DELETE /v1/workspaces/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 409, "docs": "https://ghaym.me/docs/errors/workspace-has-services" } ``` Source: https://ghaym.me/docs/errors/workspace-last-undeletable.md # Last Workspace Cannot Be Deleted الـ workspace هو آخر workspace في منظمته، فأبقته الـ API. لا تستطيع حذف آخر workspace باق في المنظمة. والـ workspace الأول ليس استثناء: أي workspace يحذف ما دام في منظمته workspace غيره. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `workspaceId`. ## الأسباب الشائعة - ليس في المنظمة أي workspace آخر. ## كيف تصلح الطلب - لكي تحذفه، أنشئ workspace آخر في المنظمة نفسها أولا عبر `POST /v1/workspaces` (`name` و `organizationId`)، ثم احذف هذا. - ولكي يتوقف الدفع على ما يعمل فيه، احذف خدماته بدلا من ذلك، إذا وافق المستخدم. ## مثال على الرد ```json { "type": "workspace-last-undeletable", "title": "Last Workspace Cannot Be Deleted", "detail": "This is the organization's last workspace. Create another one before deleting it.", "workspaceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/workspaces/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "method": "DELETE", "instance": "DELETE /v1/workspaces/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "status": 409, "docs": "https://ghaym.me/docs/errors/workspace-last-undeletable" } ``` Source: https://ghaym.me/docs/errors/invalid-idempotency-key.md # Invalid Idempotency Key جاء الـ header `Idempotency-Key` بقيمة لا تستطيع الـ API استعمالها، فلم تنفذ العملية. كانت القيمة فارغة أو أطول من 255 حرفا. والـ `errors[]` يسمي الـ header بالحقل `field: "Idempotency-Key"`. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `errors`. ## الأسباب الشائعة - عبئ الـ header من متغير كان فارغا في تلك اللحظة. - بني المفتاح من حمولة طويلة بدل أن يبنى من معرف. ## كيف تصلح الطلب - أرسل UUID كمفتاح. فهو قصير ولا يتكرر ولا يحتاج إلى تنسيق. - أنشئ المفتاح مرة واحدة لكل عملية، واستعمله في كل مرة تعيد فيها المحاولة. المفتاح الذي تنشئه من جديد في كل محاولة يفسد الغرض منه. - احذف الـ header كله بدل أن ترسله فارغا. ## مثال على الرد ```json { "type": "invalid-idempotency-key", "title": "Invalid Idempotency Key", "detail": "Idempotency-Key must be a non-empty string of at most 255 characters. A UUID is recommended.", "errors": [ { "field": "Idempotency-Key", "message": "must be between 1 and 255 characters", "value": "" } ], "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 400, "docs": "https://ghaym.me/docs/errors/invalid-idempotency-key" } ``` Source: https://ghaym.me/docs/errors/idempotency-key-in-flight.md # Idempotent Request In Flight يوجد طلب سابق بالـ `Idempotency-Key` نفسه ما زال يعمل، فلن تشغل الـ API العملية مرتين في الوقت نفسه. وهذه هي الحماية تعمل كما يجب، لا نداء فاشلا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `idempotencyKey`، `endpoint` و `errors`. ## الأسباب الشائعة - انتهت مهلة العميل عنده فأعاد المحاولة، بينما كان الطلب الأول يعمل على الخادم. - اثنان من الـ workers التقطا المهمة نفسها وأرسلاها بالمفتاح نفسه. ## كيف تصلح الطلب - انتظر ثم أعد المحاولة بالمفتاح نفسه. عندما ينتهي الطلب الأول، تعيد لك المحاولة جوابه المحفوظ. - لا تنشئ مفتاحا جديدا لتتجاوز هذا. المفتاح الجديد يشغل العملية مرة ثانية فعلا. - اقرأ `endpoint` لتتأكد أي عملية تعمل قبل أن تقرر الانتظار. ## مثال على الرد ```json { "type": "idempotency-key-in-flight", "title": "Idempotent Request In Flight", "detail": "A request with Idempotency-Key '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' is still in flight. Retry shortly to receive the stored response.", "idempotencyKey": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "endpoint": "POST /v1/projects/:projectId/services", "errors": [ { "field": "Idempotency-Key", "message": "an earlier request with this key has not completed yet", "value": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401" } ], "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 409, "docs": "https://ghaym.me/docs/errors/idempotency-key-in-flight" } ``` Source: https://ghaym.me/docs/errors/idempotency-key-reused.md # Idempotency Key Reused جاء الـ `Idempotency-Key` من قبل مع جسم طلب مختلف، فلم تكرر الـ API جوابا محفوظا ولم تشغل أي شيء. الجواب المحفوظ يعاد فقط للجسم الذي حفظ لأجله، والعملية الجديدة لا تعمل أبدا تحت مفتاح قديم. والمفاتيح تحفظ 24 ساعة عادة. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `idempotencyKey`، `endpoint` و `errors`. ## الأسباب الشائعة - أعيد استعمال مفتاح للعملية التالية بدل إنشاء مفتاح جديد. - غيرت إعادة المحاولة الجسم: اسم أنشئ من جديد، أو وقت جديد، أو حقل تغير محتواه. ## كيف تصلح الطلب - لكي تكرر العملية الأولى، أرسل جسمها كما هو تماما مع المفتاح نفسه. يعود الجواب المحفوظ ومعه `Idempotency-Replayed: true`. - ولعملية جديدة، أنشئ مفتاحا جديدا. - احفظ كل مفتاح مع جسمه، لكي لا تخلط إعادة المحاولة أحدهما بالآخر. ## مثال على الرد ```json { "type": "idempotency-key-reused", "title": "Idempotency Key Reused", "detail": "The Idempotency-Key '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was already used for a different request. Send a new key for a new operation, or resend the original payload to replay the stored response.", "idempotencyKey": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "endpoint": "POST /v1/projects/:projectId/services", "errors": [ { "field": "Idempotency-Key", "message": "already used with a different request payload", "value": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401" } ], "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 422, "docs": "https://ghaym.me/docs/errors/idempotency-key-reused" } ``` Source: https://ghaym.me/docs/errors/internal-error.md # Internal Server Error حدث عطل لدينا، وقد يكون الطلب نفذ وقد لا يكون. الـ 500 يعني أن الخادم لم ينه عمله بسلام، لا أنه لم يفعل شيئا. وفي الـ production يكون الـ `detail` الجملة نفسها كل مرة، والتفاصيل في سجلاتنا تحت الـ `requestId` الخاص بهذا الجواب. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - خلل في الخدمة. - شيء تعتمد عليه الخدمة تصرف بطريقة غير متوقعة. ## كيف تصلح الطلب - احتفظ بـ `requestId`. فهو القيمة الوحيدة التي تجد هذا العطل بالذات، فاذكره عندما تبلغ عن المشكلة. - أعد المحاولة مرة واحدة بعد تأخير. إذا فشلت مرة أخرى، فتوقف بدل أن تستمر في الدوران. - قبل أن تعيد محاولة كتابة، اقرأ المورد من جديد. فقد تكون المحاولة الأولى نفذت جزءا منها. - لا تقل إن الـ deploy نجح لمجرد أن إعادة المحاولة أعادت 200: راجع سجل الـ build. ## مثال على الرد ```json { "type": "internal-error", "title": "Internal Server Error", "status": 500, "detail": "An unexpected error occurred. Please try again later.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "docs": "https://ghaym.me/docs/errors/internal-error" } ``` Source: https://ghaym.me/docs/errors/bad-gateway.md # Bad Gateway النوع الاحتياطي لـ 502 ليس له نوع باسمه، ولا يوجد مسار في الـ API يرسله اليوم. وعندما ترد خدمة تعتمد عليها الـ API بشيء لا يصلح، يوجد نوع باسمه، مثل [repo-unavailable](/ar/docs/errors/repo-unavailable) الخاص بـ GitHub. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - خطأ 502 صدر دون نوع خاص به ووصل إلى معالج الأخطاء. ## كيف تصلح الطلب - أعد المحاولة بعد تأخير، فالعطل في خدمة أخرى لا يطول غالبا. - ولا تغير الطلب بسببه، فلا شيء في الطلب سببه. ## مثال على الرد ```json { "type": "bad-gateway", "title": "Bad Gateway", "status": 502, "detail": "The upstream service returned an invalid response", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/git/branches", "method": "GET", "instance": "GET /v1/git/branches", "docs": "https://ghaym.me/docs/errors/bad-gateway" } ``` Source: https://ghaym.me/docs/errors/service-unavailable.md # Service Unavailable النوع الاحتياطي لـ 503 ليس له نوع باسمه، ولا يوجد مسار في الـ API يرسله اليوم. وعندما تكون خدمة تحتاجها الـ API غير متاحة، يوجد نوع باسمه، مثل [auth-unavailable](/ar/docs/errors/auth-unavailable) لخدمة الهوية. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - خطأ 503 صدر دون نوع خاص به ووصل إلى معالج الأخطاء. ## كيف تصلح الطلب - أعد المحاولة وأطل الانتظار كل مرة، ولا تلح: الخدمة العائدة للتو يسهل أن تسقط مرة أخرى. - أخبر المستخدم أن المنصة غير متاحة الآن، لا أن طلبه خاطئ. ## مثال على الرد ```json { "type": "service-unavailable", "title": "Service Unavailable", "status": 503, "detail": "The mail transport refused the message", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects", "method": "GET", "instance": "GET /v1/projects", "docs": "https://ghaym.me/docs/errors/service-unavailable" } ``` Source: https://ghaym.me/docs/errors/auth-unavailable.md # Identity Service Unavailable لم تستطع الـ API قراءة مفاتيح التوقيع الخاصة بخدمة الهوية، فلم تستطع فحص الـ token ولم تغير شيئا. المشكلة ليست في الـ token، ولا يوجد شيء في الطلب لتصلحه. أما الـ token الذي فحصته الـ API ورفضته فيعيد [invalid-token](/ar/docs/errors/invalid-token). لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - لا يمكن الوصول إلى خدمة الهوية، وليس لدى الـ API مفاتيح توقيع من قبل. ## كيف تصلح الطلب - أعد الطلب نفسه بعد انتظار قصير، وأطل الانتظار كل مرة. - احتفظ بالـ token، فهو لم يرفض. - وإذا طال الأمر، فأخبر المستخدم أن المنصة لا تستطيع إدخال أحد الآن، واذكر `requestId`. ## مثال على الرد ```json { "type": "auth-unavailable", "title": "Identity Service Unavailable", "detail": "The identity service's signing keys could not be read, so this request could not be authenticated. Nothing has changed; try again shortly.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects", "method": "GET", "instance": "GET /v1/projects", "status": 503, "docs": "https://ghaym.me/docs/errors/auth-unavailable" } ``` Source: https://ghaym.me/docs/errors/auth-directory-unavailable.md # Identity Service Unavailable لم تستطع الـ API سؤال خدمة الهوية عن هذا الحساب، فلم يغير النداء الذي يحتاج الجواب أي شيء. احتاج النداء شيئا لا تعرفه إلا خدمة الهوية: فحص الهاتف الذي يجريه كل إطلاق وكل deploy وكل إيقاظ، أو مفتاح الـ API الذي خلف tunnel قاعدة بيانات. والـ `detail` يذكر إن كان الانتظار يفيد. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - لا يمكن الوصول إلى خدمة الهوية، أو لم ترد. - هذه النسخة من الـ API لا تستطيع سؤال خدمة الهوية أصلا. وهنا يذكر الـ `detail` أن إعادة المحاولة لن تغير شيئا. ## كيف تصلح الطلب - عندما يطلب الـ `detail` المحاولة بعد قليل، أعد المحاولة بعد انتظار، وأطله كل مرة. - عندما يذكر الـ `detail` أن إعادة المحاولة لن تغير شيئا، فتوقف واطلب من المستخدم التواصل مع الدعم. - لا ترسل المستخدم ليتحقق من هاتفه مرة أخرى: هذا الجواب لا يقول شيئا عن تحققه من عدمه. ## مثال على الرد ```json { "type": "auth-directory-unavailable", "title": "Identity Service Unavailable", "detail": "The identity service could not be reached, so this account's verification state is unknown. Nothing has changed; try again shortly.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "status": 503, "docs": "https://ghaym.me/docs/errors/auth-directory-unavailable" } ``` Source: https://ghaym.me/docs/errors/gateway-timeout.md # Gateway Timeout النوع الاحتياطي لـ 504 ليس له نوع باسمه، ولا يوجد مسار في الـ API يرسله اليوم. وكأي مهلة تنتهي، تكون نتيجة العملية غير معروفة: فقد تكون اكتملت بعد إرسال الجواب. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - خطأ 504 صدر دون نوع خاص به ووصل إلى معالج الأخطاء. ## كيف تصلح الطلب - اقرأ المورد من جديد قبل أن تعيد محاولة الكتابة، لكي لا تنشئ إعادة المحاولة نسخة ثانية. - أرسل `Idempotency-Key` مع كل كتابة؛ فهو الذي يجعل هذه الحالة بالذات آمنة للإعادة. - أعد المحاولة وأطل الانتظار كل مرة، وتوقف بعد بضع محاولات. ## مثال على الرد ```json { "type": "gateway-timeout", "title": "Gateway Timeout", "status": 504, "detail": "The upstream service did not respond in time", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "docs": "https://ghaym.me/docs/errors/gateway-timeout" } ``` Source: https://ghaym.me/docs/errors/error.md # Error النوع الاحتياطي لرمز حالة ليس له نوع في الـ API، ولا يوجد مسار في الـ API يرسله اليوم. الـ slug الخاص به لا يقول شيئا عن السبب، فليس فيه إلا `status` و `detail`. والـ method الخاطئ على مسار موجود يعيد not-found، لا 405. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - رمز حالة ليس له نوع في الـ API ووصل إلى معالج الأخطاء. ## كيف تصلح الطلب - في هذه الحالة تفرع على `status` لا على `type`. - اقرأ `detail`، واعتبر الـ 4xx خطأك والـ 5xx خطأنا. - وإذا رأيت هذا على نداء، فأخبرنا ومعه الـ `requestId`. ## مثال على الرد ```json { "type": "error", "title": "Error", "status": 405, "detail": "Method Not Allowed", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects", "method": "PUT", "instance": "PUT /v1/projects", "docs": "https://ghaym.me/docs/errors/error" } ``` Source: https://ghaym.me/docs/errors/bucket-object-delete-failed.md # Bucket Object Delete Failed رفض المخزن حذف الملف، فالملف ما زال موجودا ولم يسجل شيء. الـ `storeCode` هو رمز الخطأ الذي أعطاه المخزن، و `null` عندما لا يعطي شيئا. والملف الذي كان قد حذف أصلا ليس خطأ: حذفه ينجح. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`، `bucketId`، `key` و `storeCode`. ## الأسباب الشائعة - كان المخزن مشغولا أو معطلا في تلك اللحظة. - رفض المخزن الـ key لسبب لديه، يسميه الـ `storeCode`. ## كيف تصلح الطلب - أعد الحذف بعد قليل: حذف الملف مرتين آمن. - وإذا استمر الفشل بالـ `storeCode` نفسه، فأخبر المستخدم واذكر `detail`. ## مثال على الرد ```json { "type": "bucket-object-delete-failed", "title": "Bucket Object Delete Failed", "detail": "The store refused to delete 'uploads/report.pdf' from bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401'", "code": "BUCKET_OBJECT_DELETE_FAILED", "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401", "key": "uploads/report.pdf", "storeCode": "InternalError", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/objects", "method": "DELETE", "instance": "DELETE /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/objects", "status": 502, "docs": "https://ghaym.me/docs/errors/bucket-object-delete-failed" } ``` Source: https://ghaym.me/docs/errors/tunnels-unavailable.md # Tunnels Unavailable لا يوجد ما يمرر الـ tunnels إلى الموقع الذي فيه القاعدة، فلم تفتح الـ API أي tunnel. الـ `service` و `environment` يسميان القاعدة والبيئة التي طلبت فيها. والـ `region` هو region القاعدة. وهذا حد في المنصة، وليس في القاعدة ولا في من ينادي، والقاعدة تبقى تعمل. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `service`، `environment` و `region`. ## الأسباب الشائعة - لا يوجد relay يخدم الموقع الذي فيه القاعدة. - لا يوجد في المنصة أي relay. ## كيف تصلح الطلب - أخبر المستخدم أن الـ tunnels لا تصل إلى region هذه القاعدة، واذكر `detail`. - صل إلى القاعدة بدلا من ذلك من خدمة في المشروع نفسه، عبر متغيرات الاتصال الخاصة بها. - لا تعد المحاولة في حلقة: الجواب لا يتغير إلا عندما يتوفر relay يخدم الموقع. ## مثال على الرد ```json { "type": "tunnels-unavailable", "title": "Tunnels Unavailable", "detail": "Tunnels are not available in amman-1 yet.", "service": "orders-db", "environment": "staging", "region": "amman-1", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 503, "docs": "https://ghaym.me/docs/errors/tunnels-unavailable" } ``` Source: https://ghaym.me/docs/errors/database-not-ready.md # Database Not Ready استيقظت القاعدة لكنها لم تقبل اتصالا في الوقت المحدد، فلم تفتح الـ API أي tunnel بدل أن تعطيك port لا يرد على شيء. الـ `timeoutSeconds` هو المدة التي انتظرتها الـ API، 30 ثانية عادة. والإيقاظ نفسه نجح، فالقاعدة مستيقظة للمحاولة التالية. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `service`، `environment` و `timeoutSeconds`. ## الأسباب الشائعة - استغرق PostgreSQL وقتا أطول من المعتاد ليقبل الاتصالات بعد أن استيقظ. - لم يرد Redis على ping في الوقت المحدد. ## كيف تصلح الطلب - شغل الأمر نفسه مرة أخرى: هذه من الحالات التي تكون فيها إعادة المحاولة دون تغيير هي الصواب. - وإذا استمر الفشل، فأخبر المستخدم: قد تكون القاعدة غير قادرة على العمل. ## مثال على الرد ```json { "type": "database-not-ready", "title": "Database Not Ready", "detail": "orders-db woke but did not accept a connection within 30 s in staging. Try again.", "service": "orders-db", "environment": "staging", "timeoutSeconds": 30, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels", "status": 503, "docs": "https://ghaym.me/docs/errors/database-not-ready" } ``` Source: https://ghaym.me/docs/errors/region-capacity-exhausted.md # Region Capacity Exhausted أجهزة الـ region لا تتسع للموارد التي يطلبها التغيير، فلم تنشئ الـ API أي شيء ولم تكبره. الـ `unit` يسمي ما نفد: `ram-gb` أو `vcpu` أو `disk-gb` للخدمات، و `ssd-pool-gb` للمخازن. والـ `totalValue` ما لدى الـ region، و `reserved` ما هو محجوز، و `projected` ما يحتاجه التغيير. والحساب وخطته سليمان: ليس لدى المنصة جهاز له الآن. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `regionSlug`، `unit`، `totalValue`، `reserved` و `projected`. ## الأسباب الشائعة - خدمة جديدة، أو أول deploy، لم تتسع لها الأجهزة. - كبر حجم خدمة ولم تتسع لها الأجهزة. - مخزن جديد، أو مساحة أكبر لمخزن، لم يتسع لها مخزن الـ region. ## كيف تصلح الطلب - اختر حجما أصغر، أو اجعل شيئا في الـ region نفسه ينام، ثم أعد المحاولة. - أو ضعها في region آخر، إذا وافق المستخدم: مكان عملها قراره. - وقد تنجح إعادة المحاولة دون تغيير لاحقا أيضا، عندما تفرغ مساحة في الـ region. ## مثال على الرد ```json { "type": "region-capacity-exhausted", "title": "Region Capacity Exhausted", "detail": "Region 'amman-1' has 64 GB of RAM and 62 is already reserved; this change would need 66. Choose a smaller size, put something to sleep, or place this in another region.", "regionSlug": "amman-1", "unit": "ram-gb", "totalValue": 64, "reserved": 62, "projected": 66, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "method": "POST", "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services", "status": 503, "docs": "https://ghaym.me/docs/errors/region-capacity-exhausted" } ``` Source: https://ghaym.me/docs/errors/region-briefly-full.md # Region Briefly Full لم يكن في الـ region مكان لإيقاظ الخدمة في تلك اللحظة، فأبقتها الـ API نائمة ولم توقف أي شيء لتفرغ مكانا. الـ `projected` هو ما ستحمله أجهزة الـ region والخدمة مستيقظة، و `reserved` ما تحمله الآن، و `totalValue` ما لديها، بوحدة `unit`. والـ `retryable` دائما `true`: المكان يعود عندما تنام خدمات أخرى. والإنتاج لا ينام، فلن يرى هذا أبدا. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `regionSlug`، `unit`، `totalValue`، `reserved`، `projected` و `retryable`. ## الأسباب الشائعة - تشغيل الخدمة، أو فتح tunnel مع `--wake`، أو أخذ نسخة احتياطية من قاعدة نائمة، وجد الـ region ممتلئا. - استيقظت خدمات كثيرة في الـ region في الوقت نفسه تقريبا. ## كيف تصلح الطلب - أعد المحاولة بعد قليل: هذه من الحالات التي تكون فيها إعادة المحاولة دون تغيير هي الصواب. - وإذا طال الأمر، فأخبر المستخدم: مشغلو غيم يصلهم إشعار في اللحظة نفسها، لأن الـ region يحتاج مكانا أكبر. ## مثال على الرد ```json { "type": "region-briefly-full", "title": "Region Briefly Full", "detail": "Region 'amman-1' is briefly full — waking this service needs 66 GB of RAM against 64. Nothing was stopped to make room; retry in a moment.", "regionSlug": "amman-1", "unit": "ram-gb", "totalValue": 64, "reserved": 62, "projected": 66, "retryable": true, "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/start", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/start", "status": 503, "docs": "https://ghaym.me/docs/errors/region-briefly-full" } ``` Source: https://ghaym.me/docs/errors/logs-store-unavailable.md # Log Store Unavailable تعذرت قراءة المخزن الذي يحفظ سجلات الخدمة القديمة، فلم تعد الـ API نتائج بحث بدل أن تعيد صفحة فارغة. البث المباشر بجانبه يبقى يعمل: `ghaym cloud services logs ` يقرأ البث ولا يقرأ المخزن أبدا. والـ `detail` يسمي ما حدث، بين قوسين. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`. ## الأسباب الشائعة - لم يرد المخزن خلال وقت البحث المسموح. - رد المخزن برمز خطأ، والـ `detail` يسميه. - لا يوجد مخزن سجلات للمواقع التي تعمل فيها الخدمة. ## كيف تصلح الطلب - أعد البحث بعد قليل. - وفي هذه الأثناء، اقرأ ما يحدث الآن من البث المباشر. - وإذا قال الـ `detail` إنه لا يوجد مخزن سجلات، فأخبر المستخدم: إعادة المحاولة لن تفيد. ## مثال على الرد ```json { "type": "logs-store-unavailable", "title": "Log Store Unavailable", "detail": "The log store could not be read (the store answered 502), so this service's stored history is unavailable. The live tail is unaffected; try the search again shortly.", "code": "logs_store_unavailable", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/logs/query", "method": "GET", "instance": "GET /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/logs/query", "status": 503, "docs": "https://ghaym.me/docs/errors/logs-store-unavailable" } ``` Source: https://ghaym.me/docs/errors/no-backup-destination.md # Backups Unavailable لا يوجد في المنصة مكان تحفظ فيه النسخ الاحتياطية، فلم تأخذ الـ API نسخة ولم تبدأ استرجاعا. هذا إعداد المنصة، وليس إعداد القاعدة ولا من ينادي، فلا يوجد تغيير في الطلب يتجاوزه. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - طلبت نسخة احتياطية، يدويا أو من الـ console، على منصة لا مكان فيها للنسخ. - طلب استرجاع على المنصة نفسها: الاسترجاع يقرأ من المكان نفسه أيضا. ## كيف تصلح الطلب - أخبر المستخدم أن النسخ الاحتياطية لا تعمل هنا، واذكر `detail`. - لا تعد المحاولة: الجواب لا يتغير حتى يصبح للمنصة مكان للنسخ. ## مثال على الرد ```json { "type": "no-backup-destination", "title": "Backups Unavailable", "detail": "Backups are not available on this platform yet. Nothing was taken.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups", "status": 409, "docs": "https://ghaym.me/docs/errors/no-backup-destination" } ``` Source: https://ghaym.me/docs/errors/backup-purge-failed.md # Backup Not Deleted المكان الذي تحفظ فيه النسخ لم يؤكد أنه حذف ملفات هذه النسخة، فأبقت الـ API سجل النسخة كما هو. الملفات تحذف أولا وسجل النسخة بعدها، فالنسخة تبقى في القائمة. وحذفها مرة أخرى آمن. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `backupId`. ## الأسباب الشائعة - كان المكان الذي تحفظ فيه النسخ بطيئا أو متوقفا أو رفض الحذف في تلك اللحظة. ## كيف تصلح الطلب - أعد الحذف بعد قليل. - وإذا استمر الفشل، فأخبر المستخدم أن النسخة ما زالت موجودة، واذكر `detail`. ## مثال على الرد ```json { "type": "backup-purge-failed", "title": "Backup Not Deleted", "detail": "The backup could not be deleted. Nothing was changed; try again.", "backupId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "method": "DELETE", "instance": "DELETE /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/backups/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402", "status": 502, "docs": "https://ghaym.me/docs/errors/backup-purge-failed" } ``` Source: https://ghaym.me/docs/errors/github-connect-unconfigured.md # GitHub Connect Unconfigured نسخة غيم هذه ليس فيها تسجيل دخول GitHub مضبوط للـ app الخاص بها، فلا يمكن ربط حساب GitHub هنا. من ينادي لم يخطئ، والإعادة لا تفيد حتى يضيف مشغل بيانات تسجيل الدخول الخاصة بالـ app. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - لم يضبط مشغلو النسخة تسجيل الدخول الخاص بالـ GitHub App. ## كيف تصلح الطلب - أخبر المستخدم أن GitHub لا يمكن ربطه هنا، واذكر `detail`. - لا تعد المحاولة، فالجواب لن يتغير وحده. ## مثال على الرد ```json { "type": "github-connect-unconfigured", "title": "GitHub Connect Unconfigured", "detail": "Connecting a GitHub account is not available on this deployment.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/git/installations/install-url", "method": "GET", "instance": "GET /v1/git/installations/install-url", "status": 503, "docs": "https://ghaym.me/docs/errors/github-connect-unconfigured" } ``` Source: https://ghaym.me/docs/errors/access-control-not-enabled.md # Access Control Not Enabled التحكم في الوصول معطل على نسخة غيم هذه، فلا تقرأ الـ API ولا تغير من يستطيع فتح الخدمة. هو 404 لكي يخفي الـ console أو الـ CLI الذي يسأل قسم الوصول، بدل أن يعرض بوابة لا يطبقها أحد. وتجهيز أي تغيير في الوصول يرفض بالطريقة نفسها. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - النسخة تعمل والتحكم في الوصول معطل، وهذا وضعها الأساسي حتى يشغله مشغل. - قرئ وصول خدمة، أو جهز تغيير عليه، مثلا عبر `ghaym cloud access set `. ## كيف تصلح الطلب - اترك الوصول كما هو: لا يقرأ ولا يتغير هنا حتى يشغله مشغل. - وأخبر المستخدم إذا كان يريد خدمة مقيدة أو خاصة، واذكر `detail`. - لا تعد المحاولة، فالجواب لن يتغير وحده. ## مثال على الرد ```json { "type": "access-control-not-enabled", "title": "Access Control Not Enabled", "detail": "Access control is not enabled on this deployment.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/access", "method": "GET", "instance": "GET /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/access", "status": 404, "docs": "https://ghaym.me/docs/errors/access-control-not-enabled" } ``` Source: https://ghaym.me/docs/errors/billing-not-enabled.md # Billing Not Enabled نسخة غيم هذه تعمل دون خدمة الفوترة الخاصة بها، فلا يمكن أن يبدأ أي شيء يكلف مالا، ولا يوجد ما يسدد. ترفض الإطلاق والـ deploy والتشغيل والإيقاظ، وتشغيل الفواتير الخاص بالمشغل. وكذلك ما يزيد السعة دون deploy: بيئة جديدة في مشروع فيه قاعدة بيانات، ونشر changeset يضيف نسخة من قاعدة أو يرفع عدد الـ replicas أو الـ readers، وتغيير حجم قاعدة إلى ذاكرة أكبر، وإعادة محاولة التجهيز. والـ `code` يعيد السبب إلى الـ client الذي يتفرع بناء عليه. إضافة إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ)، يضيف هذا النوع `code`. ## الأسباب الشائعة - مشغلو النسخة يتركون خدمة الفوترة معطلة. ## كيف تصلح الطلب - أخبر المستخدم أنه لا يوجد نشر هنا ما دامت الفوترة معطلة، واذكر `detail`. - لا تعد المحاولة، فالجواب لن يتغير حتى يشغل مشغل الفوترة. ## مثال على الرد ```json { "type": "billing-not-enabled", "title": "Billing Not Enabled", "detail": "The billing service is not enabled on this deployment, so nothing can be provisioned or settled. Nothing has changed.", "code": "billing_not_enabled", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "method": "POST", "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments", "status": 503, "docs": "https://ghaym.me/docs/errors/billing-not-enabled" } ``` Source: https://ghaym.me/docs/errors/billing-service-unavailable.md # Billing Service Unavailable لم تستطع الـ API الوصول إلى خدمة الفوترة، أو لم يكن لديها سعر صرف تحتاجه، فلم تغير شيئا. عندما لا تصل الـ API إلى الفوترة، يبين النص الذي بين القوسين في آخر `detail` ما فشل. والفوترة تسأل مباشرة عندما تتغير الخطة، وأول مرة يقرأ فيها وضع فوترة المنظمة. وإذا نقص سعر صرف، يسمي الـ `detail` العملة. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - كانت خدمة الفوترة متوقفة أو بطيئة أو أعادت خطأ في تلك اللحظة. - ربط هذه النسخة بالفوترة غير مضبوط، والنص الذي بين القوسين يقول ذلك. - لم يكن لدى الفوترة سعر صرف للعملة في تلك اللحظة، أو أصدرت الفاتورة المقروءة دون سعر صرف. ## كيف تصلح الطلب - أعد المحاولة بعد قليل: لم يتغير شيء، فإرسال النداء نفسه مرة أخرى آمن. - وإذا استمر الفشل، فأخبر المستخدم واذكر `detail`. - وإذا قال الـ `detail` إن الفاتورة أصدرت دون سعر صرف، فلا تعد المحاولة: الجواب لن يتغير، فأخبر المستخدم واذكر `detail`. ## مثال على الرد ```json { "type": "billing-service-unavailable", "title": "Billing Service Unavailable", "detail": "The billing service could not be reached, so this account's billing state is unknown. Nothing has changed; try again shortly. (billing answered 502)", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/billing/account/plan", "method": "PUT", "instance": "PUT /v1/billing/account/plan", "status": 503, "docs": "https://ghaym.me/docs/errors/billing-service-unavailable" } ``` Source: https://ghaym.me/docs/errors/mail-transport-failed.md # Mail Transport Failed رفض خادم البريد رسالة التجربة، فلم يرسل شيء. رسالة التجربة وحدها تعود هكذا: التنبيه الذي لا يرسل يترك بهدوء. والدقيقة التي أخذتها التجربة تعاد، فلا تمنع المحاولة التالية. لا يضيف هذا النوع شيئا إلى [الحقول التي في كل خطأ](/ar/docs/errors#ما-يحمله-كل-رد-خطأ). ## الأسباب الشائعة - كان خادم البريد متوقفا أو بطيئا أو رفض الرسالة في تلك اللحظة. ## كيف تصلح الطلب - أعد المحاولة بعد قليل. - وإذا استمر الفشل، فأخبر المستخدم أن رسائل التنبيه قد لا تصل أيضا، واذكر `detail`. ## مثال على الرد ```json { "type": "mail-transport-failed", "title": "Mail Transport Failed", "detail": "The mail server refused the test message. Nothing was sent; try again shortly.", "requestId": "req-1785231000000-4f7b2c9ae", "timestamp": "2026-07-28T09:30:00.000Z", "path": "/v1/notifications/test", "method": "POST", "instance": "POST /v1/notifications/test", "status": 503, "docs": "https://ghaym.me/docs/errors/mail-transport-failed" } ```