Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Paws::EC2::RunInstanceUser Contributed Perl DocumentPaws::EC2::RunInstances(3)

NAME
       Paws::EC2::RunInstances - Arguments for method RunInstances on
       Paws::EC2

DESCRIPTION
       This class represents the parameters used for calling the method
       RunInstances on the Amazon Elastic Compute Cloud	service. Use the
       attributes of this class	as arguments to	method RunInstances.

       You shouln't make instances of this class. Each attribute should	be
       used as a named argument	in the call to RunInstances.

       As an example:

	 $service_obj->RunInstances(Att1 => $value1, Att2 => $value2, ...);

       Values for attributes that are native types (Int, String, Float,	etc)
       can passed as-is	(scalar	values). Values	for complex Types (objects)
       can be passed as	a HashRef. The keys and	values of the hashref will be
       used to instance	the underlying object.

ATTRIBUTES
   AdditionalInfo => Str
       Reserved.

   BlockDeviceMappings => ArrayRef[Paws::EC2::BlockDeviceMapping]
       The block device	mapping.

   ClientToken => Str
       Unique, case-sensitive identifier you provide to	ensure the idempotency
       of the request. For more	information, see Ensuring Idempotency.

       Constraints: Maximum 64 ASCII characters

   DisableApiTermination => Bool
       If you set this parameter to "true", you	can't terminate	the instance
       using the Amazon	EC2 console, CLI, or API; otherwise, you can. If you
       set this	parameter to "true" and	then later want	to be able to
       terminate the instance, you must	first change the value of the
       "disableApiTermination" attribute to "false" using
       ModifyInstanceAttribute.	Alternatively, if you set
       "InstanceInitiatedShutdownBehavior" to "terminate", you can terminate
       the instance by running the shutdown command from the instance.

       Default:	"false"

   DryRun => Bool
       Checks whether you have the required permissions	for the	action,
       without actually	making the request, and	provides an error response. If
       you have	the required permissions, the error response is
       "DryRunOperation". Otherwise, it	is "UnauthorizedOperation".

   EbsOptimized	=> Bool
       Indicates whether the instance is optimized for EBS I/O.	This
       optimization provides dedicated throughput to Amazon EBS	and an
       optimized configuration stack to	provide	optimal	EBS I/O	performance.
       This optimization isn't available with all instance types. Additional
       usage charges apply when	using an EBS-optimized instance.

       Default:	"false"

   IamInstanceProfile => Paws::EC2::IamInstanceProfileSpecification
       The IAM instance	profile.

   REQUIRED ImageId => Str
       The ID of the AMI, which	you can	get by calling DescribeImages.

   InstanceInitiatedShutdownBehavior =>	Str
       Indicates whether an instance stops or terminates when you initiate
       shutdown	from the instance (using the operating system command for
       system shutdown).

       Default:	"stop"

   InstanceType	=> Str
       The instance type. For more information,	see Instance Types in the
       Amazon Elastic Compute Cloud User Guide.

       Default:	"m1.small"

   KernelId => Str
       The ID of the kernel.

       We recommend that you use PV-GRUB instead of kernels and	RAM disks. For
       more information, see PV-GRUB in	the Amazon Elastic Compute Cloud User
       Guide.

   KeyName => Str
       The name	of the key pair. You can create	a key pair using CreateKeyPair
       or ImportKeyPair.

       If you do not specify a key pair, you can't connect to the instance
       unless you choose an AMI	that is	configured to allow users another way
       to log in.

   REQUIRED MaxCount =>	Int
       The maximum number of instances to launch. If you specify more
       instances than Amazon EC2 can launch in the target Availability Zone,
       Amazon EC2 launches the largest possible	number of instances above
       "MinCount".

       Constraints: Between 1 and the maximum number you're allowed for	the
       specified instance type.	For more information about the default limits,
       and how to request an increase, see How many instances can I run	in
       Amazon EC2 in the Amazon	EC2 General FAQ.

   REQUIRED MinCount =>	Int
       The minimum number of instances to launch. If you specify a minimum
       that is more instances than Amazon EC2 can launch in the	target
       Availability Zone, Amazon EC2 launches no instances.

       Constraints: Between 1 and the maximum number you're allowed for	the
       specified instance type.	For more information about the default limits,
       and how to request an increase, see How many instances can I run	in
       Amazon EC2 in the Amazon	EC2 General FAQ.

   Monitoring => Paws::EC2::RunInstancesMonitoringEnabled
       The monitoring for the instance.

   NetworkInterfaces =>
       ArrayRef[Paws::EC2::InstanceNetworkInterfaceSpecification]
       One or more network interfaces.

   Placement =>	Paws::EC2::Placement
       The placement for the instance.

   PrivateIpAddress => Str
       [EC2-VPC] The primary IP	address. You must specify a value from the IP
       address range of	the subnet.

       Only one	private	IP address can be designated as	primary. Therefore,
       you can't specify this parameter	if "PrivateIpAddresses.n.Primary" is
       set to "true" and "PrivateIpAddresses.n.PrivateIpAddress" is set	to an
       IP address.

       Default:	We select an IP	address	from the IP address range of the
       subnet.

   RamdiskId =>	Str
       The ID of the RAM disk.

       We recommend that you use PV-GRUB instead of kernels and	RAM disks. For
       more information, see PV-GRUB in	the Amazon Elastic Compute Cloud User
       Guide.

   SecurityGroupIds => ArrayRef[Str]
       One or more security group IDs. You can create a	security group using
       CreateSecurityGroup.

       Default:	Amazon EC2 uses	the default security group.

   SecurityGroups => ArrayRef[Str]
       [EC2-Classic, default VPC] One or more security group names. For	a
       nondefault VPC, you must	use security group IDs instead.

       Default:	Amazon EC2 uses	the default security group.

   SubnetId => Str
       [EC2-VPC] The ID	of the subnet to launch	the instance into.

   UserData => Str
       The Base64-encoded MIME user data for the instances.

SEE ALSO
       This class forms	part of	Paws, documenting arguments for	method
       RunInstances in Paws::EC2

BUGS and CONTRIBUTIONS
       The source code is located here:	https://github.com/pplu/aws-sdk-perl

       Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues

perl v5.24.1			  2015-08-06	    Paws::EC2::RunInstances(3)

NAME | DESCRIPTION | ATTRIBUTES | SEE ALSO | BUGS and CONTRIBUTIONS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Paws::EC2::RunInstances&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help