واجهة برمجة التطبيقات للتكوين - إضافة وتحديث وإزالة staticHost

نوصي بشدة قبل البدء في استخدام واجهة برمجة التطبيقات لـ Cato، بمراجعة سياسة الدعم لواجهة برمجة التطبيقات لـ Cato.

توضح هذه المقالة كيفية استخدام واجهة برمجة التطبيقات لـ Cato لإدارة المضيفين المحددين لموقع باستخدام هذه الأوامر:

addStaticHost
updateStaticHost
removeStaticHost

نظرة عامة على staticHost

استخدم واجهات برمجة التطبيقات لتعديل staticHost لإضافة وتحديث وإزالة المضيفين لموقع في حسابك وتعريف الإعدادات التالية للمضيف:

اسم المضيف
عنوان IP للمضيف
عنوان MAC (اختياري - يُستخدم لحجز تعيين IP باستخدام DHCP للمضيف)

لحسابات التجار، يمكنك إنشاء مفاتيح API منفصلة داخل حساب كل عميل تقوم بتكوين الإعدادات باستخدام واجهة برمجة التطبيقات لـ Cato.

تحديد موقع siteID لموقع

لم يتم عرض معرف الموقع في تطبيق إدارة Cato، يمكنك تحديد معرف الموقع:

باستخدام استعلام API entityLookup (انظر واجهة برمجة التطبيقات لـ Cato - EntityLookup)، استخدم type بالقيمة site

يمكنك أيضًا استخدام بارامتر search بالقيمة كاسم الموقع، ويعيد الاستعلام معرف الموقع
الرقم في عنوان URL لتطبيق إدارة Cato، عند تحديد موقع (الشبكة > المواقع > {site name}). على سبيل المثال، معرف الموقع هو 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، استخدم type بالقيمة host

اسم StaticHost

استخدم حجة name لتحديد اسم المضيف.

ip StaticHost

استخدم حجة ip لتحديد عنوان IP للمضيف.

عنوان MAC StaticHost (اختياري)

استخدم حجة macAddress لتحديد عنوان MAC للمضيف للحجز DHCP.

بالنسبة للحسابات التي تستخدم Cato كخادم DHCP، يتم حجز عنوان IP للمضيفين المحددين بعناوين MAC ولا يمكن تعيينه لمضيف مختلف. تأكد من أن عنوان IP للمضيف ليس ضمن نطاق DHCP لقطعة الشبكة المحددة للموقع.

removeStaticHost

استخدم واجهة برمجة التطبيقات removeStaticHost لحذف مضيف معرّف لموقع. تحتاج فقط إلى استخدام hostId مع هذه الواجهة البرمجية.

نموذج سكريبت Postman

mutation addStaticHost ($accountId: ID!, $siteId: ID!, $input:AddStaticHostInput!) {
    site(accountId: $accountId) {
      addStaticHost(
        siteId: $siteId, 
        input: $input
      ) {
      hostId
    }
  }
}

متغيرات GraphQL

{
    "accountId": "26",
    "siteId": 126,
    "input": {
        "primaryManagementIp": "192.168.4.2",
        "secondaryManagementIp": "192.168.4.3",
        "vrid": 100
    }
}

الموارد ذات الصلة