हम दृढ़ता से अनुशंसा करते हैं कि Cato API का उपयोग शुरू करने से पहले, कृपया Cato API के लिए सहायता नीति की समीक्षा करें।
अपडेट सॉकेट इंटरफेस का अवलोकन
Cato प्रबंधन अनुप्रयोग (नेटवर्क > साइट्स > {साइट का नाम} > साइट कॉन्फ़िगरेशन > सॉकेट) में किसी साइट के लिए सॉकेट अनुभाग की निम्नलिखित इंटरफ़ेस सेटिंग्स को अपडेट करने के लिए अपडेट सॉकेट इंटरफेस म्युटेशन एपीआई का उपयोग करें का उपयोग करें।
इंटरफेस के लिए गंतव्य
नाम
लैन इंटरफेस सेटिंग्स
साइट बैंडविड्थ
WAN इंटरफेस सेटिंग्स
ऑफ क्लाउड (केटो गंतव्य के लिए)
वैकल्पिक WAN इंटरफेस सेटिंग्स
LAG (लिंक एकत्रीकरण) सदस्य
VRRP प्रकार
साइट के लिए साइटआईडी का पता लगाना
साइट आईडी Cato प्रबंधन अनुप्रयोग में नहीं दिखाया गया है, आप साइट आईडी का पता लगा सकते हैं:
entityLookup एपीआई क्वेरी का उपयोग करके (देखें Cato एपीआई - EntityLookup),
typeका उपयोग मूल्य के साथ siteआप साइट के नाम के रूप में मान के साथ
searchपैरामीटर का भी उपयोग कर सकते हैं, और क्वेरी साइट आईडी लौटाएगी।Cato प्रबंधन अनुप्रयोग के URL में संख्या, जब आपने एक साइट चुनी (नेटवर्क > साइट्स > {साइट का नाम})। उदाहरण के लिए, निम्नलिखित URL के लिए साइट आईडी 12345 है: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics
सॉकेट के लिए socketInterfaceId मानों को समझना
socketInterfaceId एक ईनम है जिसमें Cato सॉकेट्स के लिए मान होते हैं। इंटरफेस नाम साइट के लिए सॉकेट स्क्रीन में (नेटवर्क > साइट्स > {साइट का नाम} > साइट कॉन्फ़िगरेशन > सॉकेट) इस प्रकार दिखाए जाते हैं:
X1500 सॉकेट - स्वचालित, LAN1, LAN2, WAN1, WAN2, WAN3, USB1, USB2
X1600 सॉकेट - 1-8, USB1, USB2
X1700 सॉकेट - INT_1 - INT_12
updateSocketInterfaceInput तर्कों के लिए विवरण
Cato कॉन्फ़िगरेशन एपीआई का उपयोग करके किसी साइट के लिए निम्नलिखित सॉकेट इंटरफेस सेटिंग्स को अपडेट करने के लिए ये तर्क हैं। केवल destType तर्क अनिवार्य है, अन्यथा आप जिन सॉकेट इंटरफेस सेटिंग्स को अपडेट कर रहे हैं, उनके लिए तर्क शामिल करें।
destType - इंटरफेस के लिए गंतव्य
नाम - साइट का नाम
lan - LAN इंटरफेस सेटिंग्स
बैंडविड्थ - साइट अपस्ट्रीम और डाउनस्ट्रीम बैंडविड्थ
wan - WAN इंटरफेस सेटिंग्स
offCloud - गंतव्य Cato के साथ इंटरफेस के लिए ऑफ क्लाउड की सेटिंग्स
altWAN - गंतव्य वैकल्पिक WAN या वैकल्पिक WAN (लेयर-2) के साथ इंटरफेस के लिए सेटिंग्स
lag - LAN LAG मास्टर गंतव्य के लिए, इस लिंक एकत्रीकरण (LAG) के लिए लिंक की न्यूनतम संख्या (मास्टर और सदस्य सहित)
vrrp - सॉकेट उच्च उपलब्धता (HA) कॉन्फ़िगरेशन के लिए, सॉकेट्स के बीच VRRP कनेक्शन का प्रकार
updateSocketInterfaceInput destType
destType एक ईनम तर्क है, जो इंटरफेस के लिए गंतव्य को परिभाषित करता है।
ये विकल्प हैं:
CATO - Cato क्लाउड के लिए WAN ट्रैफ़िक
LAN - सॉकेट के पीछे आंतरिक LAN
VRRP_AND_LAN - सॉकेट HA के लिए, इंटरफेस LAN और VRRP ट्रैफ़िक के लिए उपयोग किया जाता है
INTERFACE_DISABLED - इंटरफेस अक्षम है और ट्रैफ़िक नहीं भेज रहा है
ALTERNATIVE - Cato क्लाउड के बिना WAN ट्रैफ़िक, जैसे कि MPLS
LAYER_2_WAN - वैकल्पिक WAN (लेयर-2) विकल्प के लिए एक MPLS नेटवर्क जिसमें सॉकेट साइट्स एक ही सबनेट पर हैं
VRRP - सॉकेट HA के लिए, इंटरफेस केवल VRRP ट्रैफ़िक के लिए उपयोग किया जाता है
LAN_LAG_MASTER_AND_VRRP - सॉकेट HA और LAN LAG कॉन्फ़िगरेशन के लिए, इंटरफेस LAN LAG मास्टर है और VRRP ट्रैफ़िक के लिए उपयोग किया जाता है
LAN_LAG_MASTER - LAN LAG कॉन्फ़िगरेशन के लिए, इंटरफेस LAN LAG मास्टर है
LAN_LAG_MEMBER - LAN LAG कॉन्फ़िगरेशन के लिए, इंटरफेस LAN LAG सदस्य है
LAN_AND_HA - Azure और AWS में vSocket HA के लिए, इंटरफेस LAN और HA ट्रैफ़िक के लिए है
updateSocketInterfaceInput नाम
नाम तर्क सॉकेट इंटरफेस के नाम के लिए है।
updateSocketInterfaceInput lan
lan तर्क सॉकेट के लिए एक LAN इंटरफेस की सेटिंग्स के लिए होते हैं।
ये विकल्प हैं:
सबनेट - CIDR प्रारूप में LAN इंटरफेस के लिए देशी रेंज
स्थानीयIP - LAN नेटवर्क रेंज के लिए स्थानीय आईपी पता
updateSocketInterfaceInput बैंडविड्थ
इंटरफेस जो WAN ट्रैफ़िक के लिए उपयोग किए जाते हैं, उनके लिए बैंडविड्थ तर्क इंटरफेस के लिए अपस्ट्रीम और डाउनस्ट्रीम बैंडविड्थ को परिभाषित करते हैं।
ये विकल्प हैं:
upstreamBandwidth - इस सॉकेट इंटरफेस के लिए अधिकतम अपस्ट्रीम बैंडविड्थ
downstreamBandwidth - इस सॉकेट इंटरफेस के लिए अधिकतम डाउनस्ट्रीम बैंडविड्थ
updateSocketInterfaceInput wan
wan तर्क सॉकेट के WAN इंटरफेस के लिए सेटिंग्स के हैं। WAN भूमिकाएँ आमतौर पर नेटवर्क नियमों में ट्रैफ़िक को परिभाषित करने के लिए उपयोग की जाती हैं। प्रीसीडेंस का उपयोग सक्रिय और निष्क्रिय इंटरफेस के साथ सॉकेट के लिए फेलओवर प्राथमिकता के लिए किया जाता है।
ये विकल्प हैं:
भूमिका - WAN इंटरफेस के लिए भूमिका परिभाषित करें: कोई नहीं, स्वचालित, wan_1, wan_2, wan_3
प्राथमिकता - इंटरफेस के लिए फेलओवर प्राथमिकता परिभाषित करें: सक्रिय, निष्क्रिय, अंतिम उपाय
अंतिम उपाय सबसे कम प्राथमिकता वाला इंटरफेस है
updateSocketInterfaceInput offCloud
offCloud तर्क उन सॉकेट साइट्स के लिए हैं जो ऑफ-क्लाउड फीचर का उपयोग करके ट्रैफ़िक को पब्लिक इंटरनेट पर रूट करते हैं बजाय केटो क्लाउड पर।
ये विकल्प हैं:
सक्रिय - बूलियन मान, जब
सहीतब साइट के लिए ऑफ-क्लाउड ट्रैफ़िक सक्षम हैpublicIP (वैकल्पिक) - इंटरनेट से कनेक्शन शुरू करने के लिए एक स्थिर सार्वजनिक IP पता परिभाषित करता है
publicStaticPort (वैकल्पिक) - ऑफ-क्लाउड ट्रैफ़िक के लिए एक स्थिर पोर्ट नंबर परिभाषित करता है
updateSocketInterfaceInput altWan
altWan तर्क उन सॉकेट साइट्स के लिए हैं जो वैकल्पिक WAN नेटवर्क जैसे MPLS से जुड़ते हैं। आमतौर पर, MPLS प्रदाता से सीधे कनेक्टिंग के लिए निजी आईपी और इंटरफेस का उपयोग किया जाता है।
ये विकल्प हैं:
privateInterfaceIp - ट्रैफ़िक के लिए सॉकेट इंटरफेस के लिए निजी IP पता
privateNetwork - LAN के लिए निजी IP रेंज (CIDR के साथ)
privateGatewayIp - वैकल्पिक WAN गेटवे के लिए निजी IP पता (जैसे MPLS फ़ायरवॉल या राउटर)
privateVlanTag (वैकल्पिक) - इंटरफेस के लिए VLAN टैग (निजी IP पता)
publicInterfaceIP (वैकल्पिक) - ट्रैफ़िक के लिए सॉकेट इंटरफेस के लिए सार्वजनिक IP पता
publicNetwork (वैकल्पिक) - LAN के लिए सार्वजनिक IP रेंज (CIDR के साथ)
publicGatewayIp (वैकल्पिक) - वैकल्पिक WAN गेटवे के लिए सार्वजनिक IP पता (जैसे MPLS फ़ायरवॉल या राउटर)
publicVlantag (वैकल्पिक) - इंटरफेस के लिए VLAN टैग (सार्वजनिक IP पता)
updateSocketInterfaceInput lag
lag तर्क मुख्य LAN LAG इंटरफ़ेस के लिए है और इस सॉकेट साइट के लिए LAG के लिए न्यूनतम इंटरफेस (मास्टर और सदस्य सहित) निर्धारित करता है।
यह विकल्प है:
minLinks - LAG में न्यूनतम इंटरफेस (लिंक) की संख्या
updateSocketInterfaceInput vrrp
vrrp एनम तर्क सॉकेट HA कॉन्फ़िगरेशन के लिए है और कीपअलाइव संदेशों के लिए सॉकेट्स के बीच VRRP कनेक्शन के प्रकार को परिभाषित करता है।
ये विकल्प हैं:
VIA_SWITCH - VRRP कनेक्शन सॉकेट्स के बीच एक स्विच के माध्यम से मार्गित है
DIRECT_LINK - VRRP कनेक्शन सॉकेट्स के बीच सीधे मार्गित है
नमूना पोस्टमैन स्क्रिप्ट
उदाहरण स्क्रिप्ट - मूल रेंज और नाम अपडेट कर रहे हैं
यह LAN1 इंटरफेस के नाम को LAN-01 में बदलने के लिए कॉन्फ़िगरेशन API का उपयोग करने का एक उदाहरण है, और सॉकेट के लिए मूल रेंज का सबनेट और स्थानीय IP अपडेट करें।
mutation updateSocketInterface ($accountId: ID!, $siteId: ID!, $socketInterfaceId: SocketInterfaceIDEnum!, $input: UpdateSocketInterfaceInput!) {
site(accountId: $accountId) {
updateSocketInterface (siteId: $siteId, socketInterfaceId: $socketInterfaceId, input: $input) {
siteId
socketInterfaceId
}
}
}GraphQL वेरिएबल्स
{
"accountId": "26",
"siteId": 26,
"socketInterfaceId": "LAN1",
"input": {
"नाम": "LAN-01",
"destType": "LAN",
"lan": {
"subnet": "10.0.0.0/24",
"localIp": "10.0.0.1"
}
}
}उदाहरण स्क्रिप्ट - बैंडविड्थ और नाम बदल रहे हैं
यह WAN इंटरफेस के लिए बैंडविड्थ और नाम बदलने के लिए कॉन्फ़िगरेशन API का उपयोग करने का एक उदाहरण है।
mutation updateSocketInterface ($accountId: ID!, $siteId: ID!, $socketInterfaceId: SocketInterfaceIDEnum!, $input: UpdateSocketInterfaceInput!) {
site(accountId: $accountId) {
updateSocketInterface (siteId: $siteId, socketInterfaceId: $socketInterfaceId, input: $input) {
siteId
socketInterfaceId
}
}
}GraphQL वेरिएबल्स
{
"accountId": "26",
"siteId": 126,
"socketInterfaceId": "WAN1",
"input": {
"नाम": "WAN Demo",
"destType": "CATO",
"bandwidth": {
"upstreamBandwidth": 100,
"downstreamBandwidth": 100
}
}
}