> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# techstack api services

> مرجع مولَّد لأوامر techstack api services

<Note>مولَّد من إصدار Techstack v0.39.0 (المصدر `49677b729cb9`). بالنسبة إلى إصدار مثبَّت، فإن `techstack api <command> --help` هو المرجع.</Note>

## techstack api services execute-application-adoption

نفّذ خطة المصدر المحددة التي خضعت للمراجعة بموافقة صريحة من المالك.

يعيد التحقق من الملخّص المحتفَظ به وهوية المصدر والمراجعة والإصدار. لا تثبت العضوية إلا بإيصال حفظ مصادَق عليه من CLI المثبّت على إصدار محدد. تُحفَظ الحسابات والإعدادات والبيانات الدائمة؛ ولا تُنشأ بيئة تشغيل جديدة. لا يدعم النقل إلى عقدة أخرى أو التبنّي العام.

```bash theme={null}
techstack api services execute-application-adoption [flags]
```

| | |
| - | - |
| HTTP | `POST /api/v1/services/{serviceId}/adoption-plans/{planId}/execute` |
| يغيّر الحالة | نعم |
| أداة MCP | `execute_application_adoption` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `--service-id` | string | **مطلوب.** معرّف تشغيل الخدمة المعتمد. |
| `--plan-id` | string | **مطلوب.** |
| `--expected-inventory-revision` | integer | **مطلوب.** |
| `--mode` | string | إحدى القيم: `adopt_in_place`. |
| `--owner-approved` | boolean | الافتراضي `false`. |
| `--plan-digest` | string | — |
| `--body` | json | جسم طلب JSON بصيغة `application/json`، كقيمة حرفية أو `@path` أو `-` للقراءة من stdin. |

## techstack api services get

جلب الحالة المرغوبة والمرصودة والحالة الصحية وقدرات الوصول والإجراءات لخدمة واحدة.

```bash theme={null}
techstack api services get <service-id> [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/services/{serviceId}` |
| يغيّر الحالة | لا |
| أداة MCP | `get_service_runtime` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `<service-id>` | string | **مطلوب.** معرّف وقت تشغيل الخدمة القياسي. |

## techstack api services list

عرض حالة وقت تشغيل الخدمات المقيسة القياسية.

```bash theme={null}
techstack api services list [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/services` |
| يغيّر الحالة | لا |
| أداة MCP | `list_service_runtimes` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `--stack-id` | string | — |
| `--server-id` | string | — |

## techstack api services logs

قراءة أحدث صفحة محدودة ومحجوبة البيانات الحساسة من سجل خدمة StackKits.

```bash theme={null}
techstack api services logs <service-id> [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/registry/services/{serviceId}/logs` |
| يغيّر الحالة | لا |
| أداة MCP | `get_managed_service_logs` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `<service-id>` | string | **مطلوب.** معرّف وقت تشغيل الخدمة القياسي. |
| `--limit` | integer | الافتراضي `100`. |
| `--cursor` | string | — |

## techstack api services metrics

اقرأ مقاييس الموارد المقاسة لخدمة مملوكة.

يستخدم خلفية الاستعلام عن قياسات Guard القائمة، ويثبّت المستأجر والخادم المعتمد ومحددات الحاويات من جرد الخدمات المصرّح به. يعني المتجه الفارغ أنه لم تُقَس أي مقاييس موارد.

```bash theme={null}
techstack api services metrics [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/services/{serviceId}/metrics` |
| يغيّر الحالة | لا |
| أداة MCP | `get_service_metrics` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `--service-id` | string | **مطلوب.** |

## techstack api services prepare-application-adoption

قيّم حاوية Home Assistant قائمة ومحددة بدقة لتبنّيها في مكانها.

يحفظ التقييم المرتبط بالمصدر في مخزن المهام الدائم القائم. يلزم Guard متصل وإصدار CLI منشور محدد بدقة وقادر على العملية. لا تثبت عملية التقييم للقراءة فقط عضوية Stacked.

```bash theme={null}
techstack api services prepare-application-adoption [flags]
```

| | |
| - | - |
| HTTP | `POST /api/v1/services/{serviceId}/adoption-plans` |
| يغيّر الحالة | نعم |
| أداة MCP | `prepare_application_adoption` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `--service-id` | string | **مطلوب.** معرّف تشغيل الخدمة المعتمد. |
| `--expected-inventory-revision` | integer | **مطلوب.** |
| `--mode` | string | إحدى القيم: `adopt_in_place`. |
| `--owner-approved` | boolean | الافتراضي `false`. |
| `--plan-digest` | string | — |
| `--body` | json | جسم طلب JSON بصيغة `application/json`، كقيمة حرفية أو `@path` أو `-` للقراءة من stdin. |

## techstack api services read-application-adoption-plan

اقرأ تقييم التطبيق المحتفَظ به والتقدّم الدائم.

```bash theme={null}
techstack api services read-application-adoption-plan [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/services/{serviceId}/adoption-plans/{planId}` |
| يغيّر الحالة | لا |
| أداة MCP | `read_application_adoption_plan` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `--service-id` | string | **مطلوب.** معرّف تشغيل الخدمة المعتمد. |
| `--plan-id` | string | **مطلوب.** |

## techstack api services read-application-connector

اقرأ حالة الموصل الذي تملكه العقدة وقبول النقل المنشور الحالي.

يعيد إسقاطًا خاليًا من الأسرار. يظل الكتالوج الداعم غير المتاح في حالة SourcePreview غير قابلة للإرسال للتنفيذ؛ وتتطلب الأدلة القديمة على إصدار داعم مثبت تحققًا حاليًا للقراءة فقط. كما تتطلب قابلية الإرسال صلاحية حالية ومعتمدة لمفتاح المضيف والعقدة وعقد الإيجار.

```bash theme={null}
techstack api services read-application-connector [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/services/{serviceId}/connector` |
| يغيّر الحالة | لا |
| أداة MCP | `read_application_connector` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `--service-id` | string | **مطلوب.** معرّف تشغيل الخدمة المعتمد. |

## techstack api services release-application-lifecycle

حرّر ارتباط دورة حياة متبنّاة دون حذف بيئة تشغيلها أو إيقافها.

```bash theme={null}
techstack api services release-application-lifecycle [flags]
```

| | |
| - | - |
| HTTP | `POST /api/v1/services/{serviceId}/release` |
| يغيّر الحالة | نعم |
| أداة MCP | `release_application_lifecycle` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `--service-id` | string | **مطلوب.** معرّف تشغيل الخدمة المعتمد. |
| `--expected-inventory-revision` | integer | **مطلوب.** |
| `--mode` | string | إحدى القيم: `adopt_in_place`. |
| `--owner-approved` | boolean | الافتراضي `false`. |
| `--plan-digest` | string | — |
| `--body` | json | جسم طلب JSON بصيغة `application/json`، كقيمة حرفية أو `@path` أو `-` للقراءة من stdin. |

## techstack api services run-action

وضع إجراء خدمة StackKits أذن به المالك في الطابور.

يشتق سلطة الـ stack والخادم والوكيل والـ kit والخدمة من جرد قياسي حديث. تتقارب عمليات إعادة الإرسال الدقيقة عبر إيصال مهمة دائم؛ ولا يُحفظ مفتاح Idempotency-Key الخام أبداً. يلي كل تعديلٍ تشغيلُ StackKits verify قبل تغيير الحالة المقيسة. ترفض الإجراءات التي ينفذها الوكيل بالرمز 409 `maintenance_active` أثناء إعادة تشغيل الخادم أو تحديثه.

```bash theme={null}
techstack api services run-action <service-id> [flags]
```

| | |
| - | - |
| HTTP | `POST /api/v1/registry/services/{serviceId}/actions` |
| يغيّر الحالة | نعم |
| أداة MCP | `run_managed_service_action` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `<service-id>` | string | **مطلوب.** معرّف وقت تشغيل الخدمة القياسي. |
| `--body` | json | **مطلوب.** جسم طلب JSON (`application/json`) كقيمة حرفية أو `@path` أو `-` لـ stdin. |

## techstack api services setup-application-connector

أكّد وجود موصل Home Assistant مُعلَن ومملوك على عقدته، أو ألغِه.

يلزم إثبات حديث لملكية الخلفية وصلاحية operate إيجابية وجرد حالي مطابق تمامًا وموافقة المالك. لا يُنقل عبر Guard إلى CLI المنشور المثبّت على إصدار محدد إلا بيانات الارتباط المحددة حصريًا؛ وتظل صلاحيتا signedApply وإعداد المالك المحليتان إلزاميتين. تُحفَظ النية الدائمة قبل الإرسال؛ وإذا كانت نتيجة التأكيد مجهولة، تُراجَع العملية الأصلية للقراءة فقط. يفتقر الإصدار الحالي v0.51.8 إلى الكتالوج الداعم ويعيد SourcePreview غير قابلة للإرسال للتنفيذ. تبقى بيانات الاعتماد في حفظ العقدة.

```bash theme={null}
techstack api services setup-application-connector [flags]
```

<Warning>يتطلب تأكيدًا: تُصدر هذه العملية بيانات اعتماد موصل Home Assistant الذي تملكه العقدة والخاضع للمراجعة، أو تلغيها، لهذه الخدمة المحددة. مرّر `--yes` أو أجب عن السؤال؛ يتوقف التشغيل غير التفاعلي دون `--yes` قبل أي طلب برمز الخروج 9.</Warning>

| | |
| - | - |
| HTTP | `POST /api/v1/services/{serviceId}/connector` |
| يغيّر الحالة | نعم |
| أداة MCP | `setup_application_connector` |

| الوسيط | النوع | الوصف |
| - | - | - |
| `--service-id` | string | **مطلوب.** معرّف تشغيل الخدمة المعتمد. |
| `--action` | string | **مطلوب.** إحدى القيم: `ensure`, `revoke`. |
| `--expected-inventory-revision` | integer | **مطلوب.** |
| `--lifespan-days` | integer | **مطلوب.** |
| `--owner-approved` | boolean | **مطلوب.** إحدى القيم: `true`. |
| `--body` | json | جسم طلب JSON بصيغة `application/json`، كقيمة حرفية أو `@path` أو `-` للقراءة من stdin. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.