केटो API संभावित रूप से परिवर्तन और अंत-जीवन (EoL)

यह लेख केटो GraphQL API योजना को संभावित रूप से परिवर्तन करने और अंत-जीवन (EoL) घोषणाओं के लिए सूचनाओं के लिए एक मंच है और इसमें जानकारी शामिल है जो आपको API क्लाइंट को अपडेट करने की आवश्यकता हो सकती है।

इस लेख में प्रयुक्त API शर्तें Cato API क्या है में समझाई जाती हैं।

केटो API का उपयोग करने वाले किसी भी ग्राहक के लिए, हम अनुशंसा करते हैं कि आप अनुसरण करें पर क्लिक करें ताकि इस लेख में API में परिवर्तन के बारे में अपडेट के लिए स्वचालित रूप से ईमेल सूचनाएं प्राप्त की जा सके। आप Cato API Changelog में नई और अद्यतन APIs के बारे में अधिक जानकारी भी देख सकते हैं।

APIs के बारे में अधिक जानकारी के लिए, Cato Networks GraphQL API Reference देखें।

संभावित रूप से परिवर्तन संबंधी बदलाव

2026-06-21 - API आईडी फ़ील्ड्स: प्रकार से परिवर्तन करें लंबा/पूर्णांक को स्ट्रिंग

वर्तमान में, Cato का एपीआई गेटवे आईडी फ़ील्ड्स को या तो स्ट्रिंग या लंबा (पूर्णांक) वापस कर सकता है। आगामी संरचना अपडेट के हिस्से के रूप में, सभी आईडी फ़ील्ड्स हमेशा स्ट्रिंग के रूप में वापस किए जाएंगे।

  • क्या बदल रहा है: एपीआई प्रतिक्रियाएँ जो पहले आईडी फ़ील्ड्स को एक संख्यात्मक लंबा मान के रूप में वापस करती थीं (उदाहरण के लिए, 1000000002) अब उन्हें हमेशा स्ट्रिंग के रूप में वापस करेगी (उदाहरण के लिए, "1000000002")।
  • कौन प्रभावित हो रहा है: API क्लाइंट्स जो आईडी फ़ील्ड्स को केवल लंबे/पूर्णांक प्रकार के रूप में संभालते हैं जब यह परिवर्तन लागू होगा।
  • आपको 21 जून, 2026 से पहले क्या करना चाहिए: अपने API क्लाइंट कोड को आईडी फ़ील्ड्स के लिए लंबे और स्ट्रिंग दोनों प्रकारों को स्वीकार करने के लिए अपडेट करें। यह संक्रमण को सुचारू बनाएगा और परिवर्तन के प्रभावी होने पर व्यवधानों को रोकेगा।

2025-08-10 - ईमेल फ़ील्ड में परिवर्तन addAdmin और updateAdmin एपीआई में

10 अगस्त, 2025 को, addAdmin और updateAdmin एपीआई में ईमेल फ़ील्ड वैकल्पिक (nullable) बन गया। इस परिवर्तन से सेवा प्रिंसिपल्स का उपयोग करने वाली स्क्रिप्ट्स और ऑटोमेशन सहित सूक्ष्म API पहुँच नियंत्रण के लिए आगामी इंफ्रास्ट्रक्चर का समर्थन होता है।

  • वर्तमान और भविष्य के मानव CMA व्यवस्थापकों को हमेशा एक ईमेल मान शामिल करना चाहिए
  • वापसी किए जाने वाले केवल मानव व्यवस्थापक प्रभावित नहीं हैं।
  • कुछ क्लाइंट्स को प्रतिक्रिया पेलोड्स में शून्य मानों को संभालने की आवश्यकता हो सकती है, जैसे कि addAdminPayload

यह आमतौर पर एक परिवर्तनशील परिवर्तन नहीं है, लेकिन यह उन क्लाइंट्स को प्रभावित कर सकता है जो मानते हैं कि email हमेशा उपस्थित है। समस्याओं से बचने के लिए अपने एकीकरण की समीक्षा करें।

2025-04-27 - eventsFeed क्वेरी एपीआई सबसे हाल की घटनाओं को लाने का समर्थन करता है

eventsFeed API घटनाओं फीड को क्रमिक रूप से खींचने में सक्षम बनाने के लिए एक मार्कर का उपयोग करता है। मार्कर फील्ड एक पहचानकर्ता दर्शाता है जो घटनाओं को प्राप्त करने के लिए एक नए पुनरावृत्ति की शुरुआत का संकेत देता है। API मार्कर फील्ड के आधार पर कतार से घटनाओं को पढ़ता है और प्रतिक्रिया में अगले मार्कर स्थान प्रदान करता है। अगर कोई नई घटनाएं कतार में नहीं हैं, तो मार्कर फील्ड खाली होती है।

एक वैकल्पिक घटनाओं की खपत मॉडल सीधे नो-कोड एकीकरण का उपयोग करता है, देखें AWS S3 के साथ Cato Events का एकीकरण और Azure Storage Account के साथ Cato Events का एकीकरण.

हमने क्या बदला? 

  • पहले, जब मार्कर निर्दिष्ट नहीं होता था, API सबसे पुराना उपलब्ध मार्कर लौटाता था। घटनाओं की सबसे हाल की कतार तक पहुँचने से पहले पूरी घटना कतार को खपत करना आवश्यक था।
  • 27 अप्रैल, 2025 से शुरू, यदि कोई मार्कर निर्दिष्ट नहीं किया गया है, तो API सबसे हाल का मार्कर लौटाता है। यह API को सीधे सबसे हाल की घटनाओं को खींचने की अनुमति देता है।

क्या यह परिवर्तनशील परिवर्तन है? 

  • eventsFeed API के अधिकांश उपयोग मामलों के लिए कोई प्रभाव नहीं है। जब क्वेरी के लिए मार्कर फ़ील्ड का उपयोग किया जाता है, तो कोई परिवर्तन नहीं होता है, और घटनाओं की फ़ीड खपत तर्क समान है।

  • अगर आपके पास हाल की घटनाओं तक पहुँचने के लिए कतार को खपत करने की समर्पित लॉजिक है, तो अब इस लॉजिक की आवश्यकता नहीं है।

    • अब, यदि कोई इनपुट मार्कर निर्दिष्ट नहीं किया गया है, तो API सबसे हाल का मार्कर प्रदान करता है। इस मार्कर के साथ API को कॉल करना सबसे हाल की घटनाओं को प्राप्त करता है।
    • API प्रतिक्रिया एक मार्कर होती है जो सबसे हाल के (कतार के शीर्ष) स्थान की ओर इशारा करती है।
    • संबंधित स्क्रिप्ट और स्वत: प्रक्रियाओं को अपडेट किया जाना चाहिए

2025-02-09 - परिवर्तन XDR एपीआई के लिए, limit=0 अब समर्थित नहीं है

हमने limit फील्ड की कार्यक्षमता को बदल दिया है ताकि limit=0 अब समर्थित न हो क्योंकि इसे एक अच्छी प्रथा नहीं माना जाता है। सुरक्षित और समर्पित संचालन सुनिश्चित करने के लिए, आपको इस पैरामीटर पर निर्भर स्क्रिप्ट्स या क्वेरियों को अपडेट करना होगा। इसके बजाय, आप 1-2000 के बीच एक सीमा सेट कर सकते हैं, जिसे API पूरी तरह से समर्थित करता है।

अगर आपको सभी कहानियों को प्राप्त करने की आवश्यकता है, तो हम पृष्ठांकन दृष्टिकोण का उपयोग करने की अनुशंसा करते हैं।

आगामी जीवन के अंत की घोषणाएं

 

पूर्व अंत-जीवन घोषणाएं

2026-03-18 - सेकंडरीसॉकेटसीरियल फ़ील्ड के लिए ईओएल

EventFieldName एपीआई में secondary_socket_serial घटना फ़ील्ड वर्तमान में अप्रचलित के रूप में चिह्नित है और 18 मार्च, 2026 को समाप्ति के जीवन तक पहुँच गई।

अनुशंसित वैकल्पिक फ़ील्ड: socket_serial

2025-06-30 - प्रकार LastMileBwInput, InterfaceInfo और SocketInterfaceBandwidthInput के लिए ईओएल

LastMileBWInput एपीआई में निम्नलिखित फ़ील्ड्स और प्रकार वर्तमान में अप्रचलित के रूप में चिह्नित हैं और 30 जून, 2025 को समाप्ति के जीवन तक पहुँच गए।

इसके बजाय अनुशंसित फ़ील्ड और प्रकार का उपयोग करें।

विरासत प्रकार अनुशंसित प्रकार
डाउनस्ट्रीम डाउनस्ट्रीमMbpsPrecision
अपस्ट्रीम अपस्ट्रीमMbpsPrecision

InterfaceInfo एपीआई में निम्नलिखित फ़ील्ड्स और प्रकार वर्तमान में अप्रचलित के रूप में चिह्नित हैं और 30 जून, 2025 को समाप्ति के जीवन तक पहुँच गए।

इसके बजाय अनुशंसित फ़ील्ड और प्रकार का उपयोग करें।

विरासत प्रकार अनुशंसित प्रकार
डाउनस्ट्रीमBandwidth डाउनस्ट्रीमBandwidthMbpsPrecision
अपस्ट्रीमBandwidth अपस्ट्रीमBandwidthMbpsPrecision

SocketInterfaceBandwidthInput एपीआई में निम्नलिखित फ़ील्ड्स और प्रकार वर्तमान में अप्रचलित के रूप में चिह्नित हैं और 30 जून, 2025 को समाप्ति के जीवन तक पहुँच गए।

इसके बजाय अनुशंसित फ़ील्ड और प्रकार का उपयोग करें।

विरासत प्रकार अनुशंसित प्रकार
डाउनस्ट्रीमBandwidth डाउनस्ट्रीमBandwidthMbpsPrecision
अपस्ट्रीमBandwidth अपस्ट्रीमBandwidthMbpsPrecision

2025-06-08 - EventFieldName फ़ील्ड के लिए फील्डनेमइनपुट में ईओएल

  • AuditFieldFilterInput प्रकार का उपयोग करके auditFeed क्वेरी API एक सूची स्वीकार करता है। प्रत्येक फ़िल्टर में प्रकार FieldNameInput द्वारा परिभाषित fieldName शामिल होता है, जिसमें वर्तमान में दो इनपुट फ़ील्ड शामिल हैं: AuditFieldName और EventFieldName।
  • हालांकि, केवल AuditFieldName मान्य और समर्थित इनपुट फ़ील्ड है। स्कीमा स्पष्टता बढ़ाने और भ्रम से बचने के लिए, EventFieldName फ़ील्ड को 8 जून, 2025 को स्कीमा से हटा दिया गया।
  • सभी स्क्रिप्ट्स और क्वेरियों को अपडेट करें जो auditFeed फ़िल्टर का उपयोग करते हैं ताकि केवल AuditFieldName इनपुट फील्ड का उपयोग किया जाए।

2025-05-01 - ईओएल EventFieldName प्रकारों के लिए

EventFieldName एपीआई में निम्नलिखित फ़ील्ड्स और प्रकार वर्तमान में अप्रचलित के रूप में चिह्नित हैं और 1 मई, 2025 को समाप्ति के जीवन तक पहुँच गए।

इसके बजाय अनुशंसित फ़ील्ड और प्रकार का उपयोग करें।

विरासत प्रकार अनुशंसित प्रकार
अनुप्रयोग application_id/application_name
कस्टम श्रेणियाँ custom_category_id/custom_category_name
कस्टम श्रेणी custom_category_id/custom_category_name
गंतव्य_साइट dest_site_id/dest_site_name
उपकरण स्थिति प्रोफाइल उपकरण स्थिति प्रोफ़ाइल
internalId इवेंट_आईडी
नियम নিয়ম_নেরাম
src_site src_site_id/src_site_name

2025-04-15 - bgp_peer_description के लिए ईओएल

EventFieldName API में bgp_peer_description फ़ील्ड को हटाया गया और April 15, 2025 को अंत-जीवन (EoL) चिह्नित किया गया।

2025-03-01 - EventFieldName प्रकारों के लिए ईओएल

EventFieldName API में निम्नलिखित फ़ील्ड और प्रकार अप्रचलित के रूप में चिह्नित किए गए थे और 1 मार्च, 2025 से जीवन के अंत (EoL) हैं।

कृपया अनुशंसित क्षेत्रों और प्रकारों का उपयोग करें।

असमर्थित प्रकार अनुशंसित प्रकार
parent_pid src_process_parent_pid
pid src_pid
process_path src_process_path

2025-02-23 - StoryDrillDownFilter मान फ़ील्ड के लिए ईओएल

StoryDrillDownFilter बीटा API में निम्नलिखित फ़ील्ड अप्रचलित के रूप में चिह्नित किया गया था और 23 फरवरी, 2025 से जीवन के अंत (EoL) है।

कृपया इसके बजाय अनुशंसित फ़ील्ड्स और प्रकारों का उपयोग करें।

अप्रचलित प्रकार अनुशंसित प्रकार
मान कोई डिवाइस विशेषताएँ चयनित नहीं

2025-02-11 - Cato घटना डेटा के कुछ सबटाइप्स के लिए ईओएल

Cato क्लाइंट्स से संबंधित कार्यक्रम उपभोग API में प्रयुक्त कुछ उपप्रकार मानों के EoL की घोषणा के बाद, आयरलैंड CMA स्थान (cc.catonetworks.com) का उपयोग करने वाले खातों के लिए रोलआउट निम्नलिखित फ़ील्ड्स पर रोक दिया जाता है:

अप्रचलित प्रकार अनुशंसित प्रकार
पुन: जुड़ गया कनेक्टेड या डिस्कनेक्टेड
PoP बदला

कनेक्टेड या डिस्कनेक्टेड

(PoP नाम को lastPopName फ़ील्ड में लौटाया जाता है।)

2025-01-02 - घटना सबटाइप्स के लिए ईओएल

Cato क्लाइंट से संबंधित निम्न क्षेत्रों और प्रकारों को अप्रचलित के रूप में चिह्नित किया गया है और 2 जनवरी, 2025 से लाइफ के अंत (EoL) के रूप में चिह्नित किया गया है।

कृपया इसके बजाय अनुशंसित फ़ील्ड्स और प्रकारों का उपयोग करें।

अप्रचलित प्रकार अनुशंसित प्रकार नोट्स
VPN कभी बंद-नहीं-बाईपास हमेशा चालू बाईपास VPN कभी बंद-नहीं-बाईपास सबटाइप मूल्य को हमेशा चालू बाईपास मूल्य में बदला जा रहा है।
पुन: जुड़ गया जुड़ा हुआ या डिस्कनेक्ट किया गया विस्तृतता को बढ़ाने के लिए, पुन: जुड़ गया सबटाइप मान को 2 नए मानों, कनेक्टेड और डिस्कनेक्टेड में विभाजित किया जा रहा है।
PoP बदला

कनेक्टेड या डिस्कनेक्टेड

(PoP नाम को lastPopName फ़ील्ड में लौटाया जाता है)

 विस्तृतता को बढ़ाने के लिए, बदला गया PoP सबटाइप मान को 2 नए मानों, कनेक्टेड और डिस्कनेक्टेड में विभाजित किया जा रहा है।

क्या यह लेख उपयोगी था?

1 में से 0 के लिए उपयोगी रहा

0 टिप्पणियां