Plixer Replicator APIs

Authentication

Used to authenticate the user and start/stop API sessions

Login
Starts a new API session
GET request:

Note

Legacy API – Deprecated- recommend using POST

Resource URL:

https://[replicator]/api/1/login/[sha2]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[sha2] Interactive Mode (CLI) password converted to SHA2 512-bit hex
Example request:
https://10.30.17.131/api/1/login/098f6bcd4621d373ca098f6bcd4621d563cade4e832629b4f6d098f4bcd4621d373cade4e831627b4f6e4e832627b4f
POST request:
Starts a new API session
Resource URL:

POST https://[replicator]/api/1/login/

{
 “user” : “admin”
 “passwd”: “[passwd]”
}
Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[passwd] SHA512 hash of the password for the admin username
Example response:
{
  "path": "login successful.",
"result": "success"
}
Log out
Manually terminates an API session (API sessions are automatically terminated after 30 minutes)
Resource URL:

https://[replicator]/api/1/logout

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
Example request:
https://10.30.17.131/api/1/logout
Example response:
{
  "path": "logout successful.",
  "result": "success"
}

Acknowledge

Used to acknowledge Collectors and Exporters that have triggered Alarms

Resource URL:

https://[replicator]/api/1/acknowledge/[entity]/[ip:port]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[entity] exporter or collector
[ip:port] IP address and port of the [entity] to be acknowledged
Example request:
https://10.30.17.131/api/1/acknowledge/collector/10.1.10.4:2055
Example response:
{
   "description": "Success: collector '10.1.10.4:2055' acknowledged.",
   "result": "success"
}

Collector

Used for Collector management operations within Profiles

Resource URL:

Manages a Collector for an individual Profile

https://[replicator]/api/1/collector/[action]/[ip]/[profile]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[action] add or remove
[ip] IP address of the Collector
[profile] Target Profile for the operation
Example request:
https://10.30.17.131/api/1/collector/add/10.1.10.60/myprofile
Example response:
{
  "description": "Success: Collector [10.1.10.60] -> Profile [myprofile]",
  "result": "success"
}
Resource URL:

Removes a Collector from all Profiles

https://[replicator]/api/1/collector/allremove/[ip]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[ip] IP address of the Collector to be removed
Example request:
https://10.30.17.131/api/1/collector/allremove/10.1.10.4
Example response:
{
  "description": "Success: Collector [10.1.10.4] <- All Profiles",
  "result": "success"
}

DNSCheck

Used to perform a DNS check on an IP address

Resource URL:

Forces a DNS name resolution for an IP address

https://[replicator]/api/1/dnscheck/[ip]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[ip] IP address to resolve
Example request:
https://10.30.17.131/api/1/dnscheck/10.1.1.3
Example response:
{
  "dnscheck": {
  "addr": "10.1.1.3",
  "expiry": {
  "epoch": 1462801036,
  "time": "Mon May 9 09:37:16 2016"
  },
  "name": "newexp.plxr.local",
  "resolveTime": 0.04485,
  "status": "success"
  }
}

Exporter

Used for Exporter management operations within Profiles

Resource URL:

Manages an Exporter for an individual Profile

https://[replicator]/api/1/exporter/[action]/[ip]/[profile]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[action] add or remove
[ip] IP address of the Exporter
[profile] Target Profile for the operation
Example request:
https://10.30.17.131/api/1/exporter/add/10.1.1.1/myprofile
Example response:
{
  "description": "Success: Exporter [10.1.1.1] -> Profile [myprofile]",
  "result": "success"
}
Resource URL:

Removes an Exporter from all Profiles

https://[replicator]/api/1/exporter/allremove/[ip]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[ip] IP address of the Exporter to be removed
Example request:
https://10.30.17.131/api/1/exporter/allremove/10.1.1.4
Example response:
{
   "description": "Success: Exporter [10.1.1.4] <- All Profiles",
   "result": "success"
}
Resource URL:

Identifies Exporters that are sending data to the Plixer Replicator but not assigned to any Profiles

https://[replicator]/api/1/exporter/noprofile/[filter]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[filter] Optional filter to apply to the displayed list of Exporters not assigned to any Profiles; returns the full list if not provided
Example request:
https://10.30.17.131/api/1/exporter/noprofile/0
Example response:
{
  "noprofile": {
    "10.30.17.131": {
      "in_o_delta": 0,
      "in_o_rate": "0.0",
      "in_p_delta": 0,
      "in_p_rate": "0.0",
      "lastseen": "Tue Apr 19 09:55:18 2016",
      "out_o_delta": 1493,
      "out_o_rate": "49.8",
      "out_p_delta": 6,
      "out_p_rate": "0.2",
      "unixtime": 1461074118
    },
    "total": 1
  }
}

License

Used to check the status of the current Plixer Replicator license

Resource URL:

Returns the details of the current license

https://[replicator]/api/1/license/check

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
Example request:
https://10.30.17.131/api/1/license/check
Example response:
{
    "daysLeft" : "365 day(s)",
    "expiration" : "Thu May 18 2017",
    "licensedType" : "eval",
    "licensedVersion" : "16.6",
    "machineID" : "6YZ6XEPTA66JA6VHFPXG749B",
    "role" : "failover"
}

Notate

Used to add a description to an Exporter, Collector, or Profile

Resource URL:

https://[replicator]/api/1/notate/[entity]/[identity]/[description]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[entity] profile or ip
[identity] [profile_name] or [ip_address] of entity specified
[description] Description or note to add to the entity in standard ASCII URI-compatible characters
Example request:
https://10.30.17.131/api/1/notate/profile/myprofile/My_Fantastic_Description
Example response:
{
    "description": "Success: Profile 'myprofile' has a new description",
    "result": "success"
}

Policies

Used to manage Policies for Profiles

Resource URL:

https://[replicator]/api/1/policies/[action]/[network]/[cidr]/[profile]/[incexc]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[action] add or remove
[network] address of the network (e.g. 172.17.0.0)
[cidr] CIDR of the network specified (e.g. 16)
[profile] Target Profile for the operation
[incexc] include or exclude
Example request:
https://10.30.17.131/api/1/policies/add/10.1.20.0/16/myprofile/include
Example response:
{
    "description": "Success: Policy [10.1.20.0/16] -> Profile [myprofile]",
    "result": "success"
}

Profile

Used to manage Profile settings and behavior

Resource URL:

Renames an existing Profie

https://[replicator]/api/1/profile/rename/[current]/[new]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[current] Name of the Profile to be renamed
[new] New name for the Profile
Example request:
https://10.30.17.131/api/1/profile/rename/oldprofile/myprofile
Example response:
{
    "description": "Success: Profile 'oldprofile' is now 'myprofile'",
    "result": "success"
}
Resource URL:

Toggles the Singularity flag for a Profile

https://[replicator]/api/1/profile/singularity/[name]/[action]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[name] Name of the Profile to be updated
[action] enable or disable
Example request:
https://10.30.17.131/api/1/profile/singularity/myprofile/enable
Example response:
{
    "description": "Success: Profile 'myprofile' singularity enabled",
    "result": "success"
}
Resource URL:

Removes, disables, or enables a Profile

https://[replicator]/api/1/profile/[action]/[name]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[action] remove, disable, or enable
[name] Target Profile for the operation
Example request:
https://10.30.17.131/api/1/profile/disable/myprofile
Example response:
{
    "description": "Success: Profile myprofile has been set to 'disable'",
    "result": "success"
}
Resource URL:

Creates a new Profile or updates an existing one

https://[replicator]/api/1/profile/[action]/[name]/[listeningport]/[sendingport]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[action] add or update
[name] Name of the Profile to create or update
[listeningport] UDP port to listen to for incoming packets (In Port)
[sendingport] The UDP port to send packets from (Out Port)
Example request:
https://10.30.17.131/api/1/profile/add/myprofile/2055/4739
Example response:
{
    "description": "Success: Profile 'myprofile' has been added and enabled.",
    "result": "success"
}

Rebuild

Used to force the Plixer Replicator to immediately rebuild its internal configuration

Resource URL:

https://[replicator]/api/1/rebuild

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
Example request:
https://10.30.17.131/api/1/rebuild
Example response:
{
    "description": "rebuild request submitted",
    "result": "success"
}

Role

Used to test whether a secondary Plixer Replicator in a fault tolerant configuration has been configured correctly

Resource URL:

https://[replicator]/api/1/role/test/secondary

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
Example request:
https://10.30.17.131/api/1/role/test/secondary
Example response:
{
    "description": "!!! This replicator is the primary !!!",
    "result": "error"
}

Setting

Used to manage the Plixer Replicator’s global settings

Resource URL:

Sets the value for the specified setting

https://[replicator]/api/1/setting/set/[name]/[value]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[name] Exact name of the setting to modify
[value] New value for the setting specified
Example request:
https://10.30.17.131/api/1/setting/set/metricssent/10.1.2.3:2055
Example response:
{
    "description": "Success: setting 'metricssent' has been set to '10.1.2.3:2055'",
    "result": "success"
}
Resource URL:

Enables or disables the specified setting

https://[replicator]/api/1/setting/[action]/[name]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[action] enable or disable
[name] Exact name of the setting to modify
Example request:
https://10.30.17.131/api/1/setting/disable/metricssent
Example response:
{
    "description": "Success: setting 'metricssent' has been set to 'disable'",
    "result": "success"
}

Show

Displays configuration details and real-time information from the Plixer Replicator

Resource URL:

Displays the current configuration of the Plixer Replicator

https://[replicator]/api/1/show/config

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
Example request:
https://10.30.17.131/api/1/show/config
Example response:
{
 "api": {
  "collector": [
   "/api/1/collector/add/10.30.1.20/benchmark-20",
   ...
  ],
  "notate": [
   "/api/1/notate/ip/10.1.4.101/ej-win2012 install test machine (fresh)",
   ...
  ],
  "policy": [
   "/api/1/policies/add/10.1.1.252/32/buildqa/include",
   ...
  ],
  "profile": [
   "/api/1/profile/add/frandev/2002/2055",
   ...
  ]
 },
 "cli": {
  "collector": [
   "collector add 10.30.1.20 benchmark-20",
   ...
  ],
  "notate": [
   "notate ip 10.1.4.101 ej-win2012 install test machine (fresh)",
   ...
  ],
  "policy": [
   "policy add 10.1.1.252/32 buildqa include",
   ...
  ],
  "profile": [
   "profile add frandev 2002 2055",
   ...
  ]
 }
}
Resource URL:

Displays the current status of the Plixer Replicator

https://[replicator]/api/1/show/status

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
Example request:
https://10.30.17.131/api/1/show/status
Example response:
{
   "converting syslog" : "active",
   "ipfixify system metrics" : "active",
   "replicating port 2002" : "active",
   "replicating port 2003" : "active",
   "replicating port 2055" : "active",
   "replicator api" : "active",
   "replicator license" : "259 day(s)",
   "replicator monitor" : "active",
   "replicator vitalizer" : "active",
   "result" : "success",
   "version" : "v17.12.19.2255"
}
Resource URL:

Displays real-time data from the Plixer Replicator

https://[replicator]/api/1/show/realtime/[filter]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[filter] Currently not supported; defaults to full report if not provided
Example request:
https://10.30.17.131/api/1/show/realtime/0
Example response:
{
 "collector": {
  "10.1.4.19": {
   "in": {
    "octets": {
     "delta": 0,
     "rate": 0
    },
     "packets": {
     "delta": 0,
     "rate": 0
    }
   }
  },
  "10.1.4.20": {
   ...
  },
},
"exporter": {
 "10.30.17.131": {
  "awareness": {
   "last_epoch": 1461175921,
   "last_timestamp": "2016-04-20 14:12:01"
  },
  "in": {
   "octets": {
    "delta": 0,
    "rate": "0.0"
   },
   "packets": {
    "delta": 0,
    "rate": "0.0"
   }
  },
  "out": {
   "octets": {
    "delta": 0,
    "rate": "0.0"
   },
   "packets": {
    "delta": 0,
    "rate": "0.0"
   }
  },
  "profiles": [
   "benp"
  ]
 }
},
"pair": {
 "10.30.17.131 -> 10.1.4.19": {
  "octets": {
   "delta": 0,
   "rate": 0
  },
  "packets": {
   "delta": 0,
   "rate": 0
  }
 },
 "10.30.17.131 -> 10.1.4.20": {
  ...
 },
 "profile": {
  "benp": {
   "in": {
    "octets": {
     "delta": 0,
     "rate": 0
    },
    "packets": {
     "delta": 0,
     "rate": 0
    }
   },
   "out": {
    "octets": {
     "delta": 0,
     "rate": 0
    },
   "packets": {
    "delta": 0,
    "rate": 0
   }
  }
 }
},
"stats": {
 "totals": {
  "collectors": 2,
  "exporters": 1,
  "pairs": 2,
  "profiles": {
   "disabled": 3,
   "enabled": 67,
   "total": 70
  }
 }
},
"system": {
 "cpu": "0"
}
Resource URL:

Displays various configured information for the Plixer Replicator

https://[replicator]/api/1/show/[entity]/[filter]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[entity] alarms, assets, collectors, config, exporters, profile, realtime, settings, or status
[filter] Optional filter to apply to the output; defaults to the full report if not provided
Example request:
https://10.30.17.131/api/1/show/collector/10.1.10.1
Example response:
{
 "collector": {
  "10.1.10.1": {
   "acknowledged": [
    9996
   ],
   "description": "erpdev",
   "in_profiles": [
    "steady-replays"
   ],
   "ip": "10.1.10.1",
   "name": null,
   "status": {
    "unreachable_port": [
     "9996"
    ],
   }
   "threshold": 10000
  }
 }
}

Threshold

Used to set packet per second thresholds that will trigger warnings for Collectors

Resource URL:

https://[replicator]/api/1/collector/threshold/[collector]/[threshold]

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
[collector] IP address of the Collector
[threshold] Threshold value in packets per second; disabled if set to 0
Example request:
https://10.30.17.131/api/1/collector/threshold/10.1.5.2/10000
Example response:
{
  "description": "Success: Collector [10.1.5.2] threshold set to 10000",
  "result": "success"
}

Version

Used to display the Plixer Replicator’s version information

Resource URL:

https://[replicator]/api/1/version

Parameter Description
[replicator] Hostname or IP address of the Plixer Replicator
Example request:
https://10.30.17.131/api/1/version
Example response:
{
      "apiversion" : "1",
      "bestipfixcollector" : "Need an IPFIX Collector? Download Scrutinizer at https://www.plixer.com",
      "build" : "2019-12-03 13:07:44 -0500 (Tue, 03 Dec 2019)",
      "copyright" : "Copyright (C) 2012 - 2019 Plixer, All rights reserved.",
      "name" : "Plixer Replicator (TM) v18.14.1.2410 ",
      "result" : "success",
      "yeswecan" : "Replicate Anything!"
}