Child pages
  • WHM API 1 Functions - get_appconfig_application_list
Skip to end of metadata
Go to start of metadata

 

Description

This function lists registered AppConfig applications.

Examples 


 JSON API
https://hostname.example.com:2087/cpsess##########/json-api/get_appconfig_application_list?api.version=1
 XML API
https://hostname.example.com:2087/cpsess##########/xml-api/get_appconfig_application_list?api.version=1
 Command Line
whmapi1 get_appconfig_application_list


Notes:

  • You must URI-encode values.
  • For more information and additional output options, read our Guide to WHM API 1 documentation or run the whmapi1 --help command. 
  • We introduced this functionality in cPanel & WHM version 11.52.0.8.

 Output (JSON)
{
  "data": {
    "whostmgr": [
      {
        "acls": [
          "all"
        ],
        "name": "internal_phpmyadmin",
        "phpConfig": "phpmyadmin",
        "user": "cpanelphpmyadmin",
        "url": "/3rdparty/phpMyAdmin"
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_cpaddons_root",
        "user": "root",
        "url": [
          "/cgi/cpaddons.pl",
          "/cgi/cpaddons_report.pl"
        ]
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_dnsclustering_root",
        "user": "root",
        "url": [
          "/cgi/adjustclusterdns.cgi",
          "/cgi/adjustclusteroptions.cgi"
        ]
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_cloudlinux",
        "user": "root",
        "url": "/cgi/CloudLinux.cgi"
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_diskusage",
        "user": "root",
        "url": "/cgi/diskusage.cgi"
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_eximconfig",
        "user": "root",
        "url": [
          "/cgi/mailflow.cgi",
          "/cgi/addrbl.cgi"
        ]
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_stats",
        "user": "root",
        "url": "/cgi/statmanager.cgi"
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_hostaccess",
        "user": "root",
        "url": "/cgi/hostaccess.cgi"
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_easyapache",
        "user": "root",
        "url": "/cgi/easyapache.pl"
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_logrotation",
        "user": "root",
        "url": [
          "/cgi/cpanel_log_rotation.pl",
          "/cgi/apache_log_rotation.pl"
        ]
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_cphulkd",
        "user": "root",
        "url": [
          "/cgi/tweakcphulk.cgi",
          "/cgi/cphulkdblk.cgi",
          "/cgi/cphulkdwhitelist.cgi",
          "/cgi/bl.cgi",
          "/cgi/wl.cgi"
        ]
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_transfers",
        "user": "root",
        "url": [
          "/cgi/live_restart_xferlog_tail.cgi",
          "/cgi/sshcheck.cgi"
        ]
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_update",
        "user": "root",
        "url": "/cgi/live_upcp2.cgi"
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_compat",
        "user": "root",
        "url": "/cgi/parseform.pl"
      },
      {
        "acls": [
          "all"
        ],
        "name": "internal_ssh_key_manage",
        "user": "root",
        "url": "/backend/puttykey.cgi"
      },
      {
        "acls": [
          "clustering"
        ],
        "name": "internal_dns_clustering",
        "user": "root",
        "url": [
          "/cgi/activate_remote_nameservers.cgi",
          "/cgi/adjustuniquedns.cgi",
          "/cgi/configure_remote_nameserver.cgi",
          "/cgi/enableclusterserver.cgi",
          "/cgi/clusterstatus.cgi",
          "/cgi/remclusterserver.cgi",
          "/cgi/changeclusterdns.cgi",
          "/cgi/trustclustermaster.cgi"
        ]
      },
      {
        "acls": [
          "create-acct"
        ],
        "name": "internal_account_creation",
        "user": "root",
        "url": "/cgi/mysqluser.cgi"
      },
      {
        "acls": [
          "locale-edit"
        ],
        "name": "internal_locale",
        "user": "root",
        "url": [
          "/cgi/ajax_maketext_syntax_util.pl",
          "/cgi/ajax_locale_delete_local_key.pl",
          "/cgi/build_locale_databases.pl",
          "/cgi/locale_duplicate.cgi"
        ]
      },
      {
        "acls": [
          "mailcheck"
        ],
        "name": "internal_mail_troubleshooter",
        "user": "root",
        "url": "/cgi/traceaddy.cgi"
      },
      {
        "acls": [
          "edit-dns"
        ],
        "user": "root",
        "name": "internal_zoneeditor",
        "url": [
          "/cgi/zoneeditor.cgi.pl",
          "/cgi/zoneeditor.cgi"
        ]
      },
      {
        "acls": [
          "any"
        ],
        "name": "internal_changelog",
        "user": "root",
        "url": "/cgi/changelog.cgi"
      },
      {
        "acls": [
          "any"
        ],
        "name": "internal_branding",
        "user": "root",
        "url": "/cgi/brandingimage.cgi"
      },
      {
        "acls": [
          "any"
        ],
        "name": "internal_cpaddons",
        "user": "root",
        "url": "/cgi/cpaddons_feature.pl"
      },
      {
        "acls": [
          "any"
        ],
        "name": "internal_passwordstrength",
        "user": "root",
        "url": [
          "/backend/passwordstrength.cgi",
          "/cgi/passwordstrength.cgi"
        ]
      }
    ],
    "webmail": [
      {
        "features": [
          "webmail"
        ],
        "name": "horde",
        "phpConfig": "horde",
        "user": "cpanelhorde",
        "url": "/horde/"
      },
      {
        "features": [
          "webmail"
        ],
        "name": "roundcube",
        "phpConfig": "roundcube",
        "user": "cpanelroundcube",
        "url": "/3rdparty/roundcube/"
      }
    ],
    "cpanel": [
      {
        "features": [
          "webmail"
        ],
        "name": "horde",
        "phpConfig": "horde",
        "user": "cpanelhorde",
        "url": "/horde/"
      },
      {
        "features": [
          "webmail"
        ],
        "name": "roundcube",
        "phpConfig": "roundcube",
        "user": "cpanelroundcube",
        "url": "/3rdparty/roundcube/"
      },
      {
        "features": [
          "phppgadmin"
        ],
        "name": "phppgadmin",
        "phpConfig": "phppgadmin",
        "user": "cpanelphppgadmin",
        "url": "/3rdparty/phpPgAdmin"
      },
    ]
  },
  "metadata": {
    "version": 1,
    "reason": "Got application list",
    "result": 1,
    "command": "get_appconfig_application_list"
  }
}

 Output (XML)
<result>
    <data>
        <whostmgr>
            <acls>all</acls>
            <name>internal_phpmyadmin</name>
            <phpConfig>phpmyadmin</phpConfig>
            <user>cpanelphpmyadmin</user>
            <url>/3rdparty/phpMyAdmin</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_cpaddons_root</name>
            <user>root</user>
            <url>/cgi/cpaddons.pl</url>
            <url>/cgi/cpaddons_report.pl</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_dnsclustering_root</name>
            <user>root</user>
            <url>/cgi/adjustclusterdns.cgi</url>
            <url>/cgi/adjustclusteroptions.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_cloudlinux</name>
            <user>root</user>
            <url>/cgi/CloudLinux.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_diskusage</name>
            <user>root</user>
            <url>/cgi/diskusage.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_eximconfig</name>
            <user>root</user>
            <url>/cgi/mailflow.cgi</url>
            <url>/cgi/addrbl.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_stats</name>
            <user>root</user>
            <url>/cgi/statmanager.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_hostaccess</name>
            <user>root</user>
            <url>/cgi/hostaccess.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_easyapache</name>
            <user>root</user>
            <url>/cgi/easyapache.pl</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_logrotation</name>
            <user>root</user>
            <url>/cgi/cpanel_log_rotation.pl</url>
            <url>/cgi/apache_log_rotation.pl</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_cphulkd</name>
            <user>root</user>
            <url>/cgi/tweakcphulk.cgi</url>
            <url>/cgi/cphulkdblk.cgi</url>
            <url>/cgi/cphulkdwhitelist.cgi</url>
            <url>/cgi/bl.cgi</url>
            <url>/cgi/wl.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_transfers</name>
            <user>root</user>
            <url>/cgi/live_restart_xferlog_tail.cgi</url>
            <url>/cgi/sshcheck.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_update</name>
            <user>root</user>
            <url>/cgi/live_upcp2.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_compat</name>
            <user>root</user>
            <url>/cgi/parseform.pl</url>
        </whostmgr>
        <whostmgr>
            <acls>all</acls>
            <name>internal_ssh_key_manage</name>
            <user>root</user>
            <url>/backend/puttykey.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>clustering</acls>
            <name>internal_dns_clustering</name>
            <user>root</user>
            <url>/cgi/activate_remote_nameservers.cgi</url>
            <url>/cgi/adjustuniquedns.cgi</url>
            <url>/cgi/configure_remote_nameserver.cgi</url>
            <url>/cgi/enableclusterserver.cgi</url>
            <url>/cgi/clusterstatus.cgi</url>
            <url>/cgi/remclusterserver.cgi</url>
            <url>/cgi/changeclusterdns.cgi</url>
            <url>/cgi/trustclustermaster.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>create-acct</acls>
            <name>internal_account_creation</name>
            <user>root</user>
            <url>/cgi/mysqluser.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>locale-edit</acls>
            <name>internal_locale</name>
            <user>root</user>
            <url>/cgi/ajax_maketext_syntax_util.pl</url>
            <url>/cgi/ajax_locale_delete_local_key.pl</url>
            <url>/cgi/build_locale_databases.pl</url>
            <url>/cgi/locale_duplicate.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>mailcheck</acls>
            <name>internal_mail_troubleshooter</name>
            <user>root</user>
            <url>/cgi/traceaddy.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>edit-dns</acls>
            <user>root</user>
            <name>internal_zoneeditor</name>
            <url>/cgi/zoneeditor.cgi.pl</url>
            <url>/cgi/zoneeditor.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>any</acls>
            <name>internal_changelog</name>
            <user>root</user>
            <url>/cgi/changelog.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>any</acls>
            <name>internal_branding</name>
            <user>root</user>
            <url>/cgi/brandingimage.cgi</url>
        </whostmgr>
        <whostmgr>
            <acls>any</acls>
            <name>internal_cpaddons</name>
            <user>root</user>
            <url>/cgi/cpaddons_feature.pl</url>
        </whostmgr>
        <whostmgr>
            <acls>any</acls>
            <name>internal_passwordstrength</name>
            <user>root</user>
            <url>/backend/passwordstrength.cgi</url>
            <url>/cgi/passwordstrength.cgi</url>
        </whostmgr>
        <webmail>
            <features>webmail</features>
            <name>horde</name>
            <phpConfig>horde</phpConfig>
            <user>cpanelhorde</user>
            <url>/horde/</url>
        </webmail>
        <webmail>
            <features>webmail</features>
            <name>roundcube</name>
            <phpConfig>roundcube</phpConfig>
            <user>cpanelroundcube</user>
            <url>/3rdparty/roundcube/</url>
        </webmail>
        <cpanel>
            <features>webmail</features>
            <name>horde</name>
            <phpConfig>horde</phpConfig>
            <user>cpanelhorde</user>
            <url>/horde/</url>
        </cpanel>
        <cpanel>
            <features>webmail</features>
            <name>roundcube</name>
            <phpConfig>roundcube</phpConfig>
            <user>cpanelroundcube</user>
            <url>/3rdparty/roundcube/</url>
        </cpanel>
        <cpanel>
            <features>phppgadmin</features>
            <name>phppgadmin</name>
            <phpConfig>phppgadmin</phpConfig>
            <user>cpanelphppgadmin</user>
            <url>/3rdparty/phpPgAdmin</url>
        </cpanel>
    </data>
    <metadata>
        <version>1</version>
        <reason>Got application list</reason>
        <result>1</result>
        <command>get_appconfig_application_list</command>
    </metadata>
</result>


Note:

Use WHM's API Shell interface (WHM >> Home >> Development >> API Shell) to directly test WHM API calls.

   

Parameters

This function does not accept parameters.

Returns

ReturnTypeDescriptionPossible valuesExample
service_namearray of hashes

An array of hashes of the application's values.

The service name is the return's name.

This hash includes the name, user, url, phpConfig, upgradecall, icon, displayname, and entryurl, returns, and the acls and features arrays.

 

acls

array

The ACL(s) with permission to run the application.

The function returns this array in the service_name hash.

A list of valid strings.
any

name

string

The application's name.

The function returns this value in the service_name hash.

A valid string.
roundcube

user

string

The application's username.

The function returns this value in the service_name hash.

A valid username.
roundcube

url

string

The application's URL path.

The function returns this value in the service_name hash.

A valid filepath.
/3rdparty/roundcube

phpConfig

string

The application's php.ini file.

The function returns this value in the service_name hash.

A valid filepath, relative to the /usr/local/cpanel/3rdparty/etc/ directory.
roundcube

upgradecall

string

The path to the application's upgrade script.

The function returns this value in the service_name hash.

A valid absolute filepath.

Note:

The system passes upgrade information in the following format: /usr/local/youraddon/bin/upgrade 11.36.0.0 11.38.0.0+

/usr/local/roundcube/bin/upgrade
              

icon

string

The application's icon file.

The function returns this value in the service_name hash.

A valid filename.

Note:

Icon files exist in the /usr/local/cpanel/whostmgr/docroot/addon_plugins/ directory.
roundcube.ico

displayname

string

The application's WHM display label.

The function returns this value in the service_name hash.

A valid string.Roundcube

entryurl

string

The application's WHM entry path.

The function returns this value in the service_name hash.

A valid filepath.
roundcube/

features

array

The required features to run the application.

The function returns this array in the service_name hash.

A list of valid strings.
roundcube