NAME

Paws::EC2::PurchaseHostReservation - Arguments for method PurchaseHostReservation on Paws::EC2

DESCRIPTION

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

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

SYNOPSIS

my $ec2 = Paws->service('EC2');
my $PurchaseHostReservationResult = $ec2->PurchaseHostReservation(
  HostIdSet         => [ 'MyDedicatedHostId', ... ],
  OfferingId        => 'MyOfferingId',
  ClientToken       => 'MyString',                     # OPTIONAL
  CurrencyCode      => 'USD',                          # OPTIONAL
  LimitPrice        => '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 $ClientToken       = $PurchaseHostReservationResult->ClientToken;
my $CurrencyCode      = $PurchaseHostReservationResult->CurrencyCode;
my $Purchase          = $PurchaseHostReservationResult->Purchase;
my $TotalHourlyPrice  = $PurchaseHostReservationResult->TotalHourlyPrice;
my $TotalUpfrontPrice = $PurchaseHostReservationResult->TotalUpfrontPrice;

# Returns a L<Paws::EC2::PurchaseHostReservationResult> 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/PurchaseHostReservation

ATTRIBUTES

ClientToken => Str

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).

CurrencyCode => Str

The currency in which the totalUpfrontPrice, LimitPrice, and totalHourlyPrice amounts are specified. At this time, the only supported currency is USD.

Valid values are: "USD"

REQUIRED HostIdSet => ArrayRef[Str|Undef]

The IDs of the Dedicated Hosts with which the reservation will be associated.

LimitPrice => Str

The specified limit is checked against the total upfront cost of the reservation (calculated as the offering's upfront cost multiplied by the host count). If the total upfront cost is greater than the specified price limit, the request fails. This is used to ensure that the purchase does not exceed the expected upfront cost of the purchase. At this time, the only supported currency is USD. For example, to indicate a limit price of USD 100, specify 100.00.

REQUIRED OfferingId => Str

The ID of the offering.

TagSpecifications => ArrayRef[Paws::EC2::TagSpecification]

The tags to apply to the Dedicated Host Reservation during purchase.

SEE ALSO

This class forms part of Paws, documenting arguments for method PurchaseHostReservation 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