/AWS1/CL_LSA=>CREATEINSTANCES()
¶
About CreateInstances¶
Creates one or more Amazon Lightsail instances.
The create instances
operation supports tag-based access control via request
tags. For more information, see the Lightsail Developer Guide.
Method Signature¶
IMPORTING¶
Required arguments:¶
IT_INSTANCENAMES
TYPE /AWS1/CL_LSASTRINGLIST_W=>TT_STRINGLIST
TT_STRINGLIST
¶
The names to use for your new Lightsail instances. Separate multiple values using quotation marks and commas, for example:
["MyFirstInstance","MySecondInstance"]
IV_AVAILABILITYZONE
TYPE /AWS1/LSASTRING
/AWS1/LSASTRING
¶
The Availability Zone in which to create your instance. Use the following format:
us-east-2a
(case sensitive). You can get a list of Availability Zones by using the get regions operation. Be sure to add theinclude Availability Zones
parameter to your request.
IV_BLUEPRINTID
TYPE /AWS1/LSANONEMPTYSTRING
/AWS1/LSANONEMPTYSTRING
¶
The ID for a virtual private server image (
app_wordpress_x_x
orapp_lamp_x_x
). Use theget blueprints
operation to return a list of available images (or blueprints).Use active blueprints when creating new instances. Inactive blueprints are listed to support customers with existing instances and are not necessarily available to create new instances. Blueprints are marked inactive when they become outdated due to operating system updates or new application releases.
IV_BUNDLEID
TYPE /AWS1/LSANONEMPTYSTRING
/AWS1/LSANONEMPTYSTRING
¶
The bundle of specification information for your virtual private server (or instance), including the pricing plan (
medium_x_x
).
Optional arguments:¶
IV_CUSTOMIMAGENAME
TYPE /AWS1/LSARESOURCENAME
/AWS1/LSARESOURCENAME
¶
(Discontinued) The name for your custom image.
In releases prior to June 12, 2017, this parameter was ignored by the API. It is now discontinued.
IV_USERDATA
TYPE /AWS1/LSASTRING
/AWS1/LSASTRING
¶
A launch script you can create that configures a server with additional user data. For example, you might want to run
apt-get -y update
.Depending on the machine image you choose, the command to get software on your instance varies. Amazon Linux and CentOS use
yum
, Debian and Ubuntu useapt-get
, and FreeBSD usespkg
. For a complete list, see the Amazon Lightsail Developer Guide.
IV_KEYPAIRNAME
TYPE /AWS1/LSARESOURCENAME
/AWS1/LSARESOURCENAME
¶
The name of your key pair.
IT_TAGS
TYPE /AWS1/CL_LSATAG=>TT_TAGLIST
TT_TAGLIST
¶
The tag keys and optional values to add to the resource during create.
Use the
TagResource
action to tag a resource after it's created.
IT_ADDONS
TYPE /AWS1/CL_LSAADDONREQUEST=>TT_ADDONREQUESTLIST
TT_ADDONREQUESTLIST
¶
An array of objects representing the add-ons to enable for the new instance.
IV_IPADDRESSTYPE
TYPE /AWS1/LSAIPADDRESSTYPE
/AWS1/LSAIPADDRESSTYPE
¶
The IP address type for the instance.
The possible values are
ipv4
for IPv4 only,ipv6
for IPv6 only, anddualstack
for IPv4 and IPv6.The default value is
dualstack
.