Class: Aws::EC2::Types::AllocateHostsRequest

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-ec2/types.rb

Overview

Note:

When making an API call, you may pass AllocateHostsRequest data as a hash:

{
  auto_placement: "on", # accepts on, off
  availability_zone: "String", # required
  client_token: "String",
  instance_type: "String", # required
  quantity: 1, # required
  tag_specifications: [
    {
      resource_type: "client-vpn-endpoint", # accepts client-vpn-endpoint, customer-gateway, dedicated-host, dhcp-options, elastic-ip, fleet, fpga-image, image, instance, internet-gateway, launch-template, natgateway, network-acl, network-interface, reserved-instances, route-table, security-group, snapshot, spot-instances-request, subnet, transit-gateway, transit-gateway-attachment, transit-gateway-route-table, volume, vpc, vpc-peering-connection, vpn-connection, vpn-gateway
      tags: [
        {
          key: "String",
          value: "String",
        },
      ],
    },
  ],
}

See Also:

Instance Attribute Summary collapse

Instance Attribute Details

#auto_placement ⇒ String

This is enabled by default. This property allows instances to be automatically placed onto available Dedicated Hosts, when you are launching instances without specifying a host ID.

Default: Enabled

Returns:

  • (String) 


486
487
488
489
490
491
492
493
494
 
# File 'lib/aws-sdk-ec2/types.rb', line 486

class AllocateHostsRequest < Struct.new(
  :auto_placement,
  :availability_zone,
  :client_token,
  :instance_type,
  :quantity,
  :tag_specifications)
  include Aws::Structure
end

#availability_zone ⇒ String

The Availability Zone for the Dedicated Hosts.

Returns:

  • (String) 


486
487
488
489
490
491
492
493
494
 
# File 'lib/aws-sdk-ec2/types.rb', line 486

class AllocateHostsRequest < Struct.new(
  :auto_placement,
  :availability_zone,
  :client_token,
  :instance_type,
  :quantity,
  :tag_specifications)
  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 [How to Ensure Idempotency] in the *Amazon Elastic Compute Cloud User Guide*.

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

Returns:

  • (String) 


486
487
488
489
490
491
492
493
494
 
# File 'lib/aws-sdk-ec2/types.rb', line 486

class AllocateHostsRequest < Struct.new(
  :auto_placement,
  :availability_zone,
  :client_token,
  :instance_type,
  :quantity,
  :tag_specifications)
  include Aws::Structure
end

#instance_type ⇒ String

Specify the instance type for which to configure your Dedicated Hosts. When you specify the instance type, that is the only instance type that you can launch onto that host.

Returns:

  • (String) 


486
487
488
489
490
491
492
493
494
 
# File 'lib/aws-sdk-ec2/types.rb', line 486

class AllocateHostsRequest < Struct.new(
  :auto_placement,
  :availability_zone,
  :client_token,
  :instance_type,
  :quantity,
  :tag_specifications)
  include Aws::Structure
end

#quantity ⇒ Integer

The number of Dedicated Hosts to allocate to your account with these parameters.

Returns:

  • (Integer) 


486
487
488
489
490
491
492
493
494
 
# File 'lib/aws-sdk-ec2/types.rb', line 486

class AllocateHostsRequest < Struct.new(
  :auto_placement,
  :availability_zone,
  :client_token,
  :instance_type,
  :quantity,
  :tag_specifications)
  include Aws::Structure
end

#tag_specifications ⇒ Array<Types::TagSpecification>

The tags to apply to the Dedicated Host during creation.

Returns:



486
487
488
489
490
491
492
493
494
 
# File 'lib/aws-sdk-ec2/types.rb', line 486

class AllocateHostsRequest < Struct.new(
  :auto_placement,
  :availability_zone,
  :client_token,
  :instance_type,
  :quantity,
  :tag_specifications)
  include Aws::Structure
end