NAME

       anc-run-instance - provisions new Cloud Servers that will run on the Atlantic.Net Cloud.

DESCRIPTION

       anc-run-instance provisions new Cloud Servers that will run on the Atlantic.Net Cloud.

SYNOPSIS

       anc-run-instance   Format=[json|xml]  PlanName=[Plan]  ImageId=[Image  ID]  ServerName=[your-server-name]
       vm_location=[Server  Location]  [enablebackup=[Y  or  N]]]  [cloneimage=[name  of   server   to   clone]]
       [ServerQty=[amount]] [term=[term length]] [key_id=[ID of SSH key]]

       INPUT

       Format=[json|xml] - output format in either JSON or XML. Default is json

       PlanName=[Plan] - Determines the plan.

       ImageId=[Image ID] - An imageid taken from the anc-describe-images function.

       ServerName=[your-server-name]  -  A  string of text that will describe your server and also sets the host
       name of your server.

       vm_location=[Server Location] - Determines the physical location where  your  server  is  created.  Valid
       values  can  be  determined  by  referencing  the  location_code values as returned by the list-locations
       method.

       enablebackup=[Y or N] - Enables backup for the server if set to Y. If set  to  N,  backups  will  not  be
       enabled for the server. Valid values are Y or N.

       cloneimage=[name  of  server to clone] - The name of the image you wish you use as a clone to create your
       new server(s). E.g. 503408-243434345. This name can be obtained by calling  list-instance  and  selecting
       the  value  of  parameter vm_name. Please note this server that you would be choosing as a clone template
       would need to be "clonable"

       ServerQty=[amount] - The amount of servers requested to be provisioned. Defaults to a value of 1.

       term=[term length ] - The term you wish wish to select for your server(s). Valid  values  are  on-demand,
       1-year,  3-year.  term  defaults to a value of on-demand. Note that if you select a 1-year or 3-year term
       you may receive a discount as specified on our website and you will not be able  to  remove  your  server
       until the term has ended.

       key_id=[ID  of  SSH  key]  -  The  ID  of  the  SSH  Key  you  wish  to embed in your new server(s). E.g.
       yt9p4y64f7dem3e. This ID can be obtained by calling list-sshkeys and selecting  the  value  of  parameter
       key_id.

SEE ALSO

       https://www.atlantic.net/docs/api

AUTHOR

       Atlantic.Net Cloud Team - cloudsupport@atlantic.net