Paws::EC2::AllocateHosts - Arguments for method AllocateHosts on Paws::EC2
This class represents the parameters used for calling the method AllocateHosts on the Amazon Elastic Compute Cloud service. Use the attributes of this class as arguments to method AllocateHosts.
You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to AllocateHosts.
my $ec2 = Paws->service('EC2'); my $AllocateHostsResult = $ec2->AllocateHosts( AvailabilityZone => 'MyString', Quantity => 1, AutoPlacement => 'on', # OPTIONAL ClientToken => 'MyString', # OPTIONAL HostRecovery => 'on', # OPTIONAL InstanceFamily => 'MyString', # OPTIONAL InstanceType => 'MyString', # OPTIONAL TagSpecifications => [ { ResourceType => 'client-vpn-endpoint' , # values: client-vpn-endpoint, customer-gateway, dedicated-host, dhcp-options, egress-only-internet-gateway, elastic-ip, elastic-gpu, export-image-task, export-instance-task, fleet, fpga-image, host-reservation, image, import-image-task, import-snapshot-task, instance, internet-gateway, key-pair, launch-template, local-gateway-route-table-vpc-association, natgateway, network-acl, network-interface, network-insights-analysis, network-insights-path, placement-group, reserved-instances, route-table, security-group, snapshot, spot-fleet-request, spot-instances-request, subnet, traffic-mirror-filter, traffic-mirror-session, traffic-mirror-target, transit-gateway, transit-gateway-attachment, transit-gateway-connect-peer, transit-gateway-multicast-domain, transit-gateway-route-table, volume, vpc, vpc-peering-connection, vpn-connection, vpn-gateway, vpc-flow-log; OPTIONAL Tags => [ { Key => 'MyString', Value => 'MyString', }, ... ], # OPTIONAL }, ... ], # OPTIONAL ); # Results: my $HostIds = $AllocateHostsResult->HostIds; # Returns a L<Paws::EC2::AllocateHostsResult> object.
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. For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/ec2/AllocateHosts
Indicates whether the host accepts any untargeted instance launches that match its instance type configuration, or if it only accepts Host tenancy instance launches that specify its unique host ID. For more information, see Understanding auto-placement and affinity (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-dedicated-hosts-work.html#dedicated-hosts-understanding) in the Amazon EC2 User Guide.
Default: on
on
Valid values are: "on", "off"
"on"
"off"
The Availability Zone in which to allocate the Dedicated Host.
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html).
Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default. For more information, see Host recovery (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/dedicated-hosts-recovery.html) in the Amazon EC2 User Guide.
Default: off
off
Specifies the instance family to be supported by the Dedicated Hosts. If you specify an instance family, the Dedicated Hosts support multiple instance types within that instance family.
If you want the Dedicated Hosts to support a specific instance type only, omit this parameter and specify InstanceType instead. You cannot specify InstanceFamily and InstanceType in the same request.
Specifies the instance type to be supported by the Dedicated Hosts. If you specify an instance type, the Dedicated Hosts support instances of the specified instance type only.
If you want the Dedicated Hosts to support multiple instance types in a specific instance family, omit this parameter and specify InstanceFamily instead. You cannot specify InstanceType and InstanceFamily in the same request.
The number of Dedicated Hosts to allocate to your account with these parameters.
The tags to apply to the Dedicated Host during creation.
This class forms part of Paws, documenting arguments for method AllocateHosts in Paws::EC2
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
To install Paws, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Paws
CPAN shell
perl -MCPAN -e shell install Paws
For more information on module installation, please visit the detailed CPAN module installation guide.