আমরা জোর দিয়ে সুপারিশ করছি যে আপনি Cato API ব্যবহার শুরু করার আগে, অনুগ্রহ করে Cato API এর জন্য সহায়তা নীতি পর্যালোচনা করুন।

entityLookup এর সারসংক্ষেপ

entityLookup কোয়েরি Cato ম্যানেজমেন্ট অ্যাপ্লিকেশন এন্টিটিজ যেমন সাইট এবং ভিপিএন ব্যবহারকারীদের সাথে কাজ করে। কোয়েরি আপনাকে একটি এন্টিটির নাম খুঁজে পেতে সাহায্য করতে পারে নির্দিষ্ট আইডি ফেরাতে, এবং অ্যাকাউন্টে এন্টিটিজের তালিকা স্বয়ংক্রিয়ভাবে বের করতে পারে। প্রত্যেক এন্টিটি অতিরিক্ত প্রাসঙ্গিক তথ্য সহ ফেরত দেয়া হয়, যেমন সৃষ্টি তারিখ এবং বিবরণ।

রিসেলার অ্যাকাউন্টের জন্য, আপনি যে গ্রাহক অ্যাকাউন্টের সাথে Cato API সংযুক্ত করছেন তার প্রতিটি অ্যাকাউন্টের ভিতরে পৃথক এপিআই কী তৈরি করতে পারেন। রেট লিমিটিং এবং entityLookup এপিআই কুইরির বিষয়ে আরও জানতে, দেখুন Cato API রেট সীমাবদ্ধতা বোঝা।

entityLookup ক্ষেত্রগুলির বিস্তারিত

এগুলি হল বিস্তারিত যা auditFeed ক্ষেত্রসমূহ কোয়েরির জন্য দেখাতে পারে:

• আইটেম - আইটেম ক্ষেত্র প্রত্যেক এন্টিটির জন্য ডেটা অন্তর্ভুক্ত করে
• মোট - এই কোয়েরির জন্য ফেরত হওয়া এন্টিটিজের মোট সংখ্যা

entityLookup আইটেমস

EntityInfo ক্ষেত্রসমূহ প্রতি এন্টিটির জন্য ডেটা দেখায়, অন্তর্ভুক্ত করে:

• এন্টিটি - Cato ম্যানেজমেন্ট অ্যাপ্লিকেশন থেকে আইডি, নাম দেখায়, এবং এন্টিটির টাইপ যা সাধারণত সাইট অথবা vpnUser হয়
• বর্ণনা - Cato ম্যানেজমেন্ট অ্যাপ্লিকেশন থেকে এন্টিটির বর্ণনা
• সহকারীফিল্ডস - এন্টিটির সম্পর্কে অতিরিক্ত প্রাসঙ্গিক তথ্য এবং ডেটা

entityLookup মোট

মোট ক্ষেত্রটি Cato ম্যানেজমেন্ট অ্যাপ্লিকেশনে আপনার অ্যাকাউন্টের জন্য এন্টিটিজের মোট সংখ্যা প্রদর্শন করে। এই ক্ষেত্রের মান API রিটার্নের পেজিনেশনের সময় পরিবর্তন হয় না এবং এটি আপনাকে এটি পুনরুদ্ধার করা মোট রেকর্ডগুলির সাথে তুলনা করতে সহজ করতে পারে।

entityLookup এর জন্য আর্গুমেন্টস

এগুলি হলো আর্গুমেন্ট যা আপনি পাস করতে পারেন এবং কোয়েরি দ্বারা ফেরত দেয়া এন্টিটিজকে নির্ধারণ করতে পারেন:

• অ্যাকাউন্টআইডিজ - অ্যাকাউন্ট আইডি, একাধিক অ্যাকাউন্টের জন্য, আইডিগুলি একটি অ্যারের হিসাবে প্রবেশ করান (আবশ্যকীয় আর্গুমেন্ট)
• টাইপ - সাইট অথবা vpnUser এর মতো প্রকারের সাথে মেলে এমন এন্টিটিজকে ফেরত দেয়া হয় (আবশ্যকীয় আর্গুমেন্ট)
• সীমা - এই কোয়েরির জন্য ফেরত হওয়া এন্টিটিজের সর্বোচ্চ সংখ্যা (ডিফল্ট মান ৫০)
• থেকে - এন্ট্রিগুলির সূচক অনুযায়ী, এই নির্দিষ্ট এন্টিটি থেকে কোয়েরি শুরু করুন
• অনুসন্ধান - এই মূল্যের ভিত্তিতে রিটার্ন ফিল্টার করুন
• এন্টিটি আইডিজ - একাধিক এন্টিটির জন্য, আইডিগুলি একটি অ্যারের হিসাবে প্রবেশ করান
• ক্রমবর্ধমান - কোয়েরি যে এন্টিটিজকে ফেরত দেয় তা কীভাবে সাজানো হয় তা নির্ধারণ করতে

entityLookup অ্যাকাউন্টID আর্গুমেন্ট

কোয়েরির দ্বারা ফেরত দেয়া ডেটার জন্য একটি বা একাধিক অ্যাকাউন্ট আইডি লিখুন।

এই অ্যাকাউন্ট আইডি প্রশাসন > সাধারণ তথ্য পৃষ্ঠায় প্রদর্শিত হয়।

কোয়েরির জন্য accountIDs আর্গুমেন্টটি আবশ্যক।

entityLookup টাইপ আর্গুমেন্ট

টাইপ আর্গুমেন্ট কোয়েরির দ্বারা ফেরত দেয়া এন্টিটি ডেটাকে নির্ধারণ করে। এগুলি টাইপ যুক্তির জন্য সমর্থিত মান: সাইট, vpnUser, এবং অ্যাডমিনিস্ট্রেটররা।

টাইপ যুক্তি অনুসন্ধানের জন্য বাধ্যতামূলক। প্রতিটি মানের জন্য enum আইটেমের জন্য স্কিমাটি দেখুন।

entityLookup সীমা আর্গুমেন্ট

সীমা আর্গুমেন্টটি সংজ্ঞায়িত করে অনুসন্ধানটি যে সর্বাধিক এন্টিটিগুলিকে ফেরত দেয়। যদি আপনি সীমা আর্গুমেন্টটি নির্দিষ্ট না করেন, তবে অনুসন্ধানটি ৫০ এন্টিটিতে সীমাবদ্ধ।

প্রতিটি অনুসন্ধান সর্বাধিক ১০০০ এন্টিটি ফেরত দিতে পারে।

entityLookup থেকে আর্গুমেন্ট

থেকে আর্গুমেন্ট সংজ্ঞায়িত করে যে এন্টিটি থেকে অনুসন্ধানটি শুরু হবে। উদাহরণস্বরূপ, যদি একাউন্টে ১০০ ভিপিএন ব্যবহারকারী থাকে, তবে শুধুমাত্র শেষ ৪০টি ভিপিএন ব্যবহারকারী এন্টিটি দেখানোর জন্য এটিকে ৬০ পর্যন্ত সেট করুন।

অনুসন্ধানে প্রথম আইটেমটি ০। সুতরাং, যদি আপনি শুধুমাত্র আইটেম ২০ থেকে শুরু করে দেখাতে চান, তাহলে এটিকে ১৯ পর্যন্ত সেট করুন।

entityLookup অনুসন্ধান আর্গুমেন্ট

অনুসন্ধান আর্গুমেন্টটি অনুসন্ধানটি ফিল্টার করে শুধুমাত্র মিলিত এন্টিটি নামগুলি ফেরত দেয়। অনুসন্ধান আর্গুমেন্টটি একটি স্ট্রিং মান।

entityLookup entityIDs আর্গুমেন্ট

entityIDs আর্গুমেন্ট শুধুমাত্র সেই এন্টিটিগুলিকে ফেরত দেয় যা আইডিগুলির সাথে মিলে।

entityLookup ক্রম আর্গুমেন্ট

ক্রম আর্গুমেন্টটি আপনাকে এন্টিটির আইডি বা নাম অনুসারে ডেটা আরোহী বা অবরোহী ক্রমে সাজানোর সুযোগ দেয়।

• ক্ষেত্র - ক্ষেত্রের মান হিসাবে নাম বা আইডি ব্যবহার করুন
• ক্রম - ফলাফলগুলোকে আরোহী (asc) বা অবরোহী (dsc) ক্রমে সাজান

উদাহরণস্বরূপ, নাম অনুযায়ী ফলাফলগুলোকে আরোহী ক্রমে (a-z) সাজাতে এই আর্গুমেন্টটি ব্যবহার করুন: sort:{field"name", order:asc}

query entityLookup ($accountID: ID!, $type: EntityType!, $search: String) {
 entityLookup (accountID: $accountID, type: $type, search: $search) {
 items {
 entity {
 id
 name
 }
 }
 }
}

{
 "accountID": "26",
 "type": "site"
}

তদন্ত এন্টিটি̈লো̈কআপ ($accountID: আইডি!, $type: এন্টিটি টাইপ!, $search: স্ট্রিং) {
    এন্টিটি̈লো̈কআপ (accountID: $accountID, type: $type, search: $search) {
        আইটেমগুলি {
            এন্টিটি {
                আইডি
                নাম
            }
        }
    }
}

{
    "accountID": "26",
    "type": "সাইট",
    "search": "MySite"
}

তদন্ত এন্টিটি̈লো̈কআপ ($accountID: আইডি!, $type: এন্টিটি টাইপ!, $parent: এন্টিটি ইনপুট!) {
    এন্টিটি̈লো̈কআপ (accountID: $accountID, type: $type, parent: $parent) {
        আইটেমগুলি {
            এন্টিটি {
                আইডি
                নাম
                ধরন
            }
            বর্ণনা
            সহকারী ক্ষেত্রসমূহ
            }
        }
    }
}

{
    "accountID": "26",
    "type": "নেটওয়ার্ক ইন্টারফেস",
    "parent": {
        "id": 52180,
        "type": "সাইট"
    }
}