Description


This function retrieves an account's statistics.


We strongly recommend that you use the following UAPI function instead of this function:


Examples




https://hostname.example.com:2087/cpsess###########/json-api/cpanel?cpanel_jsonapi_user=user&cpanel_jsonapi_apiversion=2&cpanel_jsonapi_module=StatsBar&cpanel_jsonapi_func=stat&display=ftpaccounts%7Cperlversion%7Cdedicatedip&warnings=0&warninglevel=high&warnout=0&infinityimg=/home/example/infinity.png&infinitylang="infinity"&rowcounter=even



$cpanel = new CPANEL(); // Connect to cPanel - only do this once.
 
//  Display stats bar data for ftpaccounts|perlversion|dedicatedip
$stats_bar = $cpanel->api2(
    'StatsBar', 'stat', 
    array(
        'display'      => 'ftpaccounts|perlversion|dedicatedip',
        'warnings'      => '0',
		'warninglevel	=> 'high'
		'warnout'		=> '0'
		'infinityimg'	=> '/home/example/infinity.png'
		'infinitylang'	=> 'infinity'
		'rowcounter'	=> 'even'
 ) 
);




my $cpliveapi = Cpanel::LiveAPI->new(); # Connect to cPanel - only do this once.
 
# Display stats bar data for ftpaccounts|perlversion|dedicatedip
my $stats_bar = $cpliveapi->api2(
    'StatsBar', 'stat',
    { 
        'display'      => 'ftpaccounts|perlversion|dedicatedip',
        'warnings'      => '0',
		'warninglevel	=> 'high'
		'warnout'		=> '0'
		'infinityimg'	=> '/home/example/infinity.png'
		'infinitylang'	=> 'infinity'
		'rowcounter'	=> 'even'
 }
);





cpapi2 --user=username StatsBar stat display=ftpaccounts%7Cperlversio%5C%7Cdedicatedip warnings=0 warninglevel=high warnout=0 infinityimg=\/home\/example\/infinity.png infinitylang=infinity rowcounter=even



{
  "cpanelresult": {
    "apiversion": 2,
    "func": "stat",
    "data": [
      {
        "zeroisunlimited": 0,
        "percent": 0,
        "percent10": 0,
        "max": "unlimited",
        "item": "FTP Accounts",
        "feature": "ftpaccts",
        "percent5": 0,
        "id": "ftpaccounts",
        "phrase": "FTP Accounts",
        "module": "API::Ftp",
        "count": "3",
        "_count": "3",
        "name": "ftpaccounts",
        "_max": "unlimited",
        "percent20": 0,
        "_maxed": 0
      },
      {
        "count": null,
        "value": "5.10.1",
        "percent": 0,
        "percent10": 0,
        "max": "",
        "item": "Perl Version",
        "name": "perlversion",
        "percent20": 0,
        "percent5": 0,
        "_maxed": 0,
        "id": "perlversion",
        "phrase": "Perl Version",
        "module": "Serverinfo"
      },
      {
        "count": null,
        "value": "10.215.214.95",
        "percent": 0,
        "percent10": 0,
        "max": "",
        "item": "Dedicated IP Address",
        "name": "dedicatedip",
        "percent20": 0,
        "percent5": 0,
        "_maxed": 0,
        "id": "dedicatedip",
        "phrase": "Dedicated IP Address",
        "condition": 1
      }
    ],
    "event": {
      "result": 1
    },
    "module": "StatsBar"
  }
}



Parameters

ParameterTypeDescriptionPossible valuesExample
displaystring

Required

A list of the account's statistics.


  • ftpaccounts — Information about the account's FTP accounts.
  • perlversion — The server's Perl version.
  • dedicatedip —  cPanel account websites that use dedicated IP addresses.
  • hostname — The server's hostname.
  • operatingsystem — The server's operating system
  • sendmailpath — The path to the system's sendmail binary.
  • autoresponders — Information about the cPanel account's auto-responders.
  • perlpath — The Perl binary's absolute oath.
  • emailforwarders — Information about the cPanel account's forwarders.
  • bandwidthusage — Information about the account's bandwidth usage.
  • emailfilters — Information the cPanel account's email filters.
  • mailinglists — Information the cPanel account's mailing lists.
  • diskusage — Information the account's disk space usage.
  • phpversion — The server's PHP version.
  • sqldatabases — Information about the account's SQL databases.
  • apacheversion — The server's Apache version.
  • kernelversion — The operating system's kernel version.
  • shorthostname — The short version of your server's hostname.
  • parkeddomains — Information about the cPanel account's parked domains (aliases).
  • cpanelbuild — The server's cPanel build.
  • theme — The cPanel account's theme.
  • addondomains — Information about the cPanel account's addon domains.
  • cpanelrevision — The build of cPanel that runs on the server.
  • machinetype — The type of operating system your server runs.
  • cpanelversion — The server's cPanel version.
  • mysqldiskusage — The amount of disk space that the cPanel account's MySQL® databases use.
  • mysqlversion — The server's MySQL version.
  • subdomains — Information about the cPanel account's subdomains.
  • postgresdiskusage — The amount of disk space that the cPanel account's PostgreSQL databases use.
  • sharedip — Any of the cPanel account's websites that use a shared IP address.
  • hostingpackage — The cPanel account's hosting package.
  • emailaccounts — Information about the cPanel account's email accounts.


Separate each value with a pipe character (|).


ftpaccounts|perlversion|dedicatedip
warningsBoolean

Required

Whether to return all results.

  • 1 — Return only warnings that exceed the warninglevel parameter's value.
  • 0 — Return all results.
0
warninglevelinteger

Required

The minimum level at which to return warnings.

A positive integer.87
warnoutBoolean

Required

Whether to display results with a value of 100%.

  • 1 — Display results with a value of 100%
  • 0 — Hide results with a value of 100%
0

infinityimg

string

Required

The full file path to an alternative infinity symbol.

An absolute file path to an image file./home/example/infinity.png
infinitylangstring

Required

A phrase represent infinity that the locales system can use.

A string value.infinity
rowcounterstring

Required

The type of row.

  • odd
  • even 
even

Returns

ReturnTypeDescriptionPossible valesExample
zeroisunlimitedBooleanWhether a value of 0 means unlimited or zero.
  • 1 — Unlimited.
  • 0 — Zero.
1
percent10integerThe percentage of value.

A positive integer.

Round to the nearest ten if applicable.


0
percentintegerThe percentage of value, if applicable.An integer value.0
itemstringA human-readable version of the queried item.A string value.Disk Space Usage
maxstringThe queried value's limit.A string value.unlimited
langkeystringThe value's display locale.A string value.INDXDiskUsage
percent5integerThe percentage of value.

An integer value.

Round to the nearest five if applicable.


0
idstringThe display key.A string value.diskusage
modulestringThe module that retrieved the information.A string value.Quota
countstringThe queried data's value.A string value.0.77
_countstringThe queried data's value.A string value.0.77
namestringThe display key.A string value.diskusage
_maxstringThe queried parameter's limit.A string value.unlimited
normalizedBooleanWhether the function normalized the output values.
  • 1 — Normalized.
  • 0 — Did not normalize.
1
_percent20integerThe percentage of value.

An integer value.

Round to the nearest twenty if applicable.


0
_maxedBooleanWhether the values reached their maximum value.
  • 1 — Reached maximum value.
  • 0 — Has not reached maximum value.
0
unitsstringThe queried value's unit of measure.A string value.MB