আমরা দৃঢ়ভাবে সুপারিশ করছি যে কাটো এপিআই ব্যবহার শুরু করার আগে, দয়া করে কাটো এপিআই-এর সহায়তা নীতি পর্যালোচনা করুন।
এই প্রবন্ধটি ব্যাখ্যা করে যে কিভাবে সাইটের জন্য নেটওয়ার্ক রেঞ্জ পরিচালনা করার জন্য ক্যাটো API ব্যবহার করতে হয় এই কমান্ডগুলি দিয়ে:
addNetworkRange
updateNetworkRange
removeNetworkRange
নেটওয়ার্ক রেঞ্জের ওভারভিউ
নেটওয়ার্ক রেঞ্জ মিউটেশন APIs ব্যবহার করুন আপনার অ্যাকাউন্টে একটি সাইটের সকেটে নেটওয়ার্ক রেঞ্জ যোগ করা, আপডেট করা, এবং অপসারণ করা এবং সাইটের জন্য নিম্নলিখিত সেটিংস সংজ্ঞায়িত করুন:
নেটওয়ার্ক রেঞ্জ আইডি (স্বয়ংক্রিয়ভাবে
addNetworkRangeএর জন্য তৈরি করা হয়)LAN সকেট ইন্টারফেস আইডি
নেটওয়ার্ক রেঞ্জের জন্য সেটিংস অন্তর্ভুক্ত করে: সাবনেট, স্থানীয় IP বা গেটওয়ে IP, এবং VLAN
Azure vSocket HA কনফিগারেশনের জন্য, ফ্লোটিং IP ঠিকানা
নেটওয়ার্ক রেঞ্জের জন্য DHCP সেটিংস
রিসেলার অ্যাকাউন্টগুলির জন্য, আপনি ক্যাটো API দিয়ে সেটিংস কনফিগার করার সময় প্রতিটি গ্রাহক অ্যাকাউন্টের ভিতরে পৃথক API কী তৈরি করতে পারেন।
আপনার অ্যাকাউন্টের জন্য accountId সনাক্ত করা
অ্যাকাউন্ট আইডি প্রশাসন> সাধারণ তথ্য পৃষ্ঠায় প্রদর্শিত হয়।
সাইট ক্রিয়েশন API তে accountId আর্গুমেন্টে এই আইডি প্রবেশ করান, উদাহরণস্বরূপ:
site(accountId: 26) {
addSocketSite(input: $addSocketSite) {
siteId
}
}addNetworkRange এবং updateNetworkRange আর্গুমেন্টের জন্য বিশদ
ক্যাটো কনফিগারেশন API ব্যবহার করে সাইটের জন্য একটি নেটওয়ার্ক রেঞ্জ তৈরি বা আপডেট করতে একই আর্গুমেন্টগুলি ব্যবহার করা হয়। addNetworkRange জন্য আর্গুমেন্টগুলি বাধ্যতামূলক যদি না ঐচ্ছিক হিসাবে চিহ্নিত করা হয়। updateNetworkRange এর জন্য, আপনি যেগুলি আপডেট করছেন তার সাইটক ইন্টারফেস সেটিংসের জন্য আর্গুমেন্টগুলি অন্তর্ভুক্ত করুন।
networkRangeId - নেটওয়ার্ক রেঞ্জের জন্য আইডি (updateNetworkRange এর জন্য)
lanSocketInterfaceId - নেটওয়ার্ক ইন্টারফেসের জন্য আইডি যা নেটওয়ার্ক রেঞ্জের সাথে সম্পর্কিত (addNetworkRange এর জন্য)
name - নেটওয়ার্ক রেঞ্জের নাম
rangeType - নেটওয়ার্ক রেঞ্জের ধরন (রাউটেড, ডাইরেক্ট, ইত্যাদি)
subnet - LAN ইন্টারফেসের জন্য CIDR ফরম্যাটে নেটিভ রেঞ্জ
localIP - LAN নেটওয়ার্ক রেঞ্জের জন্য স্থানীয় IP ঠিকানা
gateway - রাউটেড রেঞ্জের জন্য, প্রতিবেশী রাউটারের জন্য পরবর্তী হপ IP ঠিকানা
vlan - নেটওয়ার্ক রেঞ্জের জন্য VLAN আইডি
azureFloutingIP - Azure HA কনফিগারেশনের জন্য, LAN রুট টেবিলের পরবর্তী হপ IP ঠিকানা
dhcpSettings - সংজ্ঞায়িত করে যদি এই নেটওয়ার্ক রেঞ্জ ডিফল্ট অ্যাকাউন্ট DHCP সেটিংস বা কাস্টমাইজড সেটিংস ব্যবহার করে
networkRangeId (updateNetworkRange এর জন্য)
networkRangeId siteRange মানের সহ type ব্যবহার করে entityLookup রিড-অনলি API দ্বারা আহরণ করা যায়
আপনি search প্যারামিটার সাইটের নামের মান দিয়ে ব্যবহার করতে পারেন এবং প্রশ্নটি অন্যান্য সাইট থেকে রেঞ্জগুলি ফিল্টার করে।
lanSocketInterfaceId (addNetworkRange এর জন্য)
lanSocketInterfaceId আর্গুমেন্টের জন্য মান আহরণের জন্য entityLookup API প্রশ্ন ব্যবহার করুন। অধিক তথ্যের জন্য, দেখুন কাটো API - EntityLookup।
type ব্যবহার করুন networkInterface মানের সহ এবং এই parent ক্ষেত্রগুলি থেকে মান:
id - <site id>
name - <name of interface>
lanSocketInterfaceId এর জন্য নিম্নলিখিত নমুনা স্ক্রিপ্ট দেখুন, নমুনা পোস্টম্যান স্ক্রিপ্ট।
networkRange নাম
name আর্গুমেন্টটি নেটওয়ার্ক রেঞ্জের নামের জন্য।
networkRange rangeType
rangeType একটি এ্যানাম আর্গুমেন্ট যা নেটওয়ার্ক রেঞ্জের ধরন সংজ্ঞায়িত করে।
এগুলি হল বিকল্পসমূহ:
রাউটেড - নেটওয়ার্ক রেঞ্জ যা একটি রাউটের মাধ্যমে একটি সকেটে সংযুক্ত হয়
ডাইরেক্ট - নেটওয়ার্ক রেঞ্জ সরাসরি সকেটে বা ফায়ারওয়ালে (বিনা রাউটার ব্যবহার), কিন্তু IP রেঞ্জ সাইটের নেটিভ রেঞ্জের চেয়ে আলাদা
VLAN - ক্যাটোতে সংযুক্ত VLANগুলি একটি ট্রাঙ্ক পোর্টের মতো
নেটিভ - LAN ইন্টারফেসের জন্য সংজ্ঞায়িত IP রেঞ্জ
সেকেন্ডারি নেটিভ - সকেট HA কনফিগারেশনের জন্য, সেকেন্ডারি সকেটের জন্য নেটিভ রেঞ্জ
networkRange সাবনেট
subnet আর্গুমেন্টে CIDR IPSubnet ফরম্যাটে সাইটের জন্য নেটওয়ার্ক রেঞ্জের IP রেঞ্জ সংজ্ঞায়িত করুন। /31 এবং /32 CIDR ব্লকগুলি সমর্থিত নয়।
networkRange স্থানীয় IP
(এই রেঞ্জগুলির জন্য বাধ্যতামূলক: নেটিভ, সেকেন্ডারি নেটিভ, ডাইরেক্ট, VLAN) localIP আর্গুমেন্টে LAN নেটওয়ার্ক রেঞ্জের জন্য স্থানীয় IP ঠিকানা সংজ্ঞায়িত করুন।
networkRange গেটওয়ে
(রাউটেড রেঞ্জগুলির জন্য বাধ্যতামূলক) গেটে LAN নেটওয়ার্ক রেঞ্জের জন্য গেটওয়ে IP ঠিকানা gateway আর্গুমেন্টে সংজ্ঞায়িত করুন।
networkRange vlan
(VLAN রেঞ্জগুলির জন্য বাধ্যতামূলক) vlan আর্গুমেন্টে LAN নেটওয়ার্ক রেঞ্জের জন্য VLAN আইডি সংজ্ঞায়িত করুন।
networkRange azureFloatingIp
(Azure HA সকেট কনফিগারেশনের জন্য বাধ্যতামূলক) azureFloatingIp আর্গুমেন্টে LAN নেটওয়ার্ক রেঞ্জের জন্য ফ্লোটিং IP সংজ্ঞায়িত করুন।
networkRange dhcpSettings (ঐচ্ছিক)
dhcpSettings একটি এ্যানাম আর্গুমেন্ট যা নেটওয়ার্ক রেঞ্জের জন্য DHCP সেটিংস সংজ্ঞায়িত করে।
এগুলি হল বিকল্পসমূহ:
dhcpType - নেটওয়ার্ক রেঞ্জের জন্য নিম্নলিখিত DHCP ধরনেরগুলির মধ্যে একটি কনফিগার করুন:
DHCP_RELAY - নেটওয়ার্ক রেঞ্জ একটি DHCP রিলে ব্যবহার করে যা অ্যাকাউন্টের জন্য কনফিগার করা হয় (ডিফাইন করা
relayGroupIdআর্গুমেন্টে)DHCP_RANGE - নেটওয়ার্ক রেঞ্জ DHCP এর জন্য ক্যাটো DHCP সার্ভার ব্যবহার করে,
ipRangeআর্গুমেন্টে সংজ্ঞায়িত IP রেঞ্জ অনুযায়ীACCOUNT_DEFAULT - নেটওয়ার্ক রেঞ্জ অ্যাকাউন্টের জন্য সংজ্ঞায়িত ডিফল্ট DHCP রিলে ব্যবহার করে
DHCP_DISABLED - এই নেটওয়ার্ক রেঞ্জের জন্য DHCP নিষ্ক্রিয় করা হয়েছে
ipRange - DHCP_Range বিকল্পের জন্য উপরে, IP রেঞ্জটি সংজ্ঞায়িত করে যা ক্যাটো DHCP সার্ভার হোস্টগুলিতে দিতে পারে
relayGroupId - DHCP রিলে গ্রুপের আইডি প্রবেশ করুন যা এই নেটওয়ার্ক রেঞ্জ ব্যবহার করে
entityLookup এর জন্য, dhcpRelayGroup মানের সহ
typeব্যবহার করুন
removeNetworkRange
একটি সাইট থেকে নেটওয়ার্ক রেঞ্জ অপসারণ করার জন্য removeNetworkRange API ব্যবহার করুন। এই API এর সাথে শুধুমাত্র networkRangeId ব্যবহার করতে হবে।
নমুনা Postman Script
lanSocketInterfaceID এর জন্য নমুনা entityLookup
query entityLookup ($accountID: ID!, $type: EntityType!, $parent: EntityInput!) {
entityLookup (accountID: $accountID, type: $type, parent: $parent) {
items {
entity {
id
name
type
}
description
}
}
}lanSocketInterfaceID এর জন্য GraphQL ভেরিয়েবল
{
"accountID": "26",
"type": "networkInterface",
"parent": {
"id": 26,
"type": "site"
}
}নতুন VLAN রেঞ্জ তৈরি করার জন্য নমুনা পোস্টম্যান স্ক্রিপ্ট
mutation addNetworkRange ($accountId: ID!, $lanSocketInterfaceId: ID!, $input: AddNetworkRangeInput!) {
site(accountId: $accountId) {
addNetworkRange (lanSocketInterfaceId: $lanSocketInterfaceId, input: $input) {
networkRangeId
}
}
}নতুন VLAN রেঞ্জের জন্য GraphQL ভেরিয়েবল
{
"accountId": "26",
"lanSocketInterfaceId": 26,
"input": {
"name": "Guest WIFI",
"rangeType": "VLAN",
"subnet": "10.1.0.0/24",
"localIp": "10.1.0.0.1",
"vlan": 100
}
}