نوصي بشدة بمراجعة سياسة الدعم لواجهة برمجة التطبيقات من Cato قبل البدء في استخدامها.
توضح هذه المقالة كيفية استخدام واجهة برمجة التطبيقات لـ Cato لإدارة المضيفين المحددين لموقع باستخدام هذه الأوامر:
addStaticHost
updateStaticHost
removeStaticHost
نظرة عامة على staticHost
استخدم واجهات برمجة التطبيقات لتعديل staticHost لإضافة وتحديث وإزالة المضيفين لموقع في حسابك وتعريف الإعدادات التالية للمضيف:
اسم المضيف
عنوان IP للمضيف
عنوان MAC (اختياري - يُستخدم لحجز تعيين IP باستخدام DHCP للمضيف)
لحسابات الموزعين، يمكنك إنشاء مفاتيح API منفصلة داخل كل حساب عميل الذي تقوم بتكوين الإعدادات فيه باستخدام واجهة برمجة التطبيقات Cato.
تحديد موقع معرف الموقع لموقع
لا يظهر معرف الموقع في تطبيق إدارة Cato، يمكنك تحديد معرف الموقع:
باستخدام استعلام واجهة برمجة التطبيقات entityLookup (راجع واجهة برمجة التطبيقات Cato - 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، استخدم 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
}
}المصادر ذات الصلة