--- title: "واجهة برمجة التطبيقات لتكوين - إضافة، تحديث، وإزالة نطاق الشبكة" slug: "configuration-api-adding-updating-and-removing-networkrange" updated: 2026-11-20T00:13:57Z published: 2026-11-20T00:13:57Z canonical: "knowledge.catonetworks.com/configuration-api-adding-updating-and-removing-networkrange" --- > ## 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. # واجهة برمجة التطبيقات لتكوين - إضافة، تحديث، وإزالة نطاق الشبكة نوصي بشدة بمراجعة [سياسة الدعم لواجهة برمجة التطبيقات من Cato](/v1/docs/support-policy-for-the-cato-api) قبل البدء في استخدامها. توضح هذه المقالة كيفية استخدام واجهة برمجة تطبيقات Cato لإدارة نطاقات الشبكة لموقع باستخدام هذه الأوامر: - addNetworkRange - updateNetworkRange - removeNetworkRange ## نظرة عامة على networkRange استخدم واجهات برمجة التطبيقات لتحويل الشبكة لإضافة وتحديث وإزالة نطاقات الشبكة لموقع Socket في حسابك وتحديد الإعدادات التالية للموقع: - معرف نطاق الشبكة (يتم إنشاؤه تلقائيًا لـ `addNetworkRange`) - معرف واجهة LAN Socket - الإعدادات لنطاق الشبكة بما في ذلك: الشبكة الفرعية، IP المحلي أو IP البوابة، و VLAN - لعناوين Azure vSocket HA، عنوان IP العائم - إعدادات DHCP لنطاق الشبكة لحسابات الموزعين، يمكنك إنشاء مفاتيح API منفصلة داخل كل حساب عميل الذي تقوم بتكوين الإعدادات فيه باستخدام واجهة برمجة التطبيقات Cato. ### تحديد الحساب الخاص بك يظهر معرّف الحساب في صفحة الإدارة> معلومات عامة. أدخل هذا المعرف في الوسيطة `accountId` لواجهة برمجة التطبيقات لإنشاء الموقع، على سبيل المثال: ```plaintext site(accountId: 26) { addSocketSite(input: $addSocketSite) { siteId } } ``` ## تفاصيل الحجج لـ addNetworkRange و updateNetworkRange يتم استخدام نفس الحجج لإنشاء أو تحديث نطاق شبكة لموقع Socket باستخدام واجهة برمجة التطبيقات لتكوين Cato. بالنسبة إلى addNetworkRange، تكون الحجج إلزامية ما لم تُحدد كاختيارية. بالنسبة إلى updateNetworkRange، قم بتضمين الحجج لإعدادات واجهة Socket التي تقوم بتحديثها. - معرّف networkRange - معرّف نطاق الشبكة (لـ updateNetworkRange) - معرّف lanSocketInterface - معرّف واجهة الشبكة التي يرتبط بها نطاق الشبكة (لـ addNetworkRange) - الاسم - اسم نطاق الشبكة - نوع النطاق - نوع نطاق الشبكة (مسار، مباشر، وغيرها) - الشبكة الفرعية - النطاق الأصلي لواجهة الشبكة المحلية بتنسيق CIDR - عنوان IP المحلي - عنوان IP المحلي لنطاق شبكة LAN - البوابة - للمسارات الموجهة، عنوان IP للقفزة التالية لجهاز التوجيه المجاور - vlan - معرف VLAN لنطاق الشبكة - azureFloutingIP - لتكوينات Azure HA، عنوان IP للقفزة التالية لجدول مسار LAN - dhcpSettings - يحدد ما إذا كان هذا النطاق الشبكي يستخدم إعدادات DHCP للحساب الافتراضي أو إعدادات مخصصة ### networkRangeId (لـ updateNetworkRange) يمكن الحصول على معرف networkRangeId باستخدام واجهة برمجة التطبيقات للبحث عن الكيانات [entityLookup](/v1/docs/cato-api-entitylookup)، استخدم `type` بالقيمة **siteRange** يمكنك أيضًا استخدام معامل `search` بالقيمة كاسم الموقع، وسيتم تصفية الاستعلام لإزالة النطاقات من مواقع أخرى. ### lanSocketInterfaceId (لـ addNetworkRange) استخدم استعلام API للبحث عن الكيانات لاسترداد القيم للحجج lanSocketInterfaceId، كالتالي. لمزيد من المعلومات، راجع [واجهة برمجة التطبيقات لـ Cato - EntityLookup](/v1/docs/cato-api-entitylookup). استخدم `type` مع القيمة **networkInterface**، والقيم من هذه الحقول `parent`: - معرّف - <معرّف الموقع> - الاسم - <اسم الواجهة> انظر sample script لمعرفة lanSocketInterfaceId أدناه، [Sample Postman Script](/v1/docs/configuration-api-adding-updating-and-removing-networkrange#sample-postman-script). ### networkRange name الحجة `name` هي لاسم نطاق الشبكة. ### نوع النطاق networkRange الحجة `rangeType` هي حجة enum تحدد نوع نطاق الشبكة. هذه هي الخيارات: - مسار - نطاق الشبكة الذي يتصل بـ Socket عبر مسار - مباشر - نطاق الشبكة يتصل مباشرة بـ Socket أو جدار الحماية (ليس عبر جهاز توجيه)، ولكن نطاق IP يختلف عن النطاق الأصلي للموقع. - VLAN - VLANs التي تتصل بـ Cato تشبه منفذ الجذع - أصلي - نطاق IP المحدد لكل واجهة LAN - Native ثانوي - لتكوينات Socket HA، النطاق الأصلي لـ Socket الثانوي ### الشبكة الفرعية networkRange حدد نطاق IP لنطاق الشبكة للموقع في الحجة `subnet` في صيغة IPSubnet CIDR. /31 و /32 كتل CIDR غير مدعومة. ### localIP لنطاق الشبكة (إلزامي لهذه النطاقات: أصلي، Native ثانوي، مباشر، VLAN) حدد عنوان IP المحلي لنطاق LAN في الحجة `localIP`. ### gateway لنطاق الشبكة (إجباري للمسارات الموجهة) حدد عنوان IP للبوابة لنطاق شبكة LAN في الحجة `gateway`. ### vlan لنطاق الشبكة (إجباري لنطاقات VLAN) حدد معرف VLAN لنطاق شبكة LAN في الحجة `vlan`. ### azureFloatingIp لنطاق الشبكة (إجباري لتكوينات Azure HA Socket) حدد عنوان IP العائم لنطاق شبكة LAN في الحجة `azureFloatingIp`. ### dhcpSettings لنطاق الشبكة (اختياري) الحجة `dhcpSettings` هي حجة enum تحدد إعدادات DHCP لنطاق الشبكة. هذه هي الخيارات: - نوع dhcp - قم بتكوين أحد أنواع DHCP التالية لنطاق الشبكة: - DHCP_RELAY - تستخدم الشبكة نطاق DHCP relay مُكوَّنًا للحساب (مُعرَّفة في الحجة `relayGroupId`) - DHCP_RANGE - يستخدم النطاق الشبكي خادم DHCP الخاص بـ Cato لـ DHCP، وفقًا للنطاق المعرّف في الحجة `ipRange` - ACCOUNT_DEFAULT - يستخدم النطاق الشبكي relay DHCP الافتراضي المُعرَّف للحساب - DHCP_DISABLED - تم تعطيل DHCP لهذا النطاق الشبكي - ipRange - للخيار DHCP_Range أعلاه، حدد نطاق IP الذي يمكن لخادم DHCP الخاص بـ Cato تعيينه إلى الأجهزة - relayGroupId - أدخل معرف مجموعة relay DHCP التي يستخدمها هذا النطاق الشبكي للـ entityLookup، استخدم `type` بالقيمة **dhcpRelayGroup** ## removeNetworkRange استخدم واجهة برمجة التطبيقات `removeNetworkRange` لحذف نطاق شبكة من موقع. تحتاج فقط لاستخدام `networkRangeId` مع هذه الواجهة. ## نموذج سكريبت Postman ### نموذج entityLookup لمعرفة lanSocketInterfaceID ```plaintext query entityLookup ($accountID: ID!, $type: EntityType!, $parent: EntityInput!) {    entityLookup (accountID: $accountID, type: $type, parent: $parent) {        items {            entity {                id                name                type            }            description        }    } } ``` **متغيرات GraphQL لـ entityLookup لـ lanSocketInterfaceID** ```plaintext {     "accountID": "26",     "type": "networkInterface",     "parent": {        "id": 26,        "type": "site"    } } ``` ### نموذج Postman Script لإنشاء نطاق VLAN جديد ```plaintext mutation addNetworkRange ($accountId: ID!, $lanSocketInterfaceId: ID!, $input: AddNetworkRangeInput!) {    site(accountId: $accountId) {        addNetworkRange (lanSocketInterfaceId: $lanSocketInterfaceId, input: $input) {            networkRangeId        }    } } ``` **متغير GraphQL لنطاق VLAN جديد** ```plaintext {    "accountId": "26",    "lanSocketInterfaceId": 26,    "input": {        "name": "واي فاي الضيوف",        "rangeType": "VLAN",        "subnet": "10.1.0.0/24",        "localIp": "10.1.0.0.1",        "vlan": 100    } } ``` ### المصادر ذات الصلة - [استخدام API لإنشاء موقع كاتو مع Postman](/v1/docs/using-the-cato-site-creation-api-with-postman) - [برامج واجهة برمجة التطبيقات للتكوين](https://support.catonetworks.com/hc/en-us/articles/8130916998429)