نوصي بشدة بمراجعة سياسة الدعم لواجهة برمجة التطبيقات من Cato قبل البدء في استخدامها.
نظرة عامة على addSocketSite
استخدم واجهة برمجة التطبيقات mutation لـ addSocketSite لإنشاء موقع جديد في حسابك وتحديد الإعدادات التالية للموقع:
الاسم
Description
النمط
نوع الاتصال
Timezone
الدولة
State
عنوان
النطاق الأصلي
يتم إنشاء الموقع بإعدادات النطاق الترددي الافتراضية، 25 ميجابت في الثانية نزولاً و 25 ميجابت في الثانية صعودًا، ويتم إنشاؤه دون ترخيص مخصص له.
لحسابات الموزعين، يمكنك إنشاء مفاتيح API منفصلة داخل كل حساب عميل الذي تقوم بتكوين الإعدادات فيه باستخدام واجهة برمجة التطبيقات Cato.
تحديد الحساب الخاص بك
هذا المعرف للحساب لا يظهر في تطبيق إدارة Cato، بل هو الرقم في رابط تطبيق إدارة Cato. على سبيل المثال، معرف الحساب هو 26 لعنوان URL التالي: https://cc.catonetworks.com/#!/26/topology.
أدخل هذا المعرف في الوسيطة accountId لواجهة برمجة التطبيقات لإنشاء الموقع، على سبيل المثال:
site(accountId: 26) {
addSocketSite(input: $addSocketSite) {
siteId
}
}تفاصيل حجج addSocketSite
هذه هي الحجج لإنشاء موقع Socket جديد باستخدام واجهة برمجة تكوين Cato. الوسائط إلزامية ما لم يتم تحديدها كاختيارية:
الاسم - اسم الموقع
connectionType - مخرج مادي أو vSocket لهذا الموقع
siteType - نوع الموقع في منظمتك، على سبيل المثال مركز بيانات السحابة
description - (اختياري) وصف الموقع
nativeNetworkRange - نطاق IP للشبكة المحلية الأصلية خلف الموقع، في صيغة CIDR
siteLocation - بيانات حول الموقع الفعلي للموقع
اسم AddSocketSite
حدد اسم الموقع Socke الذي تقوم بإنشائه.
نوع الاتصال لـ AddSocketSite
connectionType هو حجة تعداد تحدد نوع المخرج المادي أو الافتراضي للموقع.
هذه هي الخيارات:
SOCKET_X1500 - مخرج X1500 أو X1500B لموقع مادي
SOCKET_X1600 - مخرج X1600 لموقع مادي
SOCKET_X1700 - مخرج X1700 أو X1700B لموقع مادي
SOCKET_ESX - vSocket لموقع افتراضي VMware
SOCKET_AWS - vSocket لموقع افتراضي AWS
SOCKET_AZURE - vSocket لموقع افتراضي Azure
نوع الموقع AddSocketSite
siteType عبارة عن وسيطة تعداد تحدد نوع الموقع الذي يحدد الرمز المستخدم للموقع في شاشة المراقبة > الطوبولوجيا في تطبيق إدارة Cato.
هذه هي الخيارات:
BRANCH - مواقع فعلية أو افتراضية
HEADQUARTERS - مواقع فعلية للمقر الرئيسي للشركة
CLOUD_DC - مواقع افتراضية لمراكز بيانات مستندة إلى السحابة
DATACENTER - مواقع فعلية لمراكز البيانات
وصف AddSocketSite (اختياري)
description عبارة عن حقل نصي حر اختياري لوصف الموقع.
النطاق الأصلي AddSocketSite
حدد نطاق IP للنطاق المحلي للموقع في الحجة nativeNetworkRange بتنسيق IPSubnet. النطاق المحلي يستخدم CIDR للشبكة الفرعية، وكتل CIDR /32 غير مدعومة.
موقع AddSocketSite
وسائط siteLocation تحدد التفاصيل الفعلية التالية للموقع. countryCode ذات صلة بعدد تراخيص المواقع المتاحة لمنطقة محددة في حسابك.
يمكنك استخدام استعلام entityLookup API لاسترجاع القيم لهذه الوسائط، راجع Cato API - EntityLookup.
هذه هي وسائط siteLocation:
countryCode - رمز من حرفين (ISO 3166-1 alpha-2) للدولة التي يقع فيها الموقع
للبحث عن الكيان، استخدم
typeبالقيمة country.stateCode - (اختياري) للدول المطبقة، الولاية التي يقع فيها الموقع
للبحث عن الكيان، استخدم
typeبالقيمة countryState.timezone - منطقة زمنية للموقع، تستخدم لتحديد الإطار الزمني لفترة الصيانة لترقيات Socket وvSocket
للبحث عن الكيان، استخدم
typeبالقيمة timezone.address - (اختياري) عنوان الشارع للموقع الفعلي
نموذج برنامج Postman
mutation addSocketSite ($accountId: ID!, $input: AddSocketSiteInput!) {
site(accountId: $accountId) {
addSocketSite (input: $input) {
siteId
}
}
}متغيرات GraphQL
{
"accountId": "26",
"input": {
"name": "SampleUsSite2",
"description": "My first API site",
"siteType": "BRANCH",
"connectionType": "SOCKET_X1500",
"nativeNetworkRange": "10.0.0.0/24",
"siteLocation": {
"countryCode": "US",
"timezone": "US/Central",
"stateCode": "US-AL"
}
}
}المصادر ذات الصلة