এই প্রবন্ধটি ক্যাটো GraphQL API স্কিমার জন্য সম্ভাব্য ভঙ্গকারী পরিবর্তন এবং জীবন শেষ (EoL) ঘোষণাগুলির বিজ্ঞপ্তি প্ল্যাটফর্ম এবং API ক্লায়েন্ট আপডেটের প্রয়োজন হতে পারে এমন তথ্য ধারণ করে।
এই প্রবন্ধে ব্যবহৃত API শর্তাবলী Cato API কি এ ব্যাখ্যা করা হয়েছে।
ক্যাটো API ব্যবহারকারী যেকোনো গ্রাহকের জন্য, আমরা সুপারিশ করছি যে আপনি এই প্রবন্ধে API এর পরিবর্তনের আপডেটগুলির জন্য স্বয়ংক্রিয়ভাবে ইমেইল বিজ্ঞপ্তিগুলি পাওয়ার জন্য অনুসরণ করুন ক্লিক করুন। আপনি নতুন এবং আপডেট API সম্পর্কিত আরও তথ্য দেখতে পারেন Cato API Changelog এ।
এপিআই সম্পর্কে আরও তথ্যের জন্য, দেখুন Cato Networks GraphQL API Reference.
সম্ভাব্য বিশ্লেষণকারী পরিবর্তনসমূহ
২০২৬-০৮-৩০ - কঠিন স্কিমা ধরন যাচাইকরণ
২০২৬ সালের ৩০শে আগস্ট থেকে, আমরা কঠোরভাবে এপিআই জুড়ে ধরন যাচাইকরণ প্রয়োগ করছি ডকুমেন্টেড স্কিমার সাথে সামঞ্জস্য করতে। API কল যা এমন একটি ফরম্যাটে মান পাস করে যা ক্ষেত্রের প্রামাণিত ধরনের সাথে মেলে না, প্রভাবিত হতে পারে, এন্ডপয়েন্টের উপর নির্ভর করে।
কি পরিবর্তিত হচ্ছে: প্যারামিটারগুলি অবশ্যই তাদের স্কিমা-সংজ্ঞায়িত ধরনের সাথে পুরোপুরি মিলে যেতে হবে। উদাহরণস্বরূপ,
Intক্ষেত্রসমূহ শুধুমাত্র পূর্ণসংখ্যা মান গ্রহণ করবে — স্ট্রিং ইনপুট যেমন"5"আর গ্রহণযোগ্য হবে না। এটি শুধুমাত্র Int ক্ষেত্রের মধ্যে সীমাবদ্ধ নয় — যে কোনও প্যারামিটার যা এমন একটি ফরম্যাটে পাস হয় যা তার প্রামাণিত ধরনের সাথে মেলে না প্রভাবিত হতে পারে।আপনাকে 30 আগস্ট, 2026 এর আগে যা করতে হবে:
আপনার API কলগুলি পর্যালোচনা করুন যা এমন একটি ফরম্যাটে মান পাস করে যা প্রামাণিত স্কিমা ধরনের সাথে মেলে না (যেমন, স্ট্রিং হিসাবে পাস করা সংখ্যামূলক মান)।
যেকোনো অসামঞ্জস্যপূর্ণ কলগুলির আপডেট করুন।
2026-06-21 - API আইডি ক্ষেত্রসমূহ: দীর্ঘ/ইন্টিজার থেকে স্ট্রিং-তে ধরন পরিবর্তন
বর্তমানে, Cato এর API গেটওয়ে হয় স্ট্রিং অথবা দীর্ঘ (ইন্টিজার) হিসেবে আইডি ক্ষেত্রসমূহ ফেরত দেয়। একটি আসন্ন পরিকাঠামো আপডেটের অংশ হিসেবে, সব আইডি ক্ষেত্রসমূহ নিয়মিতভাবে স্ট্রিং হিসেবে ফেরত দেওয়া হবে।
কি পরিবর্তন হচ্ছে: API প্রতিক্রিয়াগুলি যেগুলি আগে আইডি ক্ষেত্রসমূহকে সংখ্যাগত দীর্ঘ মান হিসেবে (উদাহরণস্বরূপ,
1000000002) ফেরত দিতো, এখন সবসময় স্ট্রিং হিসেবে (উদাহরণস্বরূপ,"1000000002") ফেরত দেবে।কে প্রভাবিত হচ্ছে: API ক্লায়েন্ট যারা আইডি ক্ষেত্রসমূহকে শুধুমাত্র দীর্ঘ/ইন্টিজার ধরনের হিসেবে পরিচালনা করে, এই পরিবর্তন চালু হলে তারা ভেঙে যেতে পারে।
আপনি কি করবেন 21 জুন, 2026 এর আগে: আপনি আপনার API ক্লায়েন্ট কোড আপডেট করুন যাতে আইডি ক্ষেত্রসমূহের জন্য দীর্ঘ এবং স্ট্রিং উভয় ধরনের গ্রহণ করতে পারে। এটি একটি সাবলীল অতিক্রম নিশ্চিত করবে এবং পরিবর্তন কার্যকর হলে ব্যাঘাত প্রতিরোধ করবে।
2025-08-10 - পরিবর্তন ইমেইল ক্ষেত্রতে addAdmin এবং updateAdmin API-এ
10 অগাস্ট, 2025-এ, ইমেইল ক্ষেত্র addAdmin এবং updateAdmin API-এ অপশনাল (nullable) হয়ে গেল। এই পরিবর্তনটি স্ক্রিপ্ট এবং সার্ভিস প্রিন্সিপাল ব্যবহার করে অটোমেশন অন্তর্ভুক্ত করে বিশদ API অ্যাক্সেস নিয়ন্ত্রণের সমর্থন করে আসন্ন অবকাঠামোকে সমর্থন করে।
বর্তমান এবং ভবিষ্যতের মানব CMA অ্যাডমিনদের সবসময় একটি
ইমেইলমান অন্তর্ভুক্ত করতে হবেযেসব প্রশ্ন শুধু মানব অ্যাডমিনদের ফেরত দেয় সেগুলো অপ্রভাবিত।
কিছু ক্লায়েন্টকে প্রতিক্রিয়া পে-লোডে শূন্য মানগুলি পরিচালনা করতে হতে পারে, যেমন addAdminPayload
এটি সাধারণত একটি ভঙ্গকারী পরিবর্তন নয়, কিন্তু এটি ক্লায়েন্টদের প্রভাবিত করতে পারে যারা ধরে নেয় ইমেইল সবসময় উপস্থিত। সমস্যা এড়াতে আপনার একীকরণ পর্যালোচনা করুন।
2025-04-27 - eventsFeed অনুসন্ধান API সবচেয়ে সাম্প্রতিক ইভেন্টগুলি টানার জন্য সমর্থন করে
eventsFeed API একটি মার্কার ব্যবহার করে ইভেন্ট ফিড পুনরাবৃত্তিভাবে টেনে আনতে সক্ষম করে। মার্কার ফিল্ড একটি পরিচয়কারী দেখায় যা নতুন আনতরণের শুরু নির্দেশ করে। API মার্কার ফিল্ডের উপর ভিত্তি করে সারিতে পরিসংখ্যান পড়ে এবং পরবর্তী মার্কার লোকেশন রিপোর্টে প্রদান করে। যদি সারিতে কোন নতুন পরিসংখ্যান না থাকে, তাহলে মার্কার ফিল্ড খালি থাকে
একটি বিকল্প ইভেন্ট গ্রহণের মডেল হল সরাসরি কোন-কোড ইন্টিগ্রেশন ব্যবহার করা। দেখুন Integrating Cato Events with AWS S3 এবং Integrating Cato Events with Azure Storage Account।
আমরা কি পরিবর্তন করেছি?
আগে, যখন মার্কার নির্দিষ্ট করা হয়নি, API প্রাচীনতম উপলব্ধ মার্কার ফেরত দেয়। এটি সর্বশেষ ইভেন্টে পৌঁছানোর আগে সম্পূর্ণ ইভেন্ট কিউটি গ্রহণ করা প্রয়োজনীয় করত।
২৭ এপ্রিল, ২০২৫ থেকে শুরু করে, যদি কোনো মার্কার নির্দিষ্ট না করা হয়, API সর্বশেষ মার্কার ফেরত দেয়। এটি API-কে সরাসরি সর্বাধিক সাম্প্রতিক ইভেন্ট টানতে সক্ষম করে।
এটি কি একটি ভঙ্গকারী পরিবর্তন?
eventsFeed API এর বেশিরভাগ ব্যবহারের ক্ষেত্রে কোনো প্রভাব নেই। যখন মার্কার ক্ষেত্রটি একটি প্রশ্নের জন্য ব্যবহৃত হয়, তখন কোনো পরিবর্তন নেই, এবং ইভেন্ট ফিড গ্রহণের যুক্তি একই।
যদি আপনি সাম্প্রতিক পরিসংখ্যানতে পৌঁছানোর জন্য পরিসংখ্যান সারি ব্যবহার করার জন্য নির্ধারিত লজিক থাকেন, তবে এই লজিক আর প্রয়োজনীয় নয়।
এখন, যদি কোনো ইনপুট মার্কার নির্দিষ্ট না থাকে, API সর্বশেষ মার্কার প্রদান করে। এই মার্কারের সাথে API কল করলে সর্বাধিক সাম্প্রতিক ইভেন্টগুলি ফেচ করে।
API প্রতিক্রিয়ায় একটি মার্কার অন্তর্ভুক্ত রয়েছে যা সর্বশেষ (কিউএর শীর্ষ) স্থানের প্রতি নির্দেশ করে
সংশ্লিষ্ট স্ক্রিপ্ট এবং স্বয়ংক্রিয় প্রক্রিয়াগুলি আপডেট করা উচিত
2025-02-09 - XDR API-এর জন্য পরিবর্তন, সীমা=0 আর সমর্থিত নয়
আমরা limit ফিল্ডের কার্যক্ষমতার পরিবর্তন করেছি, যাতে limit=0 আর সমর্থিত নয় কারণ এটি একটি সঠিক অভ্যাস হিসাবে বিবেচিত হয় না। নিয়মিত মসৃণ অপারেশন নিশ্চিত করতে, আপনাকে এই প্যারামিটারের উপর নির্ভর করে স্ক্রিপ্ট বা প্রশ্নাবলী আপডেট করতে হবে। বরং, আপনি একটি সীমা ১-২০০০ এর মধ্যে সেট করতে পারেন, যা API পুরোপুরি সমর্থিত।
যদি আপনাকে সমস্ত কাহিনী পুনরুদ্ধার করতে হয়, তাহলে আমরা প্যাগিনেশন পদ্ধতি ব্যবহার করার সুপারিশ করছি।
আসন্ন শেষ-অব-লাইফ ঘোষণা
আগের জীবনের শেষের ঘোষণাগুলি
2026-03-18 - SecondarySocketSerial ক্ষেত্রের জন্য EoL
secondary_socket_serial ইভেন্ট ক্ষেত্রটি EventFieldName API-তে বর্তমানে শিশুগ্রহণ পেয়েছে এবং 18 মার্চ, 2026-এ শেষ হয়ে গেছে।
প্রস্তাবিত বিকল্প ক্ষেত্র: socket_serial
2025-06-30 - LastMileBwInput, InterfaceInfo, এবং SocketInterfaceBandwidthInput ধরনসমূহের জন্য EoL
ক্ষেত্রসমূহ এবং ধরনসমূহ LastMileBWInput API-তে বর্তমানে শিশুগ্রহণ পেয়েছে এবং 30 জুন, 2025-এ শেষ হয়ে গেছে।
দয়া করে পরিবর্তে সুপারিশকৃত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
Deprecated Type | প্রস্তাবিত প্রকার |
|---|---|
ডাউনস্ট্রীম | downstreamMbpsPrecision |
আপস্ট্রিম | upstreamMbpsPrecision |
ক্ষেত্রসমূহ এবং ধরনসমূহ InterfaceInfo API-তে বর্তমানে শিশুগ্রহণ পেয়েছে এবং 30 জুন, 2025-এ শেষ হয়ে গেছে।
দয়া করে পরিবর্তে সুপারিশকৃত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
Deprecated Type | প্রস্তাবিত প্রকার |
|---|---|
downstreamBandwidth | downstreamBandwidthMbpsPrecision |
upstreamBandwidth | upstreamBandwidthMbpsPrecision |
ক্ষেত্রসমূহ এবং ধরনসমূহ SocketInterfaceBandwidthInput API-তে বর্তমানে শিশুগ্রহণ পেয়েছে এবং 30 জুন, 2025-এ শেষ হয়ে গেছে।
দয়া করে পরিবর্তে সুপারিশকৃত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
Deprecated Type | প্রস্তাবিত প্রকার |
|---|---|
downstreamBandwidth | downstreamBandwidthMbpsPrecision |
upstreamBandwidth | upstreamBandwidthMbpsPrecision |
2025-06-08 - EoL EventFieldName ক্ষেত্রের জন্য FieldNameInput-এ
auditFeed কোয়েরি API তালিকার ফিল্টারগুলি গ্রহণ করেAuditFieldFilterInputটাইপ ব্যবহার করে। প্রতিটি ফিল্টার একটিfieldNameঅন্তর্ভুক্ত করে যা টাইপFieldNameInputদ্বারা নির্ধারিত হয়, যা বর্তমানে দুটি ইনপুট ক্ষেত্র অন্তর্ভুক্ত করে:AuditFieldNameএবংEventFieldName।তবে, কেবলমাত্র
AuditFieldNameএকটি বৈধ এবং সমর্থিত ইনপুট ফিল্ড। স্কিমার স্পষ্টতা উন্নতির জন্য এবং বিভ্রান্তি এড়ানোর জন্য,EventFieldNameক্ষেত্রটি স্কিমা থেকে 8 জুন, 2025 এ সরানো হয়েছে।সব স্ক্রিপ্ট এবং প্রশ্নাবলী আপডেট করুন যেগুলি
auditFeedফিল্টার ব্যবহার করে কেবলমাত্রAuditFieldNameইনপুট ফিল্ড ব্যবহার করার জন্য।
2025-05-01 - EventFieldName ধরনসমূহের জন্য EoL
ক্ষেত্রসমূহ এবং ধরনসমূহ EventFieldName API-তে বর্তমানে শিশুগ্রহণ পেয়েছে এবং 1 মে, 2025-এ শেষ হয়ে গেছে।
দয়া করে পরিবর্তে সুপারিশকৃত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
Deprecated Type | প্রস্তাবিত প্রকার |
|---|---|
অ্যাপ্লিকেশন | application_id/application_name |
custom_categories | custom_category_id/custom_category_name |
custom_category | custom_category_id/custom_category_name |
dest_site | dest_site_id/dest_site_name |
device_posture_profiles | device_posture_profile |
internalId | event_id |
rule | rule_name |
src_site | src_site_id/src_site_name |
2025-04-15 - bgp_peer_description এর জন্য EoL
EventFieldName API -এর bgp_peer_description ক্ষেত্রটি Deprecated হিসেবে চিহ্নিত করা হয়েছে এবং এপ্রিল 15, 2025 সাল থেকে এর জীবন শেষ হয়েছে (EoL)।
2025-03-01 - EventFieldName ধরনসমূহের জন্য EoL
EventFieldName API তে নিম্নলিখিত ক্ষেত্র ও ধরন ডেপ্রিকেটেড হিসাবে চিহ্নিত এবং ১ মার্চ, ২০২৫ তারিখ থেকে শেষ-অব-লাইফ (EoL)।
দয়া করে পরিবর্তে সুপারিশকৃত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
Deprecated Type | প্রস্তাবিত প্রকার |
|---|---|
parent_pid | src_process_parent_pid |
pid | src_pid |
process_path | src_process_path |
2025-02-23 - StoryDrillDownFilter মান ক্ষেত্রের জন্য EoL
StoryDrillDownFilter বেটা API তে নিম্নলিখিত ক্ষেত্র ডেপ্রিকেটেড হিসাবে চিহ্নিত এবং ২৩ ফেব্রুয়ারি, ২০২৫ থেকে শেষ-অব-লাইফ (EoL)।
দয়া করে পরিবর্তে সুপারিশকৃত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
Deprecated Type | প্রস্তাবিত প্রকার |
|---|---|
মান | মানসমূহ |
2025-02-11 - কিছু Cato ইভেন্ট ডেটা সাবটাইপের জন্য EoL
ক্যাটো ক্লায়েন্টের সাথে সম্পর্কিত ইভেন্ট কনজাম্পশন এপিআই-তে ব্যবহার করা কিছু সাবটাইপ মানগুলির ইওএল ঘোষণা অনুসরণ করে, আয়ারল্যান্ড সিএমএ অবস্থান (cc.catonetworks.com) ব্যবহারকারী অ্যাকাউন্টগুলির জন্য রোলআউটটি নিম্নলিখিত ক্ষেত্রগুলির জন্য স্থগিত করা হয়েছে:
Deprecated Type | প্রস্তাবিত প্রকার |
|---|---|
পুনঃসংযুক্ত | সংযুক্ত বা সংযোগ বিচ্ছিন্ন |
PoP পরিবর্তিত | সংযুক্ত বা সংযোগ বিচ্ছিন্ন (PoP নামটি lastPopName ক্ষেত্রে ফেরত দেওয়া হয়।) |
অধিক তথ্যের জন্য, দেখুন CMA - টেকনিক্যাল গাইডলাইনস
2025-01-02 - ইভেন্ট সাবটাইপের জন্য EoL
কাটো ক্লায়েন্টের সাথে সম্পর্কিত নিম্নলিখিত ক্ষেত্র এবং প্রকার অবনমিত হিসাবে চিহ্নিত করা হয়েছে এবং জানুয়ারি ২, ২০২৫ তারিখে জীবনসমাপ্তি হয়েছে।
দয়া করে পরিবর্তে সুপারিশকৃত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
Deprecated Type | প্রস্তাবিত প্রকার | নোট |
|---|---|---|
VPN Never-Off-Bypass | সর্বদা-চালু বাইপাস | VPN Never-Off-Bypass উপপ্রকার মানটি সর্বদা-চালু বাইপাস মান দ্বারা প্রতিস্থাপিত হচ্ছে। |
পুনঃসংযুক্ত | সংযুক্ত বা সংযোগ বিচ্ছিন্ন | গ্র্যানুলারিটি বাড়ানোর জন্য, পুনঃসংযুক্ত উপপ্রকার মানটি দুটি নতুন মানে বিভক্ত হচ্ছে: সংযুক্ত এবং সংযোগ বিচ্ছিন্ন। |
PoP পরিবর্তিত | সংযুক্ত বা সংযোগ বিচ্ছিন্ন (PoP নামটি lastPopName ক্ষেত্রে ফেরত দেওয়া হয়।) | গ্র্যানুলারিটি বাড়ানোর জন্য, পরিবর্তিত PoP উপপ্রকার মানটি দুটি নতুন মানে বিভক্ত হচ্ছে: সংযুক্ত এবং সংযোগ বিচ্ছিন্ন। |
আরও তথ্যের জন্য, এই নিবন্ধটি দেখুন: ক্যাটো ইভেন্ট ডেটার কিছু উপধরনের জন্য আসন্ন মেয়াদোত্তীর্ণ