Set a Reseller's ACL List — setacls

This function specifies the ACL for a reseller, or modifies specific ACL items for a reseller. (ACL lists can be found in the WHM interface on the Edit Privileges/Nameservers screen).

Calling Functions

Using the XML API

Using the JSON API

Variables

Note: Calling this API function without defining an ACL option will disable that ACL option; see the examples for more details.

Input

Required variable

• reseller (string) — The username of the reseller whose ACL list you wish to change.

Optional variables

• acllist (string) — Name of the ACL list.
  Note: This cannot be used with specific acl-x-x variables (below). You must either use an ACL list or a set of specific variables.

• To enable the variable, set it to 1.
• To disable the variable, do not include it in the URL.

• acl-add-pkg (boolean) — Allow the creation of packages.
• acl-add-pkg-ip (boolean) — Allow the creation of packages with dedicated IPs.
• acl-add-pkg-shell (boolean) — Allow the creation of packages with shell access
• acl-all (boolean) — All features. All features.
  Warning: Enabling this feature grants the user root access!
• acl-allow-addoncreate (boolean) — Allow the creation of packages with unlimited addon domains.
• acl-allow-parkedcreate (boolean) — Allow the creation of packages with parked domains.
• acl-allow-unlimited-disk-pkgs (boolean) — Allow the creation of packages with unlimited disk space.
• acl-allow-unlimited-pkgs (boolean) — Allow the creation of packages with unlimited bandwidth.
• acl-clustering (boolean) — Enable clustering.
• acl-create-acct (boolean) — Allow the creation of new accounts.
• acl-create-dns (boolean) — Enable the reseller to add DNS zones.
• acl-demo-setup (boolean) — Turn an account into a demo account.
• acl-disallow-shell (boolean) — Never allow creation of accounts with SSH access.
• acl-edit-account (boolean) — Allow the reseller to modify an account.
• acl-edit-dns (boolean) — Allow the reseller to edit DNS zones.
• acl-edit-mx (boolean) — Allow the reseller to edit MX entries.
• acl-frontpage (boolean) — Allow the reseller to install and uninstall FrontPage extensions.
• acl-kill-acct (boolean) — Allow the reseller to terminate an account.
• acl-kill-dns (boolean) — Allow the reseller to remove a DNS entry.
• acl-limit-bandwidth (boolean) — Allow the reseller to modify bandwidth limits.
  Warning: This will allow the reseller to circumvent package bandwidth limits if you are not using resource limits!
• acl-list-accts (boolean) — Allow the reseller to list accounts.
• acl-mailcheck (boolean) — Allow the reseller to access the WHM Mail Troubleshooter.
• acl-mod-subdomains (boolean) — Allow the reseller to enable and disable subdomains.
• acl-news (boolean) — Allow the reseller to modify the cPanel/WHM news.
• acl-onlyselfandglobalpkgs (boolean) — Prevent the creation of accounts with packages that are neither global nor owned by this user.
• acl-park-dns (boolean) — Allow the reseller to park domains.
• acl-passwd (boolean) — Allow the reseller to modify passwords.
• acl-quota (boolean) — Allow the reseller to modify disk quotas.
  Warning: This will allow resellers to circumvent package limits for disk space, if you are not using resource limits!
• acl-rearrange-accts (boolean) — Allow the reseller to rearrange accounts.
• acl-res-cart (boolean) — Allow the reseller to reset the shopping cart.
• acl-resftp (boolean) — Allow the reseller to synchronize FTP passwords.
• acl-restart (boolean) — Allow the reseller to restart services.
• acl-show-bandwidth (boolean) — Allow the reseller to view account bandwidth usage.
• acl-ssl (boolean) — Allow the reseller to access the SSL Manager.
• acl-ssl-buy (boolean) — Allow the reseller to purchase and install SSL certificates.
• acl-ssl-gencrt (boolean) — Allow the reseller to access the SSL CSR/CRT generator.
• acl-stats (boolean) — Allow the reseller to view account statistics.
• acl-status (boolean) — Allow the reseller to view the Service Status feature in WHM.
• acl-suspend-accts (boolean) — Allow the reseller to suspend accounts.
• acl-upgrade-account (boolean) — Allow the reseller to upgrade and downgrade accounts.

Output

Examples

XML API

<setacls>
      <result>
            <acls>suspend-acct</acls>
             <acls>viewglobalpackages</acls>
             <acls>resftp</acls>
             <acls>list-accts</acls>
             <acls>quota</acls>
             <acls>passwd</acls>
             <acls>ssl</acls>
             <status>1</status>
             <statusmsg>Reseller Acls Saved</statusmsg>
      </result>
</setacls>

<setacls>
     <result>
            <acls>ssl</acls>
            <acls>all</acls>
            <status>1</status>
            <statusmsg>Reseller Acls Saved</statusmsg>
      </result>
</setacls>

JSON API

{
   "result":[
      {
         "status":1,
         "statusmsg":"Reseller Acls Saved",
         "acls":[
            "kill-dns",
            "edit-dns",
            "edit-mx",
            "add-pkg",
            "suspend-acct",
            "ssl",
         ]
      }
   ]
}

{
   "result":[
      {
         "status":1,
         "statusmsg":"Reseller Acls Saved",
         "acls":[
            "ssl",
            "all"
         ]
      }
   ]
}