कॉन्फ़िगरेशन API - networkRange जोड़ना, अपडेट करना और हटाना

यह लेख इन कमांड्स का उपयोग करके साइट के लिए नेटवर्क रेंज प्रबंधित करने के लिए केटो API का उपयोग कैसे करें, इस पर विस्तृत जानकारी प्रदान करता है:

addNetworkRange
updateNetworkRange
removeNetworkRange

networkRange का अवलोकन

अपने खाते में एक सॉकेट साइट के लिए नेटवर्क रेंज जोड़ने, अपडेट करने और हटाने के लिए networkRange म्यूटेशन APIs का उपयोग करें और साइट के लिए निम्न सेटिंग्स परिभाषित करें:

नेटवर्क रेंज ID (स्वचालित रूप से addNetworkRange के लिए बनाई गई)
LAN सॉकेट इंटरफ़ेस ID
सबनेट, स्थानीय IP या गेटवे IP, और VLAN सहित नेटवर्क रेंज के लिए सेटिंग्स
Azure vSocket HA कॉन्फ़िगरेशन के लिए, फ्लोटिंग IP एड्रेस
नेटवर्क रेंज के लिए DHCP सेटिंग्स

रिसेलर खातों के लिए, आप उन ग्राहक खातों के अंदर अलग-अलग API कुंजी बना सकते हैं जिन्हें आप केटो API के साथ सेटिंग्स कॉन्फिगर कर रहे हैं।

आपके खाते के लिए अकाउंटId का पता लगाना

प्रशासन > सामान्य जानकारी पृष्ठ में खाता ID दिखाया गया है।

इस ID को साइट निर्माण API के लिए accountId तर्क में दर्ज करें, उदाहरण के लिए:

site(accountId: 26) {
    addSocketSite(input: $addSocketSite) { 
        siteId 
    } 
}

addNetworkRange और updateNetworkRange तर्कों का विवरण

Cato कॉन्फ़िगरेशन API का उपयोग करके सॉकेट साइट के लिए नेटवर्क रेंज बनाने या अपडेट करने के लिए वही तर्क उपयोग किए जाते हैं। addNetworkRange के लिए, तर्क अनिवार्य हैं जब तक कि उन्हें वैकल्पिक के रूप में चिह्नित न किया गया हो। updateNetworkRange के लिए, उन सॉकेट इंटरफ़ेस सेटिंग्स के लिए तर्क शामिल करें जिन्हें आप अपडेट कर रहे हैं।

networkRangeId - नेटवर्क रेंज के लिए ID (updateNetworkRange के लिए)
lanSocketInterfaceId - वे नेटवर्क इंटरफ़ेस के लिए ID जिसके साथ नेटवर्क रेंज जुड़ा हुआ है (addNetworkRange के लिए)
नाम - नेटवर्क रेंज का नाम
rangeType - नेटवर्क रेंज का प्रकार (रूटेड, डायरेक्ट, आदि)
सबनेट - CIDR प्रारूप में LAN इंटरफ़ेस के लिए मूल रेंज
localIP - LAN नेटवर्क रेंज के लिए स्थानीय IP पता
गेटवे - रूटेड रेंज के लिए, पड़ोसी राउटर के लिए अगला हॉप IP पता
vlan - नेटवर्क रेंज के लिए VLAN ID
azureFloutingIP - Azure HA कॉन्फ़िगरेशन के लिए, LAN रूट टेबल के लिए अगला हॉप IP पता
dhcpSettings - यह परिभाषित करता है कि क्या यह नेटवर्क रेंज डिफ़ॉल्ट खाता DHCP सेटिंग्स का उपयोग करता है या कस्टमाइज़ सेटिंग्स।

networkRangeId (updateNetworkRange के लिए)

entityLookup केवल-पढ़ने वाले API का उपयोग करके networkRangeId प्राप्त कर सकते हैं, प्रकार के साथ मान siteRange उपयोग करें।

आप search पैरामीटर का उपयोग भी कर सकते हैं जिसका मान साइट का नाम हो, और क्वेरी अन्य साइटों से रेंज को फ़िल्टर कर देगी।

lanSocketInterfaceId (addNetworkRange के लिए)

lanSocketInterfaceId तर्कों के लिए मान प्राप्त करने के लिए entityLookup API क्वेरी का उपयोग करें, जैसा कि निम्नलिखित है। अधिक जानकारी के लिए देखें Cato API - EntityLookup.

प्रकार का उपयोग करें जिसका मान networkInterface है, और इन parent फ़ील्ड से मान प्राप्त करें:

id - <site id>
नाम - <इंटरफ़ेस का नाम>

lanSocketInterfaceId के लिए एक नमूना स्क्रिप्ट देखें, नमूना पोस्टमैन स्क्रिप्ट.

networkRange का नाम

नाम तर्क नेटवर्क रेंज के नाम के लिए है।

networkRange rangeType

rangeType एक एनम तर्क है जो नेटवर्क रेंज के प्रकार को निर्धारित करता है।

ये विकल्प हैं:

रूटेड - नेटवर्क रेंज जो रूट के माध्यम से सॉकेट से जुड़ती है
डायरेक्ट - नेटवर्क रेंज जो सीधे सॉकेट या फायरवॉल से जुड़ी होती है (रूट के माध्यम से नहीं), लेकिन IP रेंज साइट की मूल रेंज से अलग होती है।
VLAN - Cato से जुड़ने वाली VLANs ट्रंक पोर्ट के समान होती हैं
मूल - प्रत्येक LAN इंटरफ़ेस के लिए परिभाषित IP रेंज
सेकेंडरी नेटिव - सॉकेट HA कॉन्फ़िगरेशन के लिए, द्वितीयक सॉकेट के लिए मूल रेंज

networkRange subnet

साइट के लिए नेटवर्क रेंज के लिए IP रेंज को सबनेट तर्क में CIDR IPSubnet प्रारूप में परिभाषित करें। /31 और /32 CIDR ब्लॉक्स समर्थित नहीं हैं।

networkRange localIP

(इन रेंज के लिए अनिवार्य: मूल, सेकेंडरी नेटिव, डायरेक्ट, VLAN) LAN नेटवर्क रेंज के लिए स्थानीय IP पता localIP तर्क में परिभाषित करें।

networkRange gateway

(रूटेड रेंज के लिए अनिवार्य) LAN नेटवर्क रेंज के लिए गेटवे IP पता gateway तर्क में परिभाषित करें।

networkRange vlan

(VLAN रेंज के लिए अनिवार्य) LAN नेटवर्क रेंज के लिए VLAN ID vlan तर्क में परिभाषित करें।

networkRange azureFloatingIp

(Azure HA सॉकेट कॉन्फ़िगरेशन के लिए अनिवार्य) LAN नेटवर्क रेंज के लिए फ्लोटिंग IP azureFloatingIp तर्क में परिभाषित करें।

networkRange dhcpSettings (वैकल्पिक)

dhcpSettings एक एनम तर्क है जो नेटवर्क रेंज के लिए DHCP सेटिंग्स को परिभाषित करता है।

ये विकल्प हैं:

dhcpType - नेटवर्क रेंज के लिए निम्नलिखित DHCP प्रकारों में से एक को कॉन्फ़िगर करें:
- DHCP_RELAY - नेटवर्क रेंज के लिए DHCP रिले कॉन्फ़िगर किया गया है (जो relayGroupId तर्क में परिभाषित है)
- DHCP_RANGE - Cato DHCP सर्वर द्वारा DHCP संचालित होता है, ipRange तर्क में परिभाषित IP रेंज के अनुसार
- ACCOUNT_DEFAULT - खाते के लिए परिभाषित डिफ़ॉल्ट DHCP रिले अनुरूप करता है
- DHCP_DISABLED - इस नेटवर्क रेंज के लिए DHCP निष्क्रिय है
ipRange - उपर्युक्त DHCP_Range विकल्प के लिए, वह IP रेंज परिभाषित करें जिसे Cato DHCP सर्वर होस्ट्स को असाइन कर सकता है
relayGroupId - वह ID दर्ज करें जिसे DHCP रिले समूह के लिए यह नेटवर्क रेंज उपयोग करता है

entityLookup के लिए, प्रकार का उपयोग करें जिसका मान dhcpRelayGroup है

removeNetworkRange

किसी साइट से नेटवर्क रेंज हटाने के लिए removeNetworkRange API का उपयोग करें। आपको केवल इस API के साथ networkRangeId का उपयोग करने की आवश्यकता है।

नमूना पोस्टमैन स्क्रिप्ट

lanSocketInterfaceID के लिए नमूना entityLookup

query entityLookup ($accountID: ID!, $type: EntityType!, $parent: EntityInput!) {
    entityLookup (accountID: $accountID, type: $type, parent: $parent) {
        items {
            entity {
                id
                name
                type
            }
            description
        }
    }
}

GraphQL Variables for entityLookup for lanSocketInterfaceID

{    
"accountID": "26",    
"type": "networkInterface",    
"parent": {
        "id": 26,
        "type": "site"
    }
}

नए VLAN रेंज बनाने के लिए नमूना पोस्टमैन स्क्रिप्ट

mutation addNetworkRange ($accountId: ID!, $lanSocketInterfaceId: ID!, $input: AddNetworkRangeInput!) {
    site(accountId: $accountId) {
        addNetworkRange (lanSocketInterfaceId: $lanSocketInterfaceId, input: $input) {
            networkRangeId
        }
    }
}

नए VLAN रेंज के लिए GraphQL परिवर्तनीय

{
    "accountId": "26",
    "lanSocketInterfaceId": 26,
    "input": {
        "name": "Guest WIFI",
        "rangeType": "VLAN",
        "subnet": "10.1.0.0/24",
        "localIp": "10.1.0.0.1",
        "vlan": 100
    }
}