Class: Aws::EC2::Types::CreateCapacityReservationFleetRequest

Inherits:

Struct

• Object
• Struct
• Aws::EC2::Types::CreateCapacityReservationFleetRequest

Includes:

Structure

Defined in:

lib/aws-sdk-ec2/types.rb

Overview

See Also:

• AWS API Documentation

Constant Summary

SENSITIVE =

[]

Instance Attribute Summary

• #allocation_strategy ⇒ String

  The strategy used by the Capacity Reservation Fleet to determine which of the specified instance types to use.

• #client_token ⇒ String

  Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

• #dry_run ⇒ Boolean

  Checks whether you have the required permissions for the action, without actually making the request, and provides an error response.

• #end_date ⇒ Time

  The date and time at which the Capacity Reservation Fleet expires.

• #instance_match_criteria ⇒ String

  Indicates the type of instance launches that the Capacity Reservation Fleet accepts.

• #instance_type_specifications ⇒ Array<Types::ReservationFleetInstanceSpecification>

  Information about the instance types for which to reserve the capacity.

• #tag_specifications ⇒ Array<Types::TagSpecification>

  The tags to assign to the Capacity Reservation Fleet.

• #tenancy ⇒ String

  Indicates the tenancy of the Capacity Reservation Fleet.

• #total_target_capacity ⇒ Integer

  The total number of capacity units to be reserved by the Capacity Reservation Fleet.

Instance Attribute Details

#allocation_strategy ⇒ String

The strategy used by the Capacity Reservation Fleet to determine which of the specified instance types to use. Currently, only the ‘prioritized` allocation strategy is supported. For more information, see [ Allocation strategy] in the Amazon EC2 User Guide.

Valid values: ‘prioritized`

[1]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#allocation-strategy

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 6735

class CreateCapacityReservationFleetRequest < Struct.new(
  :allocation_strategy,
  :client_token,
  :instance_type_specifications,
  :tenancy,
  :total_target_capacity,
  :end_date,
  :instance_match_criteria,
  :tag_specifications,
  :dry_run)
  SENSITIVE = []
  include Aws::Structure
end

#client_token ⇒ String

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see [Ensure Idempotency].

**A suitable default value is auto-generated.** You should normally not need to pass this option.

[1]: docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 6735

class CreateCapacityReservationFleetRequest < Struct.new(
  :allocation_strategy,
  :client_token,
  :instance_type_specifications,
  :tenancy,
  :total_target_capacity,
  :end_date,
  :instance_match_criteria,
  :tag_specifications,
  :dry_run)
  SENSITIVE = []
  include Aws::Structure
end

#dry_run ⇒ Boolean

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

Returns:

• (Boolean)

# File 'lib/aws-sdk-ec2/types.rb', line 6735

class CreateCapacityReservationFleetRequest < Struct.new(
  :allocation_strategy,
  :client_token,
  :instance_type_specifications,
  :tenancy,
  :total_target_capacity,
  :end_date,
  :instance_match_criteria,
  :tag_specifications,
  :dry_run)
  SENSITIVE = []
  include Aws::Structure
end

#end_date ⇒ Time

The date and time at which the Capacity Reservation Fleet expires. When the Capacity Reservation Fleet expires, its state changes to ‘expired` and all of the Capacity Reservations in the Fleet expire.

The Capacity Reservation Fleet expires within an hour after the specified time. For example, if you specify ‘5/31/2019`, `13:30:55`, the Capacity Reservation Fleet is guaranteed to expire between `13:30:55` and `14:30:55` on `5/31/2019`.

Returns:

• (Time)

# File 'lib/aws-sdk-ec2/types.rb', line 6735

class CreateCapacityReservationFleetRequest < Struct.new(
  :allocation_strategy,
  :client_token,
  :instance_type_specifications,
  :tenancy,
  :total_target_capacity,
  :end_date,
  :instance_match_criteria,
  :tag_specifications,
  :dry_run)
  SENSITIVE = []
  include Aws::Structure
end

#instance_match_criteria ⇒ String

Indicates the type of instance launches that the Capacity Reservation Fleet accepts. All Capacity Reservations in the Fleet inherit this instance matching criteria.

Currently, Capacity Reservation Fleets support ‘open` instance matching criteria only. This means that instances that have matching attributes (instance type, platform, and Availability Zone) run in the Capacity Reservations automatically. Instances do not need to explicitly target a Capacity Reservation Fleet to use its reserved capacity.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 6735

class CreateCapacityReservationFleetRequest < Struct.new(
  :allocation_strategy,
  :client_token,
  :instance_type_specifications,
  :tenancy,
  :total_target_capacity,
  :end_date,
  :instance_match_criteria,
  :tag_specifications,
  :dry_run)
  SENSITIVE = []
  include Aws::Structure
end

#instance_type_specifications ⇒ Array<Types::ReservationFleetInstanceSpecification>

Information about the instance types for which to reserve the capacity.

Returns:

• (Array<Types::ReservationFleetInstanceSpecification>)

# File 'lib/aws-sdk-ec2/types.rb', line 6735

class CreateCapacityReservationFleetRequest < Struct.new(
  :allocation_strategy,
  :client_token,
  :instance_type_specifications,
  :tenancy,
  :total_target_capacity,
  :end_date,
  :instance_match_criteria,
  :tag_specifications,
  :dry_run)
  SENSITIVE = []
  include Aws::Structure
end

#tag_specifications ⇒ Array<Types::TagSpecification>

The tags to assign to the Capacity Reservation Fleet. The tags are automatically assigned to the Capacity Reservations in the Fleet.

Returns:

• (Array<Types::TagSpecification>)

# File 'lib/aws-sdk-ec2/types.rb', line 6735

class CreateCapacityReservationFleetRequest < Struct.new(
  :allocation_strategy,
  :client_token,
  :instance_type_specifications,
  :tenancy,
  :total_target_capacity,
  :end_date,
  :instance_match_criteria,
  :tag_specifications,
  :dry_run)
  SENSITIVE = []
  include Aws::Structure
end

#tenancy ⇒ String

Indicates the tenancy of the Capacity Reservation Fleet. All Capacity Reservations in the Fleet inherit this tenancy. The Capacity Reservation Fleet can have one of the following tenancy settings:

• ‘default` - The Capacity Reservation Fleet is created on hardware that is shared with other Amazon Web Services accounts.

• ‘dedicated` - The Capacity Reservations are created on single-tenant hardware that is dedicated to a single Amazon Web Services account.

Returns:

• (String)

# File 'lib/aws-sdk-ec2/types.rb', line 6735

class CreateCapacityReservationFleetRequest < Struct.new(
  :allocation_strategy,
  :client_token,
  :instance_type_specifications,
  :tenancy,
  :total_target_capacity,
  :end_date,
  :instance_match_criteria,
  :tag_specifications,
  :dry_run)
  SENSITIVE = []
  include Aws::Structure
end

#total_target_capacity ⇒ Integer

The total number of capacity units to be reserved by the Capacity Reservation Fleet. This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see [ Total target capacity] in the Amazon EC2 User Guide.

[1]: docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#target-capacity

Returns:

• (Integer)

# File 'lib/aws-sdk-ec2/types.rb', line 6735

class CreateCapacityReservationFleetRequest < Struct.new(
  :allocation_strategy,
  :client_token,
  :instance_type_specifications,
  :tenancy,
  :total_target_capacity,
  :end_date,
  :instance_match_criteria,
  :tag_specifications,
  :dry_run)
  SENSITIVE = []
  include Aws::Structure
end