এই প্রবন্ধটি ক্যাটো GraphQL API স্কিমার জন্য সম্ভাব্য ভঙ্গকারী পরিবর্তন এবং জীবন শেষ (EoL) ঘোষণাগুলির বিজ্ঞপ্তি প্ল্যাটফর্ম এবং API ক্লায়েন্ট আপডেটের প্রয়োজন হতে পারে এমন তথ্য ধারণ করে।
এই প্রবন্ধে ব্যবহৃত API শর্তাবলী Cato API কি এ ব্যাখ্যা করা হয়েছে।
ক্যাটো API ব্যবহারকারী কোন গ্রাহকের জন্য, আমরা সুপারিশ করছি যে আপনি এই প্রবন্ধে API এর ভঙ্গকারী পরিবর্তনের আপডেটগুলির জন্য স্বয়ংক্রিয়ভাবে ইমেইল বিজ্ঞপ্তি পাওয়ার জন্য অনুসরণ করুন ক্লিক করুন। আপনি নতুন এবং আপডেট API সম্পর্কিত আরও তথ্য দেখতে পারেন Cato API Changelog এ।
API সম্পর্কে আরও তথ্যের জন্য, Cato Networks GraphQL API Reference দেখুন।
বর্তমানে, Cato এর API গেটওয়ে হয় স্ট্রিং অথবা দীর্ঘ (ইন্টিজার) হিসেবে আইডি ক্ষেত্রসমূহ ফেরত দেয়। একটি আসন্ন পরিকাঠামো আপডেটের অংশ হিসেবে, সব আইডি ক্ষেত্রসমূহ নিয়মিতভাবে স্ট্রিং হিসেবে ফেরত দেওয়া হবে।
-
কি পরিবর্তন হচ্ছে: API প্রতিক্রিয়াগুলি যেগুলি আগে আইডি ক্ষেত্রসমূহকে সংখ্যাগত দীর্ঘ মান হিসেবে (উদাহরণস্বরূপ,
1000000002) ফেরত দিতো, এখন সবসময় স্ট্রিং হিসেবে (উদাহরণস্বরূপ,"1000000002") ফেরত দেবে। - কে প্রভাবিত হচ্ছে: API ক্লায়েন্ট যারা আইডি ক্ষেত্রসমূহকে শুধুমাত্র দীর্ঘ/ইন্টিজার ধরনের হিসেবে পরিচালনা করে। এই পরিবর্তন চালু হলে তারা ভেঙে যেতে পারে।
- আপনি কি করবেন 21 জুন, 2026 এর আগে: আপনি আপনার API ক্লায়েন্ট কোড আপডেট করুন যাতে আইডি ক্ষেত্রসমূহের জন্য দীর্ঘ এবং স্ট্রিং উভয় ধরনের গ্রহণ করতে পারে। এটি একটি সাবলীল অতিক্রম নিশ্চিত করবে এবং পরিবর্তন কার্যকর হলে ব্যাঘাত প্রতিরোধ করবে।
10 অগাস্ট, 2025-এ, ইমেইল ক্ষেত্র addAdmin এবং updateAdmin API-এ অপশনাল (nullable) হয়ে গেল। এই পরিবর্তনটি স্ক্রিপ্ট এবং সার্ভিস প্রিন্সিপাল ব্যবহার করে অটোমেশন অন্তর্ভুক্ত করে বিশদ API অ্যাক্সেস নিয়ন্ত্রণের সমর্থন করে আসন্ন অবকাঠামোকে সমর্থন করে।
- বর্তমান এবং ভবিষ্যতের মানব CMA অ্যাডমিনদের সবসময় একটি
ইমেইলমান অন্তর্ভুক্ত করতে হবে - যেসব প্রশ্ন শুধু মানব অ্যাডমিনদের ফেরত দেয় সেগুলো অপ্রভাবিত।
- কিছু ক্লায়েন্টকে প্রতিক্রিয়া পে-লোডে শূন্য মানগুলি পরিচালনা করতে হতে পারে, যেমন addAdminPayload
এটি সাধারণত একটি ভঙ্গকারী পরিবর্তন নয়, কিন্তু এটি ক্লায়েন্টদের প্রভাবিত করতে পারে যারা ধরে নেয় ইমেইল সবসময় উপস্থিত। সমস্যা এড়াতে আপনার একীকরণ পর্যালোচনা করুন।
eventsFeed API একটি মার্কার ব্যবহার করে ইভেন্ট ফিড পুনরাবৃত্তিভাবে টেনে আনতে সক্ষম করে। মার্কার ফিল্ড একটি পরিচয়কারী দেখায় যা নতুন আনতরণের শুরু নির্দেশ করে। API মার্কার ফিল্ডের উপর ভিত্তি করে সারিতে পরিসংখ্যান পড়ে এবং পরবর্তী মার্কার লোকেশন রিপোর্টে প্রদান করে। যদি সারিতে কোন নতুন পরিসংখ্যান না থাকে, তাহলে মার্কার ফিল্ড খালি থাকে
একটি বিকল্প ইভেন্ট গ্রহণের মডেল হল সরাসরি কোন-কোড ইন্টিগ্রেশন ব্যবহার করা। দেখুন Integrating Cato Events with AWS S3 এবং Integrating Cato Events with Azure Storage Account।
আমরা কি পরিবর্তন করেছি?
- আগে, যখন মার্কার নির্দিষ্ট করা হয়নি, API প্রাচীনতম উপলব্ধ মার্কার ফেরত দেয়। এটি সর্বশেষ ইভেন্টে পৌঁছানোর আগে সম্পূর্ণ ইভেন্ট কিউটি গ্রহণ করা প্রয়োজনীয় করত।
- ২৭ এপ্রিল, ২০২৫ থেকে শুরু করে, যদি কোনো মার্কার নির্দিষ্ট না করা হয়, API সর্বশেষ মার্কার ফেরত দেয়। এটি API-কে সরাসরি সর্বাধিক সাম্প্রতিক ইভেন্ট টানতে সক্ষম করে।
এটি কি একটি ভঙ্গকারী পরিবর্তন?
- eventsFeed API এর বেশিরভাগ ব্যবহারের ক্ষেত্রে কোনো প্রভাব নেই। যখন মার্কার ক্ষেত্রটি একটি প্রশ্নের জন্য ব্যবহৃত হয়, তখন কোনো পরিবর্তন নেই, এবং ইভেন্ট ফিড গ্রহণের যুক্তি একই।
-
যদি আপনি সাম্প্রতিক পরিসংখ্যানতে পৌঁছানোর জন্য পরিসংখ্যান সারি ব্যবহার করার জন্য নির্ধারিত লজিক থাকেন, তবে এই লজিক আর প্রয়োজনীয় নয়।
- এখন, যদি কোনো ইনপুট মার্কার নির্দিষ্ট না থাকে, API সর্বশেষ মার্কার প্রদান করে। এই মার্কারের সাথে API কল করলে সর্বাধিক সাম্প্রতিক ইভেন্টগুলি ফেচ করে।
- API প্রতিক্রিয়ায় একটি মার্কার অন্তর্ভুক্ত রয়েছে যা সর্বশেষ (কিউএর শীর্ষ) স্থানের প্রতি নির্দেশ করে
- সংশ্লিষ্ট স্ক্রিপ্ট এবং স্বয়ংক্রিয় প্রক্রিয়াগুলি আপডেট করা উচিত
আমরা limit ফিল্ডের কার্যক্ষমতার পরিবর্তন করেছি, যাতে limit=0 আর সমর্থিত নয় কারণ এটি একটি সঠিক অভ্যাস হিসাবে বিবেচিত হয় না। নিয়মিত মসৃণ অপারেশন নিশ্চিত করতে, আপনাকে এই প্যারামিটারের উপর নির্ভর করে স্ক্রিপ্ট বা প্রশ্নাবলী আপডেট করতে হবে। বরং, আপনি একটি সীমা ১-২০০০ এর মধ্যে সেট করতে পারেন, যা API পুরোপুরি সমর্থিত।
যদি আপনাকে সমস্ত কাহিনী পুনরুদ্ধার করতে হয়, তাহলে আমরা প্যাগিনেশন পদ্ধতি ব্যবহার করার সুপারিশ করছি।
ক্ষেত্রসমূহ এবং ধরনসমূহ LastMileBWInput API-তে বর্তমানে শিশুগ্রহণ পেয়েছে এবং 30 জুন, 2025-এ শেষ হয়ে গেছে।
বরং, প্রস্তাবিত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
| অবনমিত টাইপ | প্রস্তাবিত টাইপ |
|---|---|
| ডাউনস্ট্রিম | downstreamMbpsPrecision |
| upstream | upstreamMbpsPrecision |
ক্ষেত্রসমূহ এবং ধরনসমূহ InterfaceInfo API-তে বর্তমানে শিশুগ্রহণ পেয়েছে এবং 30 জুন, 2025-এ শেষ হয়ে গেছে।
বরং, প্রস্তাবিত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
| অবনমিত টাইপ | প্রস্তাবিত টাইপ |
|---|---|
| downstreamBandwidth | downstreamBandwidthMbpsPrecision |
| upstreamBandwidth | upstreamBandwidthMbpsPrecision |
ক্ষেত্রসমূহ এবং ধরনসমূহ SocketInterfaceBandwidthInput API-তে বর্তমানে শিশুগ্রহণ পেয়েছে এবং 30 জুন, 2025-এ শেষ হয়ে গেছে।
বরং, প্রস্তাবিত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
| অবনমিত টাইপ | প্রস্তাবিত টাইপ |
|---|---|
| downstreamBandwidth | downstreamBandwidthMbpsPrecision |
| upstreamBandwidth | upstreamBandwidthMbpsPrecision |
-
auditFeedকোয়েরি API তালিকার ফিল্টারগুলি গ্রহণ করেAuditFieldFilterInputটাইপ ব্যবহার করে। প্রতিটি ফিল্টার একটিfieldNameঅন্তর্ভুক্ত করে যা টাইপFieldNameInputদ্বারা নির্ধারিত হয়, যা বর্তমানে দুটি ইনপুট ক্ষেত্র অন্তর্ভুক্ত করে:AuditFieldNameএবংEventFieldName। - তবে, কেবলমাত্র
AuditFieldNameএকটি বৈধ এবং সমর্থিত ইনপুট ফিল্ড। স্কিমার স্পষ্টতা উন্নতির জন্য এবং বিভ্রান্তি এড়ানোর জন্য,EventFieldNameক্ষেত্রটি স্কিমা থেকে 8 জুন, 2025 এ সরানো হয়েছে। - সব স্ক্রিপ্ট এবং প্রশ্নাবলী আপডেট করুন যেগুলি
auditFeedফিল্টার ব্যবহার করে কেবলমাত্রAuditFieldNameইনপুট ফিল্ড ব্যবহার করার জন্য।
ক্ষেত্রসমূহ এবং ধরনসমূহ EventFieldName API-তে বর্তমানে শিশুগ্রহণ পেয়েছে এবং 1 মে, 2025-এ শেষ হয়ে গেছে।
বরং, প্রস্তাবিত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
| অবনমিত টাইপ | প্রস্তাবিত টাইপ |
|---|---|
| অ্যাপ্লিকেশন | 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 |
EventFieldName API তে নিম্নলিখিত ক্ষেত্র ও ধরন ডেপ্রিকেটেড হিসাবে চিহ্নিত এবং ১ মার্চ, ২০২৫ তারিখ থেকে শেষ-অব-লাইফ (EoL)।
দয়া করে পরিবর্তে সুপারিশকৃত ক্ষেত্র এবং প্রকারগুলি ব্যবহার করুন।
| Deprecated Type | প্রস্তাবিত প্রকার |
|---|---|
| parent_pid | src_process_parent_pid |
| pid | src_pid |
| process_path | src_process_path |
StoryDrillDownFilter বেটা API তে নিম্নলিখিত ক্ষেত্র ডেপ্রিকেটেড হিসাবে চিহ্নিত এবং ২৩ ফেব্রুয়ারি, ২০২৫ থেকে শেষ-অব-লাইফ (EoL)।
এর পরিবর্তে প্রস্তাবিত ক্ষেত্র এবং প্রকার ব্যবহার করুন।
| অবনমিত প্রকার | প্রস্তাবিত প্রকার |
|---|---|
| মান | মানসমূহ |
ক্যাটো ক্লায়েন্টের সাথে সম্পর্কিত ইভেন্ট কনজাম্পশন এপিআই-তে ব্যবহার করা কিছু সাবটাইপ মানগুলির ইওএল ঘোষণা অনুসরণ করে, আয়ারল্যান্ড সিএমএ অবস্থান (cc.catonetworks.com) ব্যবহারকারী অ্যাকাউন্টগুলির জন্য রোলআউটটি নিম্নলিখিত ক্ষেত্রগুলির জন্য স্থগিত করা হয়েছে:
| অবনমিত প্রকার | প্রস্তাবিত প্রকার |
|---|---|
| পুনঃসংযুক্ত | সংযুক্ত বা সংযোগ বিচ্ছিন্ন |
| পরিবর্তিত PoP |
সংযুক্ত বা সংযোগ বিচ্ছিন্ন (PoP নামটি lastPopName ক্ষেত্রে ফেরত দেওয়া হয়।) |
- অধিক তথ্যের জন্য, দেখুন CMA - টেকনিক্যাল গাইডলাইনস
কাটো ক্লায়েন্টের সাথে সম্পর্কিত নিম্নলিখিত ক্ষেত্র এবং প্রকার অবনমিত হিসাবে চিহ্নিত করা হয়েছে এবং জানুয়ারি ২, ২০২৫ তারিখে জীবনসমাপ্তি হয়েছে।
এর পরিবর্তে প্রস্তাবিত ক্ষেত্র এবং প্রকার ব্যবহার করুন।
| অবনমিত প্রকার | প্রস্তাবিত প্রকার | নোটস |
|---|---|---|
| VPN Never-Off-Bypass | সর্বদা-চালু বাইপাস | VPN Never-Off-Bypass উপপ্রকার মানটি সর্বদা-চালু বাইপাস মান দ্বারা প্রতিস্থাপিত হচ্ছে |
| পুনঃসংযুক্ত | সংযুক্ত বা সংযোগ বিচ্ছিন্ন | গ্র্যানুলারিটি বাড়ানোর জন্য, পুনঃসংযুক্ত উপপ্রকার মানটি দুটি নতুন মানে বিভক্ত হচ্ছে: সংযুক্ত এবং সংযোগ বিচ্ছিন্ন |
| পরিবর্তিত PoP |
সংযুক্ত বা সংযোগ বিচ্ছিন্ন (PoP নামটি lastPopName ক্ষেত্রে ফেরত দেওয়া হয়।) |
গ্র্যানুলারিটি বাড়ানোর জন্য, পরিবর্তিত PoP উপপ্রকার মানটি দুটি নতুন মানে বিভক্ত হচ্ছে: সংযুক্ত এবং সংযোগ বিচ্ছিন্ন |
- আরও তথ্যের জন্য, এই নিবন্ধটি দেখুন: ক্যাটো ইভেন্ট ডেটার কিছু উপধরনের জন্য আসন্ন মেয়াদোত্তীর্ণ
0 মন্তব্য
একটি মন্তব্য করার জন্য সাইন ইন করুন করুন।