Update Snmp Collector
Updates the snmp collector configuration with the configuration provided. This configuration change is not reflected in the running collector. It is stored in an intermediate database, with the status as "NOT_SYNC".
Request
URI
PUT
https://{api_host}/tcsa/api/v1/snmp/collector
COPY
Query Parameters
string
snmpIntegration
Optional
The name of the current snmp integration
snmpIntegration example
snmp-integration
Request Body
The Snmp Collector to be created
SnmpCollectorRequest of type(s) application/json
Required
Show optional properties
{
"dcName": "_core",
"collectorConfiguration": {
"name": "collectora"
}
}{
"dcName": "_core",
"collectorConfiguration": {
"name": "collector-a",
"pollerPrefix": "string",
"groupName": "string",
"oidsThreads": 0,
"tableThreads": 0,
"alwaysPushProperties": false,
"handleCounterWrapAround": false,
"oidAsPropertyInRawValues": false,
"usePollerPrefixInVariable": false,
"pollingGroupsWereSplit": false,
"localCommunicationSettings": {
"hostIpAddress": "localhost",
"communicationPort": 2008,
"communicationInterfaceIpAddress": "string",
"outInterfaceIPAddresses": [
"string"
],
"maxConcurrentSessions": 0,
"acceptCommandsFromIPAddresses": [
"string"
]
}
},
"snmpAgents": [
{
"name": "V2Agent",
"ipAddress": "10.106.126.64",
"snmpPort": 161,
"transportProtocol": "udp",
"snmpTimeout": 1000,
"snmpNumberOfRetries": 5,
"snmpVersion": "v2c",
"snmpCommunityOrUserV3Name": "public",
"maxBulkSize": 50,
"devType": "Switch",
"onFailTryWith": "v1",
"doNotUseGetBulkRequests": false,
"doNotUseCapabilityList": [],
"collectorNameList": [
"check-1"
],
"pollingPeriod": 200
}
],
"snmpMasks": {
"configVersion": "6.6",
"snmpMasks": [
{
"name": "GENERIC-INTERFACES",
"version": "3.0",
"mibFiles": [
"RFC1213-MIB.mib",
"IANAifType-MIB.mib",
"IF-MIB.my",
"SNMPv2-MIB.my",
"SNMPv2-SMI.mib",
"IP-MIB.mib",
"SNMPv2-CONF.mib",
"SNMPv2-TC.mib"
],
"snmpTables": [
{
"allOrNone": true,
"tableFilterColumnConstraint": true,
"id": "stdIfT1",
"name": "stdIfTable1",
"oid": ".1.3.6.1.2.1.2.2",
"tableIndex": ".1.100",
"indexEntryMask": "oid._._.100",
"tableColNameOid": ".1.2",
"partType": "Interface",
"useSnmpV2cMultipleRowPolling": false,
"snmpRepeaters": -1,
"cacheAllSnmpReferenceTables": false,
"sortOnOid": false,
"tableRowSpecificationFile": null,
"matchNFirstOidSuffixOnly": 0,
"innerJoinOnList": null,
"nextRefTableColIdxOid": ".1.100",
"referenceTableOid": null,
"refTableColIdxOid": null,
"refTableColNameOid": null,
"snmpColumns": [
{
"allOrNone": true,
"name": "ifAdminStatus",
"appendOid": ".1.7",
"as": null,
"unit": null,
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOperStatus",
"appendOid": ".1.8",
"as": null,
"unit": null,
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
}
],
"propertyValues": null,
"snmpFilters": null,
"nextSnmpReferenceTables": [
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifDescr",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "part",
"propertyValueAppendOid": ".1.2",
"hexValue": false,
"usePropertyValueInVariableName": true,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifType",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "iftype",
"propertyValueAppendOid": ".1.3",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifSpeed",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "maxspeed",
"propertyValueAppendOid": ".1.5",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifPhysAddress",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifacemac",
"propertyValueAppendOid": ".1.6",
"hexValue": true,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifOperStatus",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "partstat",
"propertyValueAppendOid": ".1.8",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ipAddrTable.ipAdEntAddr",
"referenceTableOid": ".1.3.6.1.2.1.4.20",
"refTableColIdxOid": ".1.2",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifaceip",
"propertyValueAppendOid": ".1.1",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": null,
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifName",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifname",
"propertyValueAppendOid": ".1.1",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifAlias",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifalias",
"propertyValueAppendOid": ".1.18",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifHighSpeed",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "mxhspeed",
"propertyValueAppendOid": ".1.15",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
}
]
},
{
"allOrNone": true,
"tableFilterColumnConstraint": true,
"id": "stdIfT2",
"name": "stdIfTable2",
"oid": ".1.3.6.1.2.1.2.2",
"tableIndex": ".1.100",
"indexEntryMask": "oid._._.100",
"tableColNameOid": ".1.2",
"partType": "Interface",
"useSnmpV2cMultipleRowPolling": false,
"snmpRepeaters": -1,
"cacheAllSnmpReferenceTables": false,
"sortOnOid": false,
"tableRowSpecificationFile": null,
"matchNFirstOidSuffixOnly": 0,
"innerJoinOnList": null,
"nextRefTableColIdxOid": ".1.100",
"referenceTableOid": null,
"refTableColIdxOid": null,
"refTableColNameOid": null,
"snmpColumns": [
{
"allOrNone": true,
"name": "ifInDiscards",
"appendOid": ".1.13",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifInErrors",
"appendOid": ".1.14",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifInUnknownProtos",
"appendOid": ".1.15",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutDiscards",
"appendOid": ".1.19",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutErrors",
"appendOid": ".1.20",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
}
],
"propertyValues": null,
"snmpFilters": [
{
"name": null,
"appendOid": ".1.7",
"onTableName": null,
"onTableOid": null,
"onTableColumnName": null,
"indexEntryMask": null,
"valueEquals": "up",
"invertMatch": false,
"outerJoinOnList": null,
"innerJoinOnList": null,
"snmpFilters": null
}
],
"nextSnmpReferenceTables": [
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifDescr",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "part",
"propertyValueAppendOid": ".1.2",
"hexValue": false,
"usePropertyValueInVariableName": true,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifType",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "iftype",
"propertyValueAppendOid": ".1.3",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifSpeed",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "maxspeed",
"propertyValueAppendOid": ".1.5",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifPhysAddress",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifacemac",
"propertyValueAppendOid": ".1.6",
"hexValue": true,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifOperStatus",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "partstat",
"propertyValueAppendOid": ".1.8",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ipAddrTable.ipAdEntAddr",
"referenceTableOid": ".1.3.6.1.2.1.4.20",
"refTableColIdxOid": ".1.2",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifaceip",
"propertyValueAppendOid": ".1.1",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": null,
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifName",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifname",
"propertyValueAppendOid": ".1.1",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifAlias",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifalias",
"propertyValueAppendOid": ".1.18",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifHighSpeed",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "mxhspeed",
"propertyValueAppendOid": ".1.15",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
}
]
},
{
"allOrNone": true,
"tableFilterColumnConstraint": true,
"id": "stdIfT3",
"name": "stdIfTable3",
"oid": ".1.3.6.1.2.1.2.2",
"tableIndex": ".1.100",
"indexEntryMask": "oid._._.100",
"tableColNameOid": null,
"partType": "Interface",
"useSnmpV2cMultipleRowPolling": false,
"snmpRepeaters": -1,
"cacheAllSnmpReferenceTables": false,
"sortOnOid": false,
"tableRowSpecificationFile": null,
"matchNFirstOidSuffixOnly": 0,
"innerJoinOnList": null,
"nextRefTableColIdxOid": ".1.100",
"referenceTableOid": null,
"refTableColIdxOid": null,
"refTableColNameOid": null,
"snmpColumns": [
{
"allOrNone": true,
"name": "ifSpeed",
"appendOid": ".1.5",
"as": null,
"unit": "1",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifInOctets",
"appendOid": ".1.10",
"as": "RATEP",
"unit": "Octets/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutOctets",
"appendOid": ".1.16",
"as": "RATEP",
"unit": "Octets/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifInUcastPkts",
"appendOid": ".1.11",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifInNUcastPkts",
"appendOid": ".1.12",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutUcastPkts",
"appendOid": ".1.17",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutNUcastPkts",
"appendOid": ".1.18",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
}
],
"propertyValues": null,
"snmpFilters": [
{
"name": null,
"appendOid": ".1.7",
"onTableName": null,
"onTableOid": null,
"onTableColumnName": null,
"indexEntryMask": null,
"valueEquals": "up",
"invertMatch": false,
"outerJoinOnList": null,
"innerJoinOnList": null,
"snmpFilters": [
{
"name": null,
"appendOid": ".1.5",
"onTableName": null,
"onTableOid": null,
"onTableColumnName": null,
"indexEntryMask": null,
"valueEquals": "100000000|[0-9]{1,8}",
"invertMatch": false,
"outerJoinOnList": null,
"innerJoinOnList": null,
"snmpFilters": null
}
]
}
],
"nextSnmpReferenceTables": [
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifDescr",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "part",
"propertyValueAppendOid": ".1.2",
"hexValue": false,
"usePropertyValueInVariableName": true,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifType",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "iftype",
"propertyValueAppendOid": ".1.3",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifSpeed",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "maxspeed",
"propertyValueAppendOid": ".1.5",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifPhysAddress",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifacemac",
"propertyValueAppendOid": ".1.6",
"hexValue": true,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifOperStatus",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "partstat",
"propertyValueAppendOid": ".1.8",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ipAddrTable.ipAdEntAddr",
"referenceTableOid": ".1.3.6.1.2.1.4.20",
"refTableColIdxOid": ".1.2",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifaceip",
"propertyValueAppendOid": ".1.1",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": null,
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifName",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifname",
"propertyValueAppendOid": ".1.1",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifAlias",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifalias",
"propertyValueAppendOid": ".1.18",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifHighSpeed",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "mxhspeed",
"propertyValueAppendOid": ".1.15",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
}
]
},
{
"allOrNone": true,
"tableFilterColumnConstraint": true,
"id": "stdIfXT3",
"name": "stdIfXTable3",
"oid": ".1.3.6.1.2.1.31.1.1",
"tableIndex": ".1.100",
"indexEntryMask": "oid._._.100",
"tableColNameOid": null,
"partType": "Interface",
"useSnmpV2cMultipleRowPolling": false,
"snmpRepeaters": -1,
"cacheAllSnmpReferenceTables": false,
"sortOnOid": false,
"tableRowSpecificationFile": null,
"matchNFirstOidSuffixOnly": 0,
"innerJoinOnList": [
{
"name": "ifIndex",
"appendOid": ".1.100"
}
],
"nextRefTableColIdxOid": ".1.100",
"referenceTableOid": null,
"refTableColIdxOid": null,
"refTableColNameOid": null,
"snmpColumns": [
{
"allOrNone": true,
"name": "ifSpeed",
"appendOid": ".1.15",
"as": null,
"unit": "1000000",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifInOctets",
"appendOid": ".1.6",
"as": "RATEP",
"unit": "Octets/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutOctets",
"appendOid": ".1.10",
"as": "RATEP",
"unit": "Octets/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifInUcastPkts",
"appendOid": ".1.7",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifInMulticastPkts",
"appendOid": ".1.8",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifInBroadcastPkts",
"appendOid": ".1.9",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutUcastPkts",
"appendOid": ".1.11",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutMulticastPkts",
"appendOid": ".1.12",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutBroadcastPkts",
"appendOid": ".1.13",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
}
],
"propertyValues": null,
"snmpFilters": [
{
"name": null,
"appendOid": ".1.15",
"onTableName": null,
"onTableOid": null,
"onTableColumnName": null,
"indexEntryMask": null,
"valueEquals": "[0-9]{4,}|[2-9][0-9]{2}|1[1-9][0-9]|10[1-9]",
"invertMatch": false,
"outerJoinOnList": null,
"innerJoinOnList": null,
"snmpFilters": [
{
"name": "ifTable.ifAdminStatusFilter",
"appendOid": ".1.7",
"onTableName": "ifTable.ifAdminStatusFilter",
"onTableOid": ".1.3.6.1.2.1.2.2",
"onTableColumnName": "ifAdminStatus",
"indexEntryMask": "oid._._.100",
"valueEquals": "up",
"invertMatch": false,
"outerJoinOnList": [
{
"name": "ifIndex",
"appendOid": ".1.100"
}
],
"innerJoinOnList": null,
"snmpFilters": null
}
]
}
],
"nextSnmpReferenceTables": [
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifDescr",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "part",
"propertyValueAppendOid": ".1.2",
"hexValue": false,
"usePropertyValueInVariableName": true,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifType",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "iftype",
"propertyValueAppendOid": ".1.3",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifSpeed",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "maxspeed",
"propertyValueAppendOid": ".1.5",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifPhysAddress",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifacemac",
"propertyValueAppendOid": ".1.6",
"hexValue": true,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifOperStatus",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "partstat",
"propertyValueAppendOid": ".1.8",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ipAddrTable.ipAdEntAddr",
"referenceTableOid": ".1.3.6.1.2.1.4.20",
"refTableColIdxOid": ".1.2",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifaceip",
"propertyValueAppendOid": ".1.1",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": null,
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifName",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifname",
"propertyValueAppendOid": ".1.1",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifAlias",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifalias",
"propertyValueAppendOid": ".1.18",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifHighSpeed",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "mxhspeed",
"propertyValueAppendOid": ".1.15",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
}
]
},
{
"allOrNone": true,
"tableFilterColumnConstraint": true,
"id": "stdIfXT4a",
"name": "stdIfXTable4a",
"oid": ".1.3.6.1.2.1.31.1.1",
"tableIndex": ".1.100",
"indexEntryMask": "oid._._.100",
"tableColNameOid": null,
"partType": "Interface",
"useSnmpV2cMultipleRowPolling": false,
"snmpRepeaters": -1,
"cacheAllSnmpReferenceTables": false,
"sortOnOid": false,
"tableRowSpecificationFile": null,
"matchNFirstOidSuffixOnly": 0,
"innerJoinOnList": [
{
"name": "ifIndex",
"appendOid": ".1.100"
}
],
"nextRefTableColIdxOid": ".1.100",
"referenceTableOid": null,
"refTableColIdxOid": null,
"refTableColNameOid": null,
"snmpColumns": [
{
"allOrNone": true,
"name": "ifInMulticastPkts",
"appendOid": ".1.2",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifInBroadcastPkts",
"appendOid": ".1.3",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutMulticastPkts",
"appendOid": ".1.4",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
},
{
"allOrNone": true,
"name": "ifOutBroadcastPkts",
"appendOid": ".1.5",
"as": "RATEP",
"unit": "Pkts/s",
"partType": null,
"propertyName": "ifindex",
"propertyValueAppendOid": ".1.100",
"varNameGenOidSequence": null,
"refreshOnPropertyChange": false,
"propertyValues": null,
"snmpFilters": null
}
],
"propertyValues": null,
"snmpFilters": [
{
"name": "ifTable.ifAdminStatusSpeedFilter",
"appendOid": ".1.7",
"onTableName": "ifTable.ifAdminStatusSpeedFilter",
"onTableOid": ".1.3.6.1.2.1.2.2",
"onTableColumnName": "ifAdminStatus",
"indexEntryMask": "oid._._.100",
"valueEquals": "up",
"invertMatch": false,
"outerJoinOnList": [
{
"name": "ifIndex",
"appendOid": ".1.100"
}
],
"innerJoinOnList": null,
"snmpFilters": [
{
"name": null,
"appendOid": ".1.5",
"onTableName": null,
"onTableOid": null,
"onTableColumnName": null,
"indexEntryMask": null,
"valueEquals": "100000000|[0-9]{1,8}",
"invertMatch": false,
"outerJoinOnList": null,
"innerJoinOnList": null,
"snmpFilters": null
}
]
}
],
"nextSnmpReferenceTables": [
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifDescr",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "part",
"propertyValueAppendOid": ".1.2",
"hexValue": false,
"usePropertyValueInVariableName": true,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifType",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "iftype",
"propertyValueAppendOid": ".1.3",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifSpeed",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "maxspeed",
"propertyValueAppendOid": ".1.5",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifPhysAddress",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifacemac",
"propertyValueAppendOid": ".1.6",
"hexValue": true,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifTable.ifOperStatus",
"referenceTableOid": ".1.3.6.1.2.1.2.2",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "partstat",
"propertyValueAppendOid": ".1.8",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ipAddrTable.ipAdEntAddr",
"referenceTableOid": ".1.3.6.1.2.1.4.20",
"refTableColIdxOid": ".1.2",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifaceip",
"propertyValueAppendOid": ".1.1",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": null,
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifName",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifname",
"propertyValueAppendOid": ".1.1",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifAlias",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "ifalias",
"propertyValueAppendOid": ".1.18",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
},
{
"nextSnmpReferenceTableConstraint": true,
"name": "ifXTable.ifHighSpeed",
"referenceTableOid": ".1.3.6.1.2.1.31.1.1",
"refTableColIdxOid": ".1.100",
"parentTablecolIdxOidPositions": "1",
"propertyName": "mxhspeed",
"propertyValueAppendOid": ".1.15",
"hexValue": false,
"usePropertyValueInVariableName": false,
"nextRefTableColIdxOid": null,
"longLifeCaching": false,
"indexEntryMask": "oid._._.100",
"nextSnmpReferenceTable": null
}
]
}
],
"snmpOids": [
{
"id": "ipForwDatagrams",
"name": "ipForwDatagrams",
"oid": ".1.3.6.1.2.1.4.6.0",
"as": "RATEP",
"unit": null,
"part": null,
"partType": null,
"propertyValues": null
},
{
"id": "ipForwarding",
"name": "ipForwarding",
"oid": ".1.3.6.1.2.1.4.1.0",
"as": null,
"unit": null,
"part": null,
"partType": null,
"propertyValues": null
}
],
"snmpProperties": [
{
"oneOrNone": true,
"id": "w4ncert",
"name": "w4ncert",
"value": "1.0",
"oid": null
},
{
"oneOrNone": true,
"id": "datagrp",
"name": "datagrp",
"value": "GENERIC-INTERFACES",
"oid": null
},
{
"oneOrNone": true,
"id": "altsrc",
"name": "altsrc",
"value": "Generic-SNMP",
"oid": null
}
],
"snmpActionRequest": {
"capabilityName": "GENERIC-INTERFACES",
"loadFactor": 40,
"defaultPollingPeriod": 0,
"discoveryPasses": [
{
"capabilityConditionGroup": [
{
"name": "TableExistsSnmpCondition",
"oid": ".1.3.6.1.2.1.2.2",
"matchValue": "",
"invertResult": false
},
{
"name": "TableColumnUniqueValuesSnmpCondition",
"oid": ".1.3.6.1.2.1.2.2.1.2",
"matchValue": "",
"invertResult": false
},
{
"name": "TableExistsSnmpCondition",
"oid": ".1.3.6.1.2.1.31.1.1",
"matchValue": "",
"invertResult": false
}
]
},
{
"capabilityConditionGroup": [
{
"name": "TableColumnExistsSnmpCondition",
"oid": ".1.3.6.1.2.1.31.1.1.1.6",
"matchValue": "",
"invertResult": false
},
{
"name": "TableColumnExistsSnmpCondition",
"oid": ".1.3.6.1.2.1.31.1.1.1.10",
"matchValue": "",
"invertResult": false
}
]
}
]
},
"actions": 2,
"doNotEdit": true
}
]
},
"translations": {
"variableSpecificTranslations": [
{
"name": "ifAdminStatus",
"valueMatches": [
{
"rename": "up",
"value": "100"
}
]
}
],
"configVersion": "6.6"
},
"pollingGroups": [
{
"pollingMaskNames": [
"GENERIC-SYSUPTIME",
"GENERIC-INTERFACES"
],
"pollingPeriod": 300,
"startAtDefinedPeriod": false,
"startTimeOffset": 0,
"enabled": true,
"assignedTo": "collector-a",
"groupName": "group",
"uniformTimestamps": false,
"name": "GEN-VEIVN9SWIB-300-check",
"snmpAgentNames": [
"10.106.232.11:161"
],
"tableDiscoveryTime": "00:00:00"
}
],
"loadFactor": 5000,
"distributionFactor": 100,
"pollingPeriod": 300
}string
dcName
Required
Constraints: default: _core
The name of the data-center where this collector runs
object
collectorConfiguration
Required
All collector configurations are listed here
array of object
snmpAgents
Optional
All the configured agents for this collector can be listed here, alongside with their respective properties and polling settings
object
snmpMasks
Optional
The snmpMask configurations are listed here
object
translations
Optional
The Snmp Translations are listed here.
array of object
pollingGroups
Optional
All Polling group configurations associated with the particular collector are listed here.
integer
loadFactor
Optional
Constraints: default: 5000
This number indicates the maximum load which should be applied to the linked SNMP Collector. This load may be exceeded depending upon the Device distribution weight assigned to this collector.
integer
distributionFactor
Optional
Constraints: default: 100
This is the proportional weight of the Collector when Device distribution and configuration generation takes place. This Collector will poll its share of the Device set, proportional to the sum of all applicable Collector distribution weights.
integer
pollingPeriod
Optional
Constraints: default: 300
The default polling period with which polling groups will be generated for this particular collector after discovery. Note: There is an order of precedence followed when assigning polling periods to generated polling groups - 1] Polling period of the Capability 2] Polling Period of Agent 3] Polling Period of the Collector
Responses
200
OK Returned successfully updated configuration of an SNMP collector, with state as NOT_SYNC
Returns SnmpCollectorResponse of type(s) application/json
"SnmpCollectorResponse Object"string
dcName
Required
Constraints: default: _core
The name of the data-center where this collector runs
object
collectorConfiguration
Required
All collector configurations are listed here
array of object
snmpAgents
Optional
All the configured agents for this collector can be listed here, alongside with their respective properties and polling settings
object
snmpMasks
Optional
The snmpMask configurations are listed here
object
translations
Optional
The Snmp Translations are listed here.
array of object
pollingGroups
Optional
All Polling group configurations associated with the particular collector are listed here.
integer
loadFactor
Optional
Constraints: default: 5000
This number indicates the maximum load which should be applied to the linked SNMP Collector. This load may be exceeded depending upon the Device distribution weight assigned to this collector.
integer
usedLoad
Optional
Constraints: default: 0
The current load of the collector
integer
distributionFactor
Optional
Constraints: default: 100
This is the proportional weight of the Collector when Device distribution and configuration generation takes place. This Collector will poll its share of the Device set, proportional to the sum of all applicable Collector distribution weights.
array of string
capabilitiesList
Optional
The capabilities available on ths collector. This list is always empty as by default all capabilities are applicable to all Snmp collectors.
string
ipAddress
Optional
The ipAddress of the collector
string
status
Optional
The status of the collector. If the configuration has not been sent to the collector manager then the status is NOT_SYNC otherwise it is SYNC
Possible values are : NOT_SYNC, IN_SYNC,
string
collectorNameInK8
Optional
Given a user entered collector name, it is converted into a format that can be displayed in K8s. That involves converting uppercase to lowercase, underscores and periods to hyphens.
integer
pollingPeriod
Optional
Constraints: default: 300
The default polling period with which polling groups will be generated for this particular collector after discovery. Note: There is an order of precedence followed when assigning polling periods to generated polling groups - 1] Polling period of the Capability 2] Polling Period of Agent 3] Polling Period of the Collector
number
creationTime
Optional
The epoch time of creation of the snmp collector.
400
BAD REQUEST Error in the request sent
Returns SnmpError of type(s) application/json
"SnmpError Object"string
code
Optional
This code refers to the internal error codes used in the code base.
string
reason
Optional
This specifies the reason for failure.
string
status
Optional
This specifies the HTTP status code error
404
NOT FOUND Requested object not found
Returns SnmpError of type(s) application/json
"SnmpError Object"string
code
Optional
This code refers to the internal error codes used in the code base.
string
reason
Optional
This specifies the reason for failure.
string
status
Optional
This specifies the HTTP status code error
500
INTERNAL SERVER ERROR Error on the server
Returns SnmpError of type(s) application/json
"SnmpError Object"string
code
Optional
This code refers to the internal error codes used in the code base.
string
reason
Optional
This specifies the reason for failure.
string
status
Optional
This specifies the HTTP status code error
Code Samples
COPY
curl -X PUT -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"collectorConfiguration:"object","dcName:"string"}' https://{api_host}/tcsa/api/v1/snmp/collector
On This Page
Snmp Operations
POST
Initialize Snmp Collector
PUT
Update Snmp Collector
GET
Get All Snmp Collectors
DELETE
Delete Snmp Collector
POST
Send Collector Configurations
GET
Retrieve Snmp Collectors
POST
Poll Collectors For Affected Polling Groups
POST
Update Snmp Integration
GET
Get Entire Snmp Integration
POST
Add Snmp Agent
PUT
Update Snmp Agent
GET
Get All Snmp Agents
DELETE
Delete Snmp Agent
GET
Retrieve Snmp Agent
POST
Poll Agents For Affected Polling Groups
POST
Discover Capabilities
GET
Download Snmp Agents
POST
Cancel Discovery
POST
Upload Snmp Agents
POST
Upload Snmp Mask
POST
Add Snmp Mask
PUT
Update Snmp Mask
GET
Get Snmp Masks
DELETE
Delete Snmp Mask
GET
Retrieve Snmp Mask
POST
Poll Masks For Affected Polling Groups
POST
Upload Snmp Translations
GET
Get Snmp Translations
POST
Upload Mib
GET
Get All Mib Files
POST
Upload Snmp Actions
GET
Get Snmp Actions
GET
Retrieve Snmp Action
POST
Add Polling Group
PUT
Update Polling Group
GET
Get Polling Groups
DELETE
Delete Polling Groups
GET
Retrieve Polling Group