/AWS1/CL_LSA=>CREATEINSTANCESFROMSNAPSHOT()
¶
About CreateInstancesFromSnapshot¶
Creates one or more new instances from a manual or automatic snapshot of an instance.
The create instances from snapshot
operation supports tag-based access
control via request tags and resource tags applied to the resource identified by
instance snapshot name
. For more information, see the Amazon Lightsail Developer Guide.
Method Signature¶
IMPORTING¶
Required arguments:¶
IT_INSTANCENAMES
TYPE /AWS1/CL_LSASTRINGLIST_W=>TT_STRINGLIST
TT_STRINGLIST
¶
The names for your new instances.
IV_AVAILABILITYZONE
TYPE /AWS1/LSASTRING
/AWS1/LSASTRING
¶
The Availability Zone where you want to create your instances. Use the following formatting:
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_BUNDLEID
TYPE /AWS1/LSANONEMPTYSTRING
/AWS1/LSANONEMPTYSTRING
¶
The bundle of specification information for your virtual private server (or instance), including the pricing plan (
micro_x_x
).
Optional arguments:¶
IT_ATTACHEDDISKMAPPING
TYPE /AWS1/CL_LSADISKMAP=>TT_ATTACHEDDISKMAP
TT_ATTACHEDDISKMAP
¶
An object containing information about one or more disk mappings.
IV_INSTANCESNAPSHOTNAME
TYPE /AWS1/LSARESOURCENAME
/AWS1/LSARESOURCENAME
¶
The name of the instance snapshot on which you are basing your new instances. Use the get instance snapshots operation to return information about your existing snapshots.
Constraint:
This parameter cannot be defined together with the
source instance name
parameter. Theinstance snapshot name
andsource instance name
parameters are mutually exclusive.
IV_USERDATA
TYPE /AWS1/LSASTRING
/AWS1/LSASTRING
¶
You can create a launch script that configures a server with additional user data. For example,
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 for 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
.
IV_SOURCEINSTANCENAME
TYPE /AWS1/LSASTRING
/AWS1/LSASTRING
¶
The name of the source instance from which the source automatic snapshot was created.
Constraints:
This parameter cannot be defined together with the
instance snapshot name
parameter. Thesource instance name
andinstance snapshot name
parameters are mutually exclusive.Define this parameter only when creating a new instance from an automatic snapshot. For more information, see the Amazon Lightsail Developer Guide.
IV_RESTOREDATE
TYPE /AWS1/LSASTRING
/AWS1/LSASTRING
¶
The date of the automatic snapshot to use for the new instance. Use the
get auto snapshots
operation to identify the dates of the available automatic snapshots.Constraints:
Must be specified in
YYYY-MM-DD
format.This parameter cannot be defined together with the
use latest restorable auto snapshot
parameter. Therestore date
anduse latest restorable auto snapshot
parameters are mutually exclusive.Define this parameter only when creating a new instance from an automatic snapshot. For more information, see the Amazon Lightsail Developer Guide.
IV_USELATSTRESTORABLEAUTOS00
TYPE /AWS1/LSABOOLEAN
/AWS1/LSABOOLEAN
¶
A Boolean value to indicate whether to use the latest available automatic snapshot.
Constraints:
This parameter cannot be defined together with the
restore date
parameter. Theuse latest restorable auto snapshot
andrestore date
parameters are mutually exclusive.Define this parameter only when creating a new instance from an automatic snapshot. For more information, see the Amazon Lightsail Developer Guide.