--- title: "واجهة برمجة التطبيقات للتكوين - إضافة وتحديث وإزالة staticHost" slug: "configuration-api-adding-updating-and-removing-statichost" updated: 2026-07-30T02:30:58Z published: 2026-07-30T02:30:58Z canonical: "knowledge.catonetworks.com/configuration-api-adding-updating-and-removing-statichost" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # واجهة برمجة التطبيقات للتكوين - إضافة وتحديث وإزالة staticHost نوصي بشدة بمراجعة [سياسة الدعم لواجهة برمجة التطبيقات من Cato](/v1/docs/support-policy-for-the-cato-api) قبل البدء في استخدامها. توضح هذه المقالة كيفية استخدام واجهة برمجة التطبيقات لـ Cato لإدارة المضيفين المحددين لموقع باستخدام هذه الأوامر: - addStaticHost - updateStaticHost - removeStaticHost ## نظرة عامة على staticHost استخدم واجهات برمجة التطبيقات لتعديل staticHost لإضافة وتحديث وإزالة المضيفين لموقع في حسابك وتعريف الإعدادات التالية للمضيف: - اسم المضيف - عنوان IP للمضيف - عنوان MAC (اختياري - يُستخدم لحجز تعيين IP باستخدام DHCP للمضيف) لحسابات الموزعين، يمكنك إنشاء مفاتيح API منفصلة داخل كل حساب عميل الذي تقوم بتكوين الإعدادات فيه باستخدام واجهة برمجة التطبيقات Cato. ### تحديد موقع معرف الموقع لموقع لا يظهر معرف الموقع في تطبيق إدارة Cato، يمكنك تحديد معرف الموقع: - باستخدام استعلام واجهة برمجة التطبيقات entityLookup (راجع [واجهة برمجة التطبيقات Cato - EntityLookup](/v1/docs/cato-api-entitylookup))، استخدم `النوع` بالقيمة **الموقع** يمكنك أيضًا استخدام معامل `search` بالقيمة كاسم الموقع، ويعيد الاستعلام معرف الموقع - الرقم في عنوان URL لتطبيق إدارة Cato، عند اختيارك لموقع (الشبكة > المواقع > {اسم الموقع}). على سبيل المثال، معرف الموقع هو 12345 لعنوان URL التالي: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics ## تفاصيل حجج addStaticHost و updateStaticHost تُستخدم نفس الحجج لإنشاء أو تحديث مضيف خلف موقع باستخدام واجهة برمجة تطبيقات التكوين لـ Cato. بالنسبة لـ `addStaticHost`، تكون الحجج إلزامية إلا إذا كانت مميزة كاختيارية. بالنسبة لـ `updateStaticHost`، قم بتضمين الحجج لإعدادات المضيف التي تقوم بتحديثها. - hostId - بالنسبة لـ `updateStaticHost`، أدخل المعرف للمضيف الذي تقوم بتحديثه بالنسبة لـ `addStaticHost`، يتم إنشاء هذا المعرف عند إنشاء المضيف الجديد - name - اسم المضيف خلف الموقع - ip - عنوان IP للمضيف خلف الموقع - macAddress - (اختياري) عنوان MAC للمضيف خلف الموقع يُستخدم عنوان MAC للمضيف للحجز DHCP للمضيفين بعنوان IP ثابت ### معرف StaticHost `hostId` هو المعرف الداخلي لـ Cato لكيان المضيف. يمكن استرداد `networkRangeId` باستخدام واجهة برمجة التطبيقات للقراءة فقط [entityLookup](/v1/docs/cato-api-entitylookup)، استخدم `type` بالقيمة **host** ### اسم StaticHost استخدم حجة `name` لتحديد اسم المضيف. ### ip StaticHost استخدم حجة `ip` لتحديد عنوان IP للمضيف. ### عنوان MAC StaticHost (اختياري) استخدم حجة `macAddress` لتحديد عنوان MAC للمضيف للحجز DHCP. بالنسبة للحسابات التي تستخدم Cato كخادم DHCP، يتم حجز عنوان IP للمضيفين المحددين بعناوين MAC ولا يمكن تعيينه لمضيف مختلف. تأكد من أن عنوان IP للمضيف ليس ضمن نطاق DHCP لقطعة الشبكة المحددة للموقع. ## removeStaticHost استخدم واجهة برمجة التطبيقات `removeStaticHost` لحذف مضيف معرّف لموقع. تحتاج فقط إلى استخدام `hostId` مع هذه الواجهة البرمجية. ## نموذج برنامج Postman ```plaintext mutation addStaticHost ($accountId: ID!, $siteId: ID!, $input:AddStaticHostInput!) {    site(accountId: $accountId) {      addStaticHost(        siteId: $siteId,        input: $input      ) {      hostId    }  } } ``` **متغيرات GraphQL** ```plaintext {    "accountId": "26",    "siteId": 126,    "input": {        "primaryManagementIp": "192.168.4.2",        "secondaryManagementIp": "192.168.4.3",        "vrid": 100    } } ``` **المصادر ذات الصلة** - [استخدام API لإنشاء موقع كاتو مع Postman](/docs/ar/\/v1\/docs\/\u0627\u0633\u062a\u062e\u062f\u0627\u0645-\u0627\u062a\u062d\u0627\u062f-\u0625\u0646\u0634\u0627\u0621-\u0627\u0644\u0645\u0648\u0642\u0639-\u0644\u0643\u0627\u062a\u0648-\u0645\u0639-postman) - [برامج واجهة برمجة التطبيقات للتكوين](https://support.catonetworks.com/hc/en-us/articles/8130916998429)