• WHM API 1

     
    Skip to end of metadata
     
    Go to start of metadata
     

    Overview

    This page contains the input variables, output variables, and examples in JSON and XML output formats for the createacct function.

    The createacct function creates a hosting account and sets up its associated domain information.

    Note

    Icon
    For help on how to use this function, read the tutorial page on how to call WHM API 1 Functions.

    Parameters

    InputTypeDescription
    username string

    The username for the account that you wish to create (for example, username).

    Note

    Icon
    Usernames must be eight characters or less, or, as of cPanel & WHM version 11.40, 16 characters or less if database prefixes are disabled. Also, usernames cannot start with a number, or the string test.
    domain string The domain name to assign to the account (for example, example.com).
    plan string The package that you wish to apply to the new account (for example, reseller_gold).
    pkgname string The name of a new package to be created based on the settings used (for example, reseller_new).
    savepkg boolean This value determines whether to save the settings as a new package. A value of 1 will save the settings as a new package.
    featurelist string The name of the feature list to be used when you create a new package (for example, no_ftp_100mb_gold).
    quota integer The disk space quota, in megabytes. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited.
    password string The password that you wish to assign to the new account (for example, p@ss!w0rd$123).
    ip string This value determines whether the domain has a dedicated IP address. A value of y will flag the domain for a dedicated IP address.
    cgi boolean This value determines whether the domain has CGI access. A value of 1 grants the domain CGI access.
    frontpage boolean

    This value determines whether the domain can install FrontPage extensions. A value of 1 allows FrontPage extensions to be installed.

    Note:

    Icon

    cPanel & WHM will ignore all Microsoft® FrontPage® settings and parameters if either of the following statements are true:

    • Your server runs cPanel & WHM version 11.44 and FrontPage extensions are not installed on your server.
    • Your server runs cPanel & WHM version 11.46 or later.
    dkim (optional) boolean

    This value determines whether the domain has DKIM enabled. A value of 1 enables DKIM.

    Note:

    Icon

    This parameter does not follow the Enable DKIM on domains for newly created accounts setting in WHM'sTweak Settings interface (Home >> System Configuration >> Tweak Settings). If you wish to enable DKIM on this newly-created domain, set this parameter to a value of 1.
    spf (optional) boolean

    This value determines whether the domain has SPF enabled. A value of 1 enables SPF.

    Note:

    Icon

    This parameter does not follow the Enable SPF on domains for newly created accounts setting in WHM's Tweak Settings interface (Home >> System Configuration >> Tweak Settings). If you wish to enable SPF on this newly-created domain, set this parameter to a value of 1.
    hasshell boolean This value determines whether the domain has shell (SSH) access. A value of 1 grants shell access to the domain.
    contactemail string Contact email address for the account (for example, user@example.com).
    cpmod string

    The name of the cPanel theme that is assigned to the domain (for example: x3).

    Note

    Icon
    If no value is provided, the function will use the cPanel default theme (set in WHM in the Basic cPanel & WHM Setup interface). This behavior only applies to version 11.36+.
    maxftp string The maximum number of FTP accounts that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
    maxsql string The maximum number of SQL databases that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
    maxpop string The maximum number of email accounts that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
    maxlst string The maximum number of mailing lists that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
    maxsub string The maximum number of subdomains that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
    maxpark string The maximum number of parked domains that the user can create. Allowed values are: a number from 0 to 999999where a value of 0 is unlimited, unlimited, and null.
    maxaddon string The maximum number of addon domains that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
    bwlimit string The bandwidth limit, in megabytes. This value must be a number from 0 to 999999, where a value of 0 is unlimited.
    customip string This value specifies an IP address for the site.
    language string The language that you wish for the new account to use in the cPanel interface (for example, spanish-utf8).
    useregns boolean This value determines whether the domain will use the registered nameservers for the domain instead of the ones configured on the server. A value of 1 will use the registered nameservers for the domain.
    hasuseregns boolean If you set useregns to 1, you must set this value to 1.
    reseller boolean This value determines whether you wish to grant reseller privileges to the account. A value of 1 will grant reseller privileges to the account.
    forcedns boolean This value will overwrite an existing DNS Zone with this new account's information if one already exists. A value of 1 will overwrite an existing DNS zone with this new account's information.
    mxcheck string

    Determines how the server will handle incoming mail for this domain. This variable can be set to one of the following:
    local — The domain will accept mail, regardless of whether a higher-priority mail exchanger has been designated on the WHM Edit MX Entry interface. (If a higher-priority mail exchanger exists, mail will be routed to both domains.)
    secondary (or backup) — The domain will act as a backup mail exchanger, and it will hold mail in queue if the primary exchanger becomes unavailable.

    Note

    Icon
    You will still need to use the WHM Edit MX Entry interface to configure the primary MX entry to point to the appropriate exchanger.


    remote — The domain will not accept mail, instead sending it to the primary mail exchanger. Note: You will still need to use the WHM Edit MX Entry interface to configure the primary MX entry to point to the appropriate exchanger.
    auto — The server will automatically detect, and use, the configuration set on the WHM Edit MX Entry interface.
     MAX_EMAIL_PER_HOUR integer

    The maximum number of emails the account can send in an hour. This parameter's default value is unlimited. A value of0 will result in an unlimited value.

    Note

    Icon
    This variable is only accepted in cPanel & WHM Version 11.32 and later.
     MAX_DEFER_FAIL_PERCENTAGE integer

    The percentage of failed or deferred email messages the account can send per hour before outgoing mail is rate-limited. This parameter's default value is unlimited.

    Note

    Icon
    This variable is only accepted in cPanel & WHM Version 11.32 and later.
     uid string

    The user ID for a new account. This must be a numeral, not already associated with disk usage, and does not pre-exist on the machine. You must be logged in as the root user.

    Note

    Icon
    This variable is only accepted in cPanel & WHM Version 11.32 and later.
     gid string

    The group ID for a new account. This must be a numeral, not already associated with disk usage, and does not pre-exist on the machine. You must be logged in as the root user.

    Note

    Icon
    This variable is only accepted in cPanel & WHM Version 11.34 and later.
     homedir string

    The home directory (HOMEDIR) to be used for a new account. You must be logged in as the root user (for example:/home/johndoe).

    Note

    Icon
    This variable is only accepted in cPanel & WHM Version 11.34 and later.
    OutputTypeDescription
    createacct The container for the results from the createacct function.
    result The container for the results of the function.
    options The container for the domain options.
    ip string IP address with which the the domain is associated (for example, 123.456.789.10).
    nameserverX string The nameserver for the domain. The property of nameserver may be appended by an integer (x) between 1 and 5 (for example: nameserver1).
    nameserveraX string IP address of the nameserver. The property of nameservera may be appended by an integer (x) between 1 and 5 (for example: nameservera1).
    nameserverentryX string DNS name of the nameservers the namerservers are registered. The property of nameserverentry may appear appended by an integer (x) between 1 and 5 (for example: nameserverentry1).
    rawout string Raw output of the account creation operation in HTML format.

    Examples

    JSON
    Input URL

    https://hostname:2087/cpsess########/json-api/createacct
    Output
    {
       "result":[
          {
             "status":1,
             "statusmsg":"Account Creation Ok",
             "rawout":"<table style="border- bottom: 1px #ccc dotted;"><tr><td width="100%"> <pre>Checking input data...System has 2 free ips. ...Done</pre></td><td width="30"> <img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td> </tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"> <pre>WWWAcct 12.1.0 (c) 1997-2008 cPanel, Inc.... Dns Zone check is enabled. +===================================+ | New Account Info | +===================================+ | Domain: example.com | Ip: 127.0.0.1 (n) | HasCgi: y | UserName: user123 | PassWord: h@rd2gu3ss!p@ss | CpanelMod: x3 | HomeRoot: /home | Quota: 0 Meg | NameServer1: ns1.example.net | NameServer2: ns2.example.net | NameServer3: ns1.example.com | NameServer4: ns2.example.com | Contact Email: | Package: level3== | Feature List: default | Language: english +===================================+ ...Done</pre> </td><td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"> </td></tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"><pre>Running pre creation script (/scripts/prewwwacct)......Done</pre></td><td width="30"><img align=absmiddlesrc="/cPanel_magic_revision_ 1181098607/icons/good.gif"> </td></tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr> <td width="100%"><pre>Adding User...Removing Shell Access (n) ...Done</pre> </td><td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"> </td></tr></table> <table style="border-bottom: 1px #ccc dotted;"> <tr><td width="100%"><pre>Copying skel files from /root/cpanel3-skel/ to /home/user123/......Done</pre></td><td width="30"> <img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td></tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"><pre>Adding Entries to httpd.conf......Done</pre></td><td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td></tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"><pre>Setting up Mail & Local Domains...localdomains...valiases ...vdomainaliases...vfilters......Done</pre></td> <td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td></tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"><pre>Configuring DNS...Bind reconfiguring on publicdocs using rndc ...Done</pre></td><td width="30"> <img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td></tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"><pre>Restarting apache......Done</pre></td><td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td></tr></table> Changing password for user123 Password for user123 has been changed <table style="border- bottom: 1px #ccc dotted;"><tr><td width="100%"><pre>Updating Authentication Databases...Updating ftp passwords for user123 Ftp password files updated. Ftp vhost passwords synced ...Done</pre></td><td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"> </td></tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"><pre>Verifying MX Records and Setting up Databases......Done</pre></td><td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"> </td></tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"><pre>Setting up Proxy Subdomains......Done</pre></td><td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td></tr></table> Bind reloading on publicdocs using rndc zone: [example.com] <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"><pre>Sending Account Information......Done</pre></td><td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td> </tr></table> System has 2 free ips. <table style="border-bottom: 1px #ccc dotted;"> <tr><td width="100%"><pre>Running post creation scripts (/scripts/legacypostwwwacct, /scripts/postwwwacct, /scripts/postwwwacctuser)......Done</pre></td><td width="30"> <img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td></tr> </table> wwwacct creation finished <table style="border-bottom: 1px #ccc dotted;"> <tr><td width="100%"><pre>Setting up Domain Pointers......Done</pre></td><td width="30"> <img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td></tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"> <pre>Setting Reseller Privs......Done</pre></td><td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td></tr></table> <table style="border-bottom: 1px #ccc dotted;"><tr><td width="100%"><pre>Account Creation Complete!!!...Account Creation Ok...Done</pre></td><td width="30"><img align=absmiddle src="/cPanel_magic_revision_1181098607/icons/good.gif"></td></tr></table> ", "options":{ "nameserver4":"ns2.example.com", "nameserver":"ns1.example.net", "nameserverentry2":null, "nameserverentry3":null, "nameserverentry4":null, "nameserverentry":null, "ip":"127.0.0.1", "nameservera2":null, "nameservera3":null, "package":"level3==", "nameservera4":null, "nameserver2":"ns2.cpanelrocks.net", "nameservera":null, "nameserver3":"ns1.example.com" }
     }
     ]
    }
    XML
    Input URL

    https://hostname:2087/cpsess########/xml-api/createacct
    Output
    <createacct>
         <result>       
              <options>
                      <ip>192.168.0.20</ip>
                      <nameserver>ns1.domain.tld</nameserver>
                      <nameserver2>ns2.domain.tld</nameserver2>
                      <nameserver3/>
                      <nameserver4/>
                      <nameservera/>
                      <nameservera2/>
                      <nameservera3/>
                      <nameservera4/>
                      <nameserverentry/>
                      <nameserverentry2/>
                      <nameserverentry3/>
                      <nameserverentry4/>
                      <package>basic</package>
               </options>
               <rawout>
    Checking input data...The ProFTPd configuration file /etc/proftpd.conf appears to be ok!
    System has 0 free ips.
    ...Done
     
    WWWAcct 12.1.0 (c) 1997-2008 cPanel, Inc....
     
    Dns Zone check is enabled.
    +===================================+
    | New Account Info                  |
    +===================================+
    | Domain: domain.tld
    | Ip: 192.168.0.20 (n)
    | HasCgi: y
    | UserName: myuser
    | PassWord: h@rd2gu3ss!p@ss
    | CpanelMod: x3
    | HomeRoot: /home
    | Quota: 0 Meg
    | NameServer1: ns1.example.com
    | NameServer2: ns2.example.com
    | NameServer3: ns1.domain.com
    | NameServer4:
    | Contact Email: username@domain.tld
    | Package: basic
    | Feature List: default
    | Language: english
    +===================================+
    ...Done
     
    Running pre creation script (/scripts/prewwwacct)......Done
    Adding User...Removing Shell Access (n)
    ...Done
    Copying skel files from /root/cpanel3-skel/ to /home/myuser/......Done
    Adding Entries to httpd.conf......Done
    Setting up Mail and Local Domains...localdomains...
    valiases ...vdomainaliases...vfilters......Done
    Configuring DNS...Bind reconfiguring on server1 using rndc
    ...Done
    Restarting apache......Done
    Changing password for myuser Password for myuser has been changed
    Updating Authentication Databases...Updating ftp passwords for myuser
    Ftp password files updated.
    Ftp vhost passwords synced
    ...Done
    Verifying MX Records and Setting up Databases......Done
    Setting up Proxy Subdomains......Done
    Bind reloading on server1 using rndc zone: [domain.tld]
    Sending Account Information......Done
    System has 0 free ips.
    Running post creation scripts (/scripts/legacypostwwwacct,
    /scripts/postwwwacct, /scripts/postwwwacctuser)......Done
    wwwacct creation finished
    Setting up Domain Pointers......Done
    Setting Reseller Privs......Done
    Account Creation Complete!!!...Account Creation Ok...Done
                </rawout>
                <status>1</status>
                <statusmsg>Account Creation Ok</statusmsg>
         </result>
    </createacct>
  • 相关阅读:
    1. Java基础知识
    2. HelloWorld
    3. Java基础语法
    4. Java流程控制
    设计一个有getMin功能的栈
    ASP.NET中Cookies的使用
    用sql语句建表
    Eclipse “cannot be resolved to a type” 错误
    使用java连接sqlserver2008 R2/sqlserver2008
    使用java连接MySQL数据库
  • 原文地址：https://www.cnblogs.com/alex-13/p/4153246.html
Copyright © 2020-2023  润新知