Class: AWS::EC2::Client

Inherits:
Core::QueryClient show all
Defined in:
lib/aws/ec2/client.rb

Overview

Client class for Amazon Elastic Compute Cloud (EC2).

Instance Attribute Summary

Attributes inherited from Core::Client

#config, #http_read_timeout

Instance Method Summary collapse

Methods inherited from Core::Client

#initialize, #log_warning, #operations, operations, #with_http_handler, #with_options

Constructor Details

This class inherits a constructor from AWS::Core::Client

Instance Method Details

#activate_license(options = {}) ⇒ Core::Response

Calls the ActivateLicense API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :license_id - required - (String) Specifies the ID for the specific license to activate against.

    • :capacity - required - (Integer) Specifies the additional number of licenses to activate.

Returns:




# File 'lib/aws/ec2/client.rb', line 61

#allocate_address(options = {}) ⇒ Core::Response

Calls the AllocateAddress API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain - (String) Set to vpc to allocate the address to your VPC. By default, will allocate to EC2.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :public_ip - (String)

    • :domain - (String)

    • :allocation_id - (String)




# File 'lib/aws/ec2/client.rb', line 70

#assign_private_ip_addresses(options = {}) ⇒ Core::Response

Calls the AssignPrivateIpAddresses API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_interface_id - required - (String)

    • :private_ip_addresses - (Array<String>)

    • :secondary_private_ip_address_count - (Integer)

    • :allow_reassignment - (Boolean)

Returns:




# File 'lib/aws/ec2/client.rb', line 82

#associate_address(options = {}) ⇒ Core::Response

Calls the AssociateAddress API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_id - (String) The instance to associate with the IP address.

    • :public_ip - (String) IP address that you are assigning to the instance.

    • :allocation_id - (String) The allocation ID that AWS returned when you allocated the elastic IP address for use with Amazon VPC.

    • :network_interface_id - (String)

    • :private_ip_address - (String)

    • :allow_reassociation - (Boolean)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :association_id - (String)




# File 'lib/aws/ec2/client.rb', line 91

#associate_dhcp_options(options = {}) ⇒ Core::Response

Calls the AssociateDhcpOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :dhcp_options_id - required - (String) The ID of the DHCP options to associate with the VPC. Specify “default” to associate the default DHCP options with the VPC.

    • :vpc_id - required - (String) The ID of the VPC to associate the DHCP options with.

Returns:




# File 'lib/aws/ec2/client.rb', line 108

#associate_route_table(options = {}) ⇒ Core::Response

Calls the AssociateRouteTable API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :subnet_id - required - (String) The ID of the subnet.

    • :route_table_id - required - (String) The ID of the route table.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :association_id - (String)




# File 'lib/aws/ec2/client.rb', line 118

#attach_internet_gateway(options = {}) ⇒ Core::Response

Calls the AttachInternetGateway API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :internet_gateway_id - required - (String) The ID of the Internet gateway to attach.

    • :vpc_id - required - (String) The ID of the VPC.

Returns:




# File 'lib/aws/ec2/client.rb', line 129

#attach_network_interface(options = {}) ⇒ Core::Response

Calls the AttachNetworkInterface API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_interface_id - required - (String)

    • :instance_id - required - (String)

    • :device_index - required - (Integer)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :attachment_id - (String)




# File 'lib/aws/ec2/client.rb', line 137

#attach_volume(options = {}) ⇒ Core::Response

Calls the AttachVolume API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :volume_id - required - (String) The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone and the instance must be running.

    • :instance_id - required - (String) The ID of the instance to which the volume attaches. The volume and instance must be within the same Availability Zone and the instance must be running.

    • :device - required - (String) Specifies how the device is exposed to the instance (e.g., /dev/sdh).

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :volume_id - (String)

    • :instance_id - (String)

    • :device - (String)

    • :status - (String)

    • :attach_time - (Time)

    • :delete_on_termination - (Boolean)




# File 'lib/aws/ec2/client.rb', line 148

#attach_vpn_gateway(options = {}) ⇒ Core::Response

Calls the AttachVpnGateway API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpn_gateway_id - required - (String) The ID of the VPN gateway to attach to the VPC.

    • :vpc_id - required - (String) The ID of the VPC to attach to the VPN gateway.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :attachment - (Hash)

      • :vpc_id - (String)

      • :state - (String)




# File 'lib/aws/ec2/client.rb', line 169

#authorize_security_group_egress(options = {}) ⇒ Core::Response

Calls the AuthorizeSecurityGroupEgress API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :group_id - required - (String) ID of the VPC security group to modify.

    • :source_security_group_name - (String) Deprecated.

    • :source_security_group_owner_id - (String) Deprecated.

    • :ip_protocol - (String) Deprecated.

    • :from_port - (Integer) Deprecated.

    • :to_port - (Integer) Deprecated.

    • :cidr_ip - (String) Deprecated.

    • :ip_permissions - (Array<Hash>) List of IP permissions to authorize on the specified security group. Specifying permissions through IP permissions is the preferred way of authorizing permissions since it offers more flexibility and control.

      • :ip_protocol - (String) The IP protocol of this permission. Valid protocol values: tcp, udp, icmp

      • :from_port - (Integer) Start of port range for the TCP and UDP protocols, or an ICMP type number. An ICMP type number of -1 indicates a wildcard (i.e., any ICMP type number).

      • :to_port - (Integer) End of port range for the TCP and UDP protocols, or an ICMP code. An ICMP code of -1 indicates a wildcard (i.e., any ICMP code).

      • :user_id_group_pairs - (Array<Hash>) The list of AWS user IDs and groups included in this permission.

        • :user_id - (String) The AWS user ID of an account.

        • :group_name - (String) Name of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.

        • :group_id - (String) ID of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.

      • :ip_ranges - (Array<Hash>) The list of CIDR IP ranges included in this permission.

        • :cidr_ip - (String) The list of CIDR IP ranges.

Returns:




# File 'lib/aws/ec2/client.rb', line 183

#authorize_security_group_ingress(options = {}) ⇒ Core::Response

Calls the AuthorizeSecurityGroupIngress API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :group_name - (String) Name of the standard (EC2) security group to modify. The group must belong to your account. Can be used instead of GroupID for standard (EC2) security groups.

    • :group_id - (String) ID of the standard (EC2) or VPC security group to modify. The group must belong to your account. Required for VPC security groups; can be used instead of GroupName for standard (EC2) security groups.

    • :source_security_group_name - (String) Deprecated

    • :source_security_group_owner_id - (String) Deprecated

    • :ip_protocol - (String) Deprecated

    • :from_port - (Integer) Deprecated

    • :to_port - (Integer) Deprecated

    • :cidr_ip - (String) Deprecated

    • :ip_permissions - (Array<Hash>) List of IP permissions to authorize on the specified security group. Specifying permissions through IP permissions is the preferred way of authorizing permissions since it offers more flexibility and control.

      • :ip_protocol - (String) The IP protocol of this permission. Valid protocol values: tcp, udp, icmp

      • :from_port - (Integer) Start of port range for the TCP and UDP protocols, or an ICMP type number. An ICMP type number of -1 indicates a wildcard (i.e., any ICMP type number).

      • :to_port - (Integer) End of port range for the TCP and UDP protocols, or an ICMP code. An ICMP code of -1 indicates a wildcard (i.e., any ICMP code).

      • :user_id_group_pairs - (Array<Hash>) The list of AWS user IDs and groups included in this permission.

        • :user_id - (String) The AWS user ID of an account.

        • :group_name - (String) Name of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.

        • :group_id - (String) ID of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.

      • :ip_ranges - (Array<Hash>) The list of CIDR IP ranges included in this permission.

        • :cidr_ip - (String) The list of CIDR IP ranges.

Returns:




# File 'lib/aws/ec2/client.rb', line 220

#bundle_instance(options = {}) ⇒ Core::Response

Calls the BundleInstance API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_id - required - (String) The ID of the instance to bundle.

    • :storage - required - (Hash)

      • :s3 - (Hash) The details of S3 storage for bundling a Windows instance.

        • :bucket - (String) The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

        • :prefix - (String) The prefix to use when storing the AMI in S3.

        • :aws_access_key_id - (String) The Access Key ID of the owner of the Amazon S3 bucket.

        • :upload_policy - (String) A Base64-encoded Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on the user’s behalf.

        • :upload_policy_signature - (String) The signature of the Base64 encoded JSON document.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :bundle_instance_task - (Hash)

      • :instance_id - (String)

      • :bundle_id - (String)

      • :state - (String)

      • :start_time - (Time)

      • :update_time - (Time)

      • :storage - (Hash)

        • :s3 - (Hash)

          • :bucket - (String)

          • :prefix - (String)

          • :aws_access_key_id - (String)

          • :upload_policy - (String)

          • :upload_policy_signature - (String)

      • :progress - (String)

      • :error - (Hash)

        • :code - (String)

        • :message - (String)




# File 'lib/aws/ec2/client.rb', line 262

#cancel_bundle_task(options = {}) ⇒ Core::Response

Calls the CancelBundleTask API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :bundle_id - required - (String) The ID of the bundle task to cancel.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :bundle_instance_task - (Hash)

      • :instance_id - (String)

      • :bundle_id - (String)

      • :state - (String)

      • :start_time - (Time)

      • :update_time - (Time)

      • :storage - (Hash)

        • :s3 - (Hash)

          • :bucket - (String)

          • :prefix - (String)

          • :aws_access_key_id - (String)

          • :upload_policy - (String)

          • :upload_policy_signature - (String)

      • :progress - (String)

      • :error - (Hash)

        • :code - (String)

        • :message - (String)




# File 'lib/aws/ec2/client.rb', line 304

#cancel_conversion_task(options = {}) ⇒ Core::Response

Calls the CancelConversionTask API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :conversion_task_id - required - (String)

    • :reason_message - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 330

#cancel_export_task(options = {}) ⇒ Core::Response

Calls the CancelExportTask API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :export_task_id - required - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 337

#cancel_reserved_instances_listing(options = {}) ⇒ Core::Response

Calls the CancelReservedInstancesListing API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :reserved_instances_listing_id - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :reserved_instances_listings_set - (Array<Hash>)

      • :reserved_instances_listing_id - (String)

      • :reserved_instances_id - (String)

      • :create_date - (Time)

      • :update_date - (Time)

      • :status - (String)

      • :status_message - (String)

      • :instance_counts - (Array<Hash>)

        • :state - (String)

        • :instance_count - (Integer)

      • :price_schedules - (Array<Hash>)

        • :term - (Integer)

        • :price - (Numeric)

        • :currency_code - (String)

        • :active - (Boolean)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :client_token - (String)




# File 'lib/aws/ec2/client.rb', line 343

#cancel_spot_instance_requests(options = {}) ⇒ Core::Response

Calls the CancelSpotInstanceRequests API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :spot_instance_request_ids - required - (Array<String>) Specifies the ID of the Spot Instance request.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :spot_instance_request_set - (Array<Hash>)

      • :spot_instance_request_id - (String)

      • :state - (String)




# File 'lib/aws/ec2/client.rb', line 370

#confirm_product_instance(options = {}) ⇒ Core::Response

Calls the ConfirmProductInstance API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :product_code - required - (String) The product code to confirm.

    • :instance_id - required - (String) The ID of the instance to confirm.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :owner_id - (String)




# File 'lib/aws/ec2/client.rb', line 382

#copy_image(options = {}) ⇒ Core::Response

Calls the CopyImage API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :source_region - required - (String)

    • :source_image_id - required - (String)

    • :name - required - (String)

    • :description - (String)

    • :client_token - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :image_id - (String)




# File 'lib/aws/ec2/client.rb', line 394

#copy_snapshot(options = {}) ⇒ Core::Response

Calls the CopySnapshot API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :source_region - required - (String)

    • :source_snapshot_id - required - (String)

    • :description - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :snapshot_id - (String)




# File 'lib/aws/ec2/client.rb', line 407

#create_customer_gateway(options = {}) ⇒ Core::Response

Calls the CreateCustomerGateway API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :type - required - (String) The type of VPN connection this customer gateway supports.

    • :public_ip - required - (String) The Internet-routable IP address for the customer gateway’s outside interface. The address must be static

    • :bgp_asn - required - (Integer) The customer gateway’s Border Gateway Protocol (BGP) Autonomous System Number (ASN).

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :customer_gateway - (Hash)

      • :customer_gateway_id - (String)

      • :state - (String)

      • :type - (String)

      • :ip_address - (String)

      • :bgp_asn - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 418

#create_dhcp_options(options = {}) ⇒ Core::Response

Calls the CreateDhcpOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :dhcp_configurations - required - (Array<Hash>) A set of one or more DHCP configurations.

      • :key - (String) Contains the name of a DHCP option.

      • :values - (Array<String>) Contains a set of values for a DHCP option.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :dhcp_options - (Hash)

      • :dhcp_options_id - (String)

      • :dhcp_configuration_set - (Array<Hash>)

        • :key - (String)

        • :value_set - (Array<String>)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 441

#create_image(options = {}) ⇒ Core::Response

Calls the CreateImage API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_id - required - (String) The ID of the instance from which to create the new image.

    • :name - required - (String) The name for the new AMI being created.

    • :description - (String) The description for the new AMI being created.

    • :no_reboot - (Boolean) By default this property is set to false , which means Amazon EC2 attempts to cleanly shut down the instance before image creation and reboots the instance afterwards. When set to true , Amazon EC2 will not shut down the instance before creating the image. When this option is used, file system integrity on the created image cannot be guaranteed.

    • :block_device_mappings - (Array<Hash>)

      • :virtual_name - (String) Specifies the virtual device name.

      • :device_name - (String) Specifies the device name (e.g., /dev/sdh).

      • :ebs - (Hash) Specifies parameters used to automatically setup Amazon EBS volumes when the instance is launched.

        • :snapshot_id - (String) The ID of the snapshot from which the volume will be created.

        • :volume_size - (Integer) The size of the volume, in gigabytes.

        • :delete_on_termination - (Boolean) Specifies whether the Amazon EBS volume is deleted on instance termination.

        • :volume_type - (String)

        • :iops - (Integer)

      • :no_device - (String) Specifies the device name to suppress during instance launch.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :image_id - (String)




# File 'lib/aws/ec2/client.rb', line 461

#create_instance_export_task(options = {}) ⇒ Core::Response

Calls the CreateInstanceExportTask API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :description - (String)

    • :instance_id - required - (String)

    • :target_environment - (String)

    • :export_to_s3_task - (Hash)

      • :disk_image_format - (String)

      • :container_format - (String)

      • :s3_bucket - (String)

      • :s3_prefix - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :export_task - (Hash)

      • :export_task_id - (String)

      • :description - (String)

      • :state - (String)

      • :status_message - (String)

      • :instance_export - (Hash)

        • :instance_id - (String)

        • :target_environment - (String)

      • :export_to_s3 - (Hash)

        • :disk_image_format - (String)

        • :container_format - (String)

        • :s3_bucket - (String)

        • :s3_key - (String)




# File 'lib/aws/ec2/client.rb', line 497

#create_internet_gateway(options = {}) ⇒ Core::Response

Calls the CreateInternetGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :internet_gateway - (Hash)

      • :internet_gateway_id - (String)

      • :attachment_set - (Array<Hash>)

        • :vpc_id - (String)

        • :state - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 525

#create_key_pair(options = {}) ⇒ Core::Response

Calls the CreateKeyPair API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :key_name - required - (String) The unique name for the new key pair.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :key_pair - (Hash)

      • :key_name - (String)

      • :key_fingerprint - (String)

      • :key_material - (String)




# File 'lib/aws/ec2/client.rb', line 540

#create_network_acl(options = {}) ⇒ Core::Response

Calls the CreateNetworkAcl API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpc_id - required - (String) The ID of the VPC where the network ACL will be created.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :network_acl - (Hash)

      • :network_acl_id - (String)

      • :vpc_id - (String)

      • :default - (Boolean)

      • :entry_set - (Array<Hash>)

        • :rule_number - (Integer)

        • :protocol - (String)

        • :rule_action - (String)

        • :egress - (Boolean)

        • :cidr_block - (String)

        • :icmp_type_code - (Hash)

          • :type - (Integer)

          • :code - (Integer)

        • :port_range - (Hash)

          • :from - (Integer)

          • :to - (Integer)

      • :association_set - (Array<Hash>)

        • :network_acl_association_id - (String)

        • :network_acl_id - (String)

        • :subnet_id - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 553

#create_network_acl_entry(options = {}) ⇒ Core::Response

Calls the CreateNetworkAclEntry API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_acl_id - required - (String) ID of the ACL where the entry will be created.

    • :rule_number - required - (Integer) Rule number to assign to the entry (e.g., 100). ACL entries are processed in ascending order by rule number.

    • :protocol - required - (String) IP protocol the rule applies to. Valid Values: tcp, udp, icmp or an IP protocol number.

    • :rule_action - required - (String) Whether to allow or deny traffic that matches the rule.

    • :egress - required - (Boolean) Whether this rule applies to egress traffic from the subnet ( true ) or ingress traffic to the subnet ( false ).

    • :cidr_block - required - (String) The CIDR range to allow or deny, in CIDR notation (e.g., 172.16.0.0/24).

    • :icmp_type_code - (Hash) ICMP values.

      • :type - (Integer) For the ICMP protocol, the ICMP type. A value of -1 is a wildcard meaning all types. Required if specifying icmp for the protocol.

      • :code - (Integer) For the ICMP protocol, the ICMP code. A value of -1 is a wildcard meaning all codes. Required if specifying icmp for the protocol.

    • :port_range - (Hash) Port ranges.

      • :from - (Integer) The first port in the range. Required if specifying tcp or udp for the protocol.

      • :to - (Integer) The last port in the range. Required if specifying tcp or udp for the protocol.

Returns:




# File 'lib/aws/ec2/client.rb', line 585

#create_network_interface(options = {}) ⇒ Core::Response

Calls the CreateNetworkInterface API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :subnet_id - required - (String)

    • :description - (String)

    • :private_ip_address - (String)

    • :groups - (Array<String>)

    • :private_ip_addresses - (Array<Hash>)

      • :private_ip_address - required - (String)

      • :primary - (Boolean)

    • :secondary_private_ip_address_count - (Integer)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :network_interface - (Hash)

      • :network_interface_id - (String)

      • :subnet_id - (String)

      • :vpc_id - (String)

      • :availability_zone - (String)

      • :description - (String)

      • :owner_id - (String)

      • :requester_id - (String)

      • :requester_managed - (Boolean)

      • :status - (String)

      • :mac_address - (String)

      • :private_ip_address - (String)

      • :private_dns_name - (String)

      • :source_dest_check - (Boolean)

      • :group_set - (Array<Hash>)

        • :group_name - (String)

        • :group_id - (String)

      • :attachment - (Hash)

        • :attachment_id - (String)

        • :instance_id - (String)

        • :instance_owner_id - (String)

        • :device_index - (Integer)

        • :status - (String)

        • :attach_time - (Time)

        • :delete_on_termination - (Boolean)

      • :association - (Hash)

        • :public_ip - (String)

        • :ip_owner_id - (String)

        • :allocation_id - (String)

        • :association_id - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :private_ip_addresses_set - (Array<Hash>)

        • :private_ip_address - (String)

        • :private_dns_name - (String)

        • :primary - (Boolean)

        • :association - (Hash)

          • :public_ip - (String)

          • :ip_owner_id - (String)

          • :allocation_id - (String)

          • :association_id - (String)




# File 'lib/aws/ec2/client.rb', line 616

#create_placement_group(options = {}) ⇒ Core::Response

Calls the CreatePlacementGroup API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :group_name - required - (String) The name of the PlacementGroup.

    • :strategy - required - (String) The PlacementGroup strategy.

Returns:




# File 'lib/aws/ec2/client.rb', line 673

#create_reserved_instances_listing(options = {}) ⇒ Core::Response

Calls the CreateReservedInstancesListing API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :reserved_instances_id - required - (String)

    • :instance_count - required - (Integer)

    • :price_schedules - required - (Array<Hash>)

      • :term - (Integer)

      • :price - (Float)

      • :currency_code - (String)

    • :client_token - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :reserved_instances_listings_set - (Array<Hash>)

      • :reserved_instances_listing_id - (String)

      • :reserved_instances_id - (String)

      • :create_date - (Time)

      • :update_date - (Time)

      • :status - (String)

      • :status_message - (String)

      • :instance_counts - (Array<Hash>)

        • :state - (String)

        • :instance_count - (Integer)

      • :price_schedules - (Array<Hash>)

        • :term - (Integer)

        • :price - (Numeric)

        • :currency_code - (String)

        • :active - (Boolean)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :client_token - (String)




# File 'lib/aws/ec2/client.rb', line 681

#create_route(options = {}) ⇒ Core::Response

Calls the CreateRoute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :route_table_id - required - (String) The ID of the route table where the route will be added.

    • :destination_cidr_block - required - (String) The CIDR address block used for the destination match. For example: 0.0.0.0/0. Routing decisions are based on the most specific match.

    • :gateway_id - (String) The ID of a VPN or Internet gateway attached to your VPC. You must provide either GatewayId or InstanceId, but not both.

    • :instance_id - (String) The ID of a NAT instance in your VPC. You must provide either GatewayId or InstanceId, but not both.

    • :network_interface_id - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 714

#create_route_table(options = {}) ⇒ Core::Response

Calls the CreateRouteTable API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpc_id - required - (String) The ID of the VPC where the route table will be created.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :route_table - (Hash)

      • :route_table_id - (String)

      • :vpc_id - (String)

      • :route_set - (Array<Hash>)

        • :destination_cidr_block - (String)

        • :gateway_id - (String)

        • :instance_id - (String)

        • :instance_owner_id - (String)

        • :network_interface_id - (String)

        • :state - (String)

      • :association_set - (Array<Hash>)

        • :route_table_association_id - (String)

        • :route_table_id - (String)

        • :subnet_id - (String)

        • :main - (Boolean)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :propagating_vgw_set - (Array<Hash>)

        • :gateway_id - (String)




# File 'lib/aws/ec2/client.rb', line 730

#create_security_group(options = {}) ⇒ Core::Response

Calls the CreateSecurityGroup API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :group_name - required - (String) Name of the security group.

    • :description - required - (String) Description of the group. This is informational only.

    • :vpc_id - (String) ID of the VPC.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :group_id - (String)




# File 'lib/aws/ec2/client.rb', line 759

#create_snapshot(options = {}) ⇒ Core::Response

Calls the CreateSnapshot API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :volume_id - required - (String) The ID of the volume from which to create the snapshot.

    • :description - (String) The description for the new snapshot.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :snapshot_id - (String)

    • :volume_id - (String)

    • :status - (String)

    • :start_time - (Time)

    • :progress - (String)

    • :owner_id - (String)

    • :description - (String)

    • :volume_size - (Integer)

    • :owner_alias - (String)

    • :tag_set - (Array<Hash>)

      • :key - (String)

      • :value - (String)




# File 'lib/aws/ec2/client.rb', line 771

#create_spot_datafeed_subscription(options = {}) ⇒ Core::Response

Calls the CreateSpotDatafeedSubscription API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :bucket - required - (String) The Amazon S3 bucket in which to store the Spot Instance datafeed.

    • :prefix - (String) The prefix that is prepended to datafeed files.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :spot_datafeed_subscription - (Hash)

      • :owner_id - (String)

      • :bucket - (String)

      • :prefix - (String)

      • :state - (String)

      • :fault - (Hash)

        • :code - (String)

        • :message - (String)




# File 'lib/aws/ec2/client.rb', line 793

#create_subnet(options = {}) ⇒ Core::Response

Calls the CreateSubnet API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpc_id - required - (String) The ID of the VPC to create the subnet in.

    • :cidr_block - required - (String) The CIDR block the subnet is to cover.

    • :availability_zone - (String) The Availability Zone to create the subnet in.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :subnet - (Hash)

      • :subnet_id - (String)

      • :state - (String)

      • :vpc_id - (String)

      • :cidr_block - (String)

      • :available_ip_address_count - (Integer)

      • :availability_zone - (String)

      • :default_for_az - (Boolean)

      • :map_public_ip_on_launch - (Boolean)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 812

#create_tags(options = {}) ⇒ Core::Response

Calls the CreateTags API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :resources - required - (Array<String>) One or more IDs of resources to tag. This could be the ID of an AMI, an instance, an EBS volume, or snapshot, etc.

    • :tags - required - (Array<Hash>) The tags to add or overwrite for the specified resources. Each tag item consists of a key-value pair.

      • :key - (String) The tag’s key.

      • :value - (String) The tag’s value.

Returns:




# File 'lib/aws/ec2/client.rb', line 837

#create_volume(options = {}) ⇒ Core::Response

Calls the CreateVolume API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :size - (Integer) The size of the volume, in gigabytes. Required if you are not creating a volume from a snapshot.

    • :snapshot_id - (String) The ID of the snapshot from which to create the new volume.

    • :availability_zone - required - (String) The Availability Zone in which to create the new volume.

    • :volume_type - (String)

    • :iops - (Integer)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :volume_id - (String)

    • :size - (Integer)

    • :snapshot_id - (String)

    • :availability_zone - (String)

    • :status - (String)

    • :create_time - (Time)

    • :attachment_set - (Array<Hash>)

      • :volume_id - (String)

      • :instance_id - (String)

      • :device - (String)

      • :status - (String)

      • :attach_time - (Time)

      • :delete_on_termination - (Boolean)

    • :tag_set - (Array<Hash>)

      • :key - (String)

      • :value - (String)

    • :volume_type - (String)

    • :iops - (Integer)




# File 'lib/aws/ec2/client.rb', line 850

#create_vpc(options = {}) ⇒ Core::Response

Calls the CreateVpc API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :cidr_block - required - (String) A valid CIDR block.

    • :instance_tenancy - (String) The allowed tenancy of instances launched into the VPC. A value of default means instances can be launched with any tenancy; a value of dedicated means instances must be launched with tenancy as dedicated.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :vpc - (Hash)

      • :vpc_id - (String)

      • :state - (String)

      • :cidr_block - (String)

      • :dhcp_options_id - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :instance_tenancy - (String)

      • :is_default - (Boolean)




# File 'lib/aws/ec2/client.rb', line 883

#create_vpn_connection(options = {}) ⇒ Core::Response

Calls the CreateVpnConnection API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :type - required - (String) The type of VPN connection.

    • :customer_gateway_id - required - (String) The ID of the customer gateway.

    • :vpn_gateway_id - required - (String) The ID of the VPN gateway.

    • :options - (Hash)

      • :static_routes_only - (Boolean)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :vpn_connection - (Hash)

      • :vpn_connection_id - (String)

      • :state - (String)

      • :customer_gateway_configuration - (String)

      • :type - (String)

      • :customer_gateway_id - (String)

      • :vpn_gateway_id - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :vgw_telemetry - (Array<Hash>)

        • :outside_ip_address - (String)

        • :status - (String)

        • :last_status_change - (Time)

        • :status_message - (String)

        • :accepted_route_count - (Integer)

      • :options - (Hash)

        • :static_routes_only - (Boolean)

      • :routes - (Array<Hash>)

        • :destination_cidr_block - (String)

        • :source - (String)

        • :state - (String)




# File 'lib/aws/ec2/client.rb', line 905

#create_vpn_connection_route(options = {}) ⇒ Core::Response

Calls the CreateVpnConnectionRoute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpn_connection_id - required - (String)

    • :destination_cidr_block - required - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 941

#create_vpn_gateway(options = {}) ⇒ Core::Response

Calls the CreateVpnGateway API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :type - required - (String) The type of VPN connection this VPN gateway supports.

    • :availability_zone - (String) The Availability Zone in which to create the VPN gateway.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :vpn_gateway - (Hash)

      • :vpn_gateway_id - (String)

      • :state - (String)

      • :vpn_type - (String)

      • :availability_zone - (String)

      • :attachments - (Array<Hash>)

        • :vpc_id - (String)

        • :state - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 948

#deactivate_license(options = {}) ⇒ Core::Response

Calls the DeactivateLicense API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :license_id - required - (String) Specifies the ID for the specific license to deactivate against.

    • :capacity - required - (Integer) Specifies the amount of capacity to deactivate against the license.

Returns:




# File 'lib/aws/ec2/client.rb', line 970

#delete_customer_gateway(options = {}) ⇒ Core::Response

Calls the DeleteCustomerGateway API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :customer_gateway_id - required - (String) The ID of the customer gateway to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 979

#delete_dhcp_options(options = {}) ⇒ Core::Response

Calls the DeleteDhcpOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :dhcp_options_id - required - (String) The ID of the DHCP options set to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 986

#delete_internet_gateway(options = {}) ⇒ Core::Response

Calls the DeleteInternetGateway API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :internet_gateway_id - required - (String) The ID of the Internet gateway to be deleted.

Returns:




# File 'lib/aws/ec2/client.rb', line 993

#delete_key_pair(options = {}) ⇒ Core::Response

Calls the DeleteKeyPair API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :key_name - required - (String) The name of the Amazon EC2 key pair to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 1000

#delete_network_acl(options = {}) ⇒ Core::Response

Calls the DeleteNetworkAcl API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_acl_id - required - (String) The ID of the network ACL to be deleted.

Returns:




# File 'lib/aws/ec2/client.rb', line 1007

#delete_network_acl_entry(options = {}) ⇒ Core::Response

Calls the DeleteNetworkAclEntry API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_acl_id - required - (String) ID of the network ACL.

    • :rule_number - required - (Integer) Rule number for the entry to delete.

    • :egress - required - (Boolean) Whether the rule to delete is an egress rule ( true ) or ingress rule ( false ).

Returns:




# File 'lib/aws/ec2/client.rb', line 1014

#delete_network_interface(options = {}) ⇒ Core::Response

Calls the DeleteNetworkInterface API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_interface_id - required - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 1024

#delete_placement_group(options = {}) ⇒ Core::Response

Calls the DeletePlacementGroup API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :group_name - required - (String) The name of the PlacementGroup to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 1030

#delete_route(options = {}) ⇒ Core::Response

Calls the DeleteRoute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :route_table_id - required - (String) The ID of the route table where the route will be deleted.

    • :destination_cidr_block - required - (String) The CIDR range for the route you want to delete. The value you specify must exactly match the CIDR for the route you want to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 1037

#delete_route_table(options = {}) ⇒ Core::Response

Calls the DeleteRouteTable API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :route_table_id - required - (String) The ID of the route table to be deleted.

Returns:




# File 'lib/aws/ec2/client.rb', line 1047

#delete_security_group(options = {}) ⇒ Core::Response

Calls the DeleteSecurityGroup API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :group_name - (String) The name of the Amazon EC2 security group to delete.

    • :group_id - (String) The ID of the Amazon EC2 security group to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 1054

#delete_snapshot(options = {}) ⇒ Core::Response

Calls the DeleteSnapshot API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :snapshot_id - required - (String) The ID of the snapshot to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 1063

#delete_spot_datafeed_subscription(options = {}) ⇒ Core::Response

Calls the DeleteSpotDatafeedSubscription API operation.

Parameters:

  • options (Hash) (defaults to: {})

Returns:




# File 'lib/aws/ec2/client.rb', line 1070

#delete_subnet(options = {}) ⇒ Core::Response

Calls the DeleteSubnet API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :subnet_id - required - (String) The ID of the subnet you want to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 1075

#delete_tags(options = {}) ⇒ Core::Response

Calls the DeleteTags API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :resources - required - (Array<String>) A list of one or more resource IDs. This could be the ID of an AMI, an instance, an EBS volume, or snapshot, etc.

    • :tags - (Array<Hash>) The tags to delete from the specified resources. Each tag item consists of a key-value pair. If a tag is specified without a value, the tag and all of its values are deleted.

      • :key - (String) The tag’s key.

      • :value - (String) The tag’s value.

Returns:




# File 'lib/aws/ec2/client.rb', line 1082

#delete_volume(options = {}) ⇒ Core::Response

Calls the DeleteVolume API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :volume_id - required - (String) The ID of the EBS volume to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 1096

#delete_vpc(options = {}) ⇒ Core::Response

Calls the DeleteVpc API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpc_id - required - (String) The ID of the VPC you want to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 1103

#delete_vpn_connection(options = {}) ⇒ Core::Response

Calls the DeleteVpnConnection API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpn_connection_id - required - (String) The ID of the VPN connection to delete

Returns:




# File 'lib/aws/ec2/client.rb', line 1110

#delete_vpn_connection_route(options = {}) ⇒ Core::Response

Calls the DeleteVpnConnectionRoute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpn_connection_id - required - (String)

    • :destination_cidr_block - required - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 1117

#delete_vpn_gateway(options = {}) ⇒ Core::Response

Calls the DeleteVpnGateway API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpn_gateway_id - required - (String) The ID of the VPN gateway to delete.

Returns:




# File 'lib/aws/ec2/client.rb', line 1124

#deregister_image(options = {}) ⇒ Core::Response

Calls the DeregisterImage API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :image_id - required - (String) The ID of the AMI to deregister.

Returns:




# File 'lib/aws/ec2/client.rb', line 1131

#describe_account_attributes(options = {}) ⇒ Core::Response

Calls the DescribeAccountAttributes API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :attribute_names - (Array<String>)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :account_attribute_set - (Array<Hash>)

      • :attribute_name - (String)

      • :attribute_value_set - (Array<Hash>)

        • :attribute_value - (String)




# File 'lib/aws/ec2/client.rb', line 1138

#describe_addresses(options = {}) ⇒ Core::Response

Calls the DescribeAddresses API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :public_ips - (Array<String>) The optional list of Elastic IP addresses to describe.

    • :filters - (Array<Hash>) A list of filters used to match properties for Addresses. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

    • :allocation_ids - (Array<String>)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :addresses_set - (Array<Hash>)

      • :instance_id - (String)

      • :public_ip - (String)

      • :allocation_id - (String)

      • :association_id - (String)

      • :domain - (String)

      • :network_interface_id - (String)

      • :network_interface_owner_id - (String)

      • :private_ip_address - (String)




# File 'lib/aws/ec2/client.rb', line 1150

#describe_availability_zones(options = {}) ⇒ Core::Response

Calls the DescribeAvailabilityZones API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :zone_names - (Array<String>) A list of the availability zone names to describe.

    • :filters - (Array<Hash>) A list of filters used to match properties for AvailabilityZones. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :availability_zone_info - (Array<Hash>)

      • :zone_name - (String)

      • :zone_state - (String)

      • :region_name - (String)

      • :message_set - (Array<Hash>)

        • :message - (String)




# File 'lib/aws/ec2/client.rb', line 1175

#describe_bundle_tasks(options = {}) ⇒ Core::Response

Calls the DescribeBundleTasks API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :bundle_ids - (Array<String>) The list of bundle task IDs to describe.

    • :filters - (Array<Hash>) A list of filters used to match properties for BundleTasks. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :bundle_instance_tasks_set - (Array<Hash>)

      • :instance_id - (String)

      • :bundle_id - (String)

      • :state - (String)

      • :start_time - (Time)

      • :update_time - (Time)

      • :storage - (Hash)

        • :s3 - (Hash)

          • :bucket - (String)

          • :prefix - (String)

          • :aws_access_key_id - (String)

          • :upload_policy - (String)

          • :upload_policy_signature - (String)

      • :progress - (String)

      • :error - (Hash)

        • :code - (String)

        • :message - (String)




# File 'lib/aws/ec2/client.rb', line 1197

#describe_conversion_tasks(options = {}) ⇒ Core::Response

Calls the DescribeConversionTasks API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :filters - (Array<Hash>)

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

    • :conversion_task_ids - (Array<String>)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :conversion_tasks - (Array<Hash>)

      • :conversion_task_id - (String)

      • :expiration_time - (String)

      • :import_instance - (Hash)

        • :volumes - (Array<Hash>)

          • :bytes_converted - (Integer)

          • :availability_zone - (String)

          • :image - (Hash)

            • :format - (String)

            • :size - (Integer)

            • :import_manifest_url - (String)

            • :checksum - (String)

          • :volume - (Hash)

            • :size - (Integer)

            • :id - (String)

          • :status - (String)

          • :status_message - (String)

          • :description - (String)

        • :instance_id - (String)

        • :platform - (String)

        • :description - (String)

      • :import_volume - (Hash)

        • :bytes_converted - (Integer)

        • :availability_zone - (String)

        • :description - (String)

        • :image - (Hash)

          • :format - (String)

          • :size - (Integer)

          • :import_manifest_url - (String)

          • :checksum - (String)

        • :volume - (Hash)

          • :size - (Integer)

          • :id - (String)

      • :state - (String)

      • :status_message - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 1230

#describe_customer_gateways(options = {}) ⇒ Core::Response

Calls the DescribeCustomerGateways API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :customer_gateway_ids - (Array<String>) A set of one or more customer gateway IDs.

    • :filters - (Array<Hash>) A list of filters used to match properties for Customer Gateways. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :customer_gateway_set - (Array<Hash>)

      • :customer_gateway_id - (String)

      • :state - (String)

      • :vpn_type - (String)

      • :ip_address - (String)

      • :bgp_asn - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 1280

#describe_dhcp_options(options = {}) ⇒ Core::Response

Calls the DescribeDhcpOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :dhcp_options_ids - (Array<String>)

    • :filters - (Array<Hash>) A list of filters used to match properties for DhcpOptions. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :dhcp_options_set - (Array<Hash>)

      • :dhcp_options_id - (String)

      • :dhcp_configuration_set - (Array<Hash>)

        • :key - (String)

        • :value_set - (Array<String>)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 1305

#describe_export_tasks(options = {}) ⇒ Core::Response

Calls the DescribeExportTasks API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :export_task_ids - (Array<String>)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :export_task_set - (Array<Hash>)

      • :export_task_id - (String)

      • :description - (String)

      • :state - (String)

      • :status_message - (String)

      • :instance_export - (Hash)

        • :instance_id - (String)

        • :target_environment - (String)

      • :export_to_s3 - (Hash)

        • :disk_image_format - (String)

        • :container_format - (String)

        • :s3_bucket - (String)

        • :s3_key - (String)




# File 'lib/aws/ec2/client.rb', line 1328

#describe_image_attribute(options = {}) ⇒ Core::Response

Calls the DescribeImageAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :image_id - required - (String) The ID of the AMI whose attribute is to be described.

    • :attribute - required - (String) The name of the attribute to describe. Available attribute names: productCodes, kernel, ramdisk, launchPermisson, blockDeviceMapping

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :image_id - (String)

    • :launch_permission - (Array<Hash>)

      • :user_id - (String)

      • :group - (String)

    • :product_codes - (Array<Hash>)

      • :product_code - (String)

      • :type - (String)

    • :kernel - (Hash)

      • :value - (String)

    • :ramdisk - (Hash)

      • :value - (String)

    • :description - (Hash)

      • :value - (String)

    • :block_device_mapping - (Array<Hash>)

      • :virtual_name - (String)

      • :device_name - (String)

      • :ebs - (Hash)

        • :snapshot_id - (String)

        • :volume_size - (Integer)

        • :delete_on_termination - (Boolean)

        • :volume_type - (String)

        • :iops - (Integer)

      • :no_device - (String)




# File 'lib/aws/ec2/client.rb', line 1349

#describe_images(options = {}) ⇒ Core::Response

Calls the DescribeImages API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :image_ids - (Array<String>) An optional list of the AMI IDs to describe. If not specified, all AMIs will be described.

    • :owners - (Array<String>) The optional list of owners for the described AMIs. The IDs amazon, self, and explicit can be used to include AMIs owned by Amazon, AMIs owned by the user, and AMIs for which the user has explicit launch permissions, respectively.

    • :executable_users - (Array<String>) The optional list of users with explicit launch permissions for the described AMIs. The user ID can be a user’s account ID, ‘self’ to return AMIs for which the sender of the request has explicit launch permissions, or ‘all’ to return AMIs with public launch permissions.

    • :filters - (Array<Hash>) A list of filters used to match properties for Images. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :images_set - (Array<Hash>)

      • :image_id - (String)

      • :image_location - (String)

      • :image_state - (String)

      • :image_owner_id - (String)

      • :is_public - (Boolean)

      • :product_codes - (Array<Hash>)

        • :product_code - (String)

        • :type - (String)

      • :architecture - (String)

      • :image_type - (String)

      • :kernel_id - (String)

      • :ramdisk_id - (String)

      • :platform - (String)

      • :state_reason - (Hash)

        • :code - (String)

        • :message - (String)

      • :image_owner_alias - (String)

      • :name - (String)

      • :description - (String)

      • :root_device_type - (String)

      • :root_device_name - (String)

      • :block_device_mapping - (Array<Hash>)

        • :virtual_name - (String)

        • :device_name - (String)

        • :ebs - (Hash)

          • :snapshot_id - (String)

          • :volume_size - (Integer)

          • :delete_on_termination - (Boolean)

          • :volume_type - (String)

          • :iops - (Integer)

        • :no_device - (String)

      • :virtualization_type - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :hypervisor - (String)




# File 'lib/aws/ec2/client.rb', line 1384

#describe_instance_attribute(options = {}) ⇒ Core::Response

Calls the DescribeInstanceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_id - required - (String) The ID of the instance whose instance attribute is being described.

    • :attribute - required - (String) The name of the attribute to describe. Available attribute names: instanceType, kernel, ramdisk, userData, disableApiTermination, instanceInitiatedShutdownBehavior, rootDeviceName, blockDeviceMapping

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instance_id - (String)

    • :instance_type - (Hash)

      • :value - (String)

    • :kernel - (Hash)

      • :value - (String)

    • :ramdisk - (Hash)

      • :value - (String)

    • :user_data - (Hash)

      • :value - (String)

    • :disable_api_termination - (Hash)

      • :value - (Boolean)

    • :instance_initiated_shutdown_behavior - (Hash)

      • :value - (String)

    • :root_device_name - (Hash)

      • :value - (String)

    • :block_device_mapping - (Array<Hash>)

      • :device_name - (String)

      • :ebs - (Hash)

        • :volume_id - (String)

        • :status - (String)

        • :attach_time - (Time)

        • :delete_on_termination - (Boolean)

    • :product_codes - (Array<Hash>)

      • :product_code - (String)

      • :type - (String)

    • :ebs_optimized - (Hash)

      • :value - (Boolean)




# File 'lib/aws/ec2/client.rb', line 1445

#describe_instance_status(options = {}) ⇒ Core::Response

Calls the DescribeInstanceStatus API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_ids - (Array<String>) The list of instance IDs. If not specified, all instances are described.

    • :filters - (Array<Hash>) The list of filters to limit returned results.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

    • :next_token - (String) A string specifying the next paginated set of results to return.

    • :max_results - (Integer) The maximum number of paginated instance items per response.

    • :include_all_instances - (Boolean)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instance_status_set - (Array<Hash>)

      • :instance_id - (String)

      • :availability_zone - (String)

      • :events_set - (Array<Hash>)

        • :code - (String)

        • :description - (String)

        • :not_before - (Time)

        • :not_after - (Time)

      • :instance_state - (Hash)

        • :code - (Integer)

        • :name - (String)

      • :system_status - (Hash)

        • :status - (String)

        • :details - (Array<Hash>)

          • :name - (String)

          • :status - (String)

          • :impaired_since - (Time)

      • :instance_status - (Hash)

        • :status - (String)

        • :details - (Array<Hash>)

          • :name - (String)

          • :status - (String)

          • :impaired_since - (Time)

    • :next_token - (String)




# File 'lib/aws/ec2/client.rb', line 1485

#describe_instances(options = {}) ⇒ Core::Response

Calls the DescribeInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_ids - (Array<String>) An optional list of the instances to describe.

    • :filters - (Array<Hash>) A list of filters used to match properties for Instances. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :reservation_set - (Array<Hash>)

      • :reservation_id - (String)

      • :owner_id - (String)

      • :requester_id - (String)

      • :group_set - (Array<Hash>)

        • :group_name - (String)

        • :group_id - (String)

      • :instances_set - (Array<Hash>)

        • :instance_id - (String)

        • :image_id - (String)

        • :instance_state - (Hash)

          • :code - (Integer)

          • :name - (String)

        • :private_dns_name - (String)

        • :dns_name - (String)

        • :reason - (String)

        • :key_name - (String)

        • :ami_launch_index - (Integer)

        • :product_codes - (Array<Hash>)

          • :product_code - (String)

          • :type - (String)

        • :instance_type - (String)

        • :launch_time - (Time)

        • :placement - (Hash)

          • :availability_zone - (String)

          • :group_name - (String)

          • :tenancy - (String)

        • :kernel_id - (String)

        • :ramdisk_id - (String)

        • :platform - (String)

        • :monitoring - (Hash)

          • :state - (String)

        • :subnet_id - (String)

        • :vpc_id - (String)

        • :private_ip_address - (String)

        • :ip_address - (String)

        • :state_reason - (Hash)

          • :code - (String)

          • :message - (String)

        • :architecture - (String)

        • :root_device_type - (String)

        • :root_device_name - (String)

        • :block_device_mapping - (Array<Hash>)

          • :device_name - (String)

          • :ebs - (Hash)

            • :volume_id - (String)

            • :status - (String)

            • :attach_time - (Time)

            • :delete_on_termination - (Boolean)

        • :virtualization_type - (String)

        • :instance_lifecycle - (String)

        • :spot_instance_request_id - (String)

        • :license - (Hash)

          • :pool - (String)

        • :client_token - (String)

        • :tag_set - (Array<Hash>)

          • :key - (String)

          • :value - (String)

        • :group_set - (Array<Hash>)

          • :group_name - (String)

          • :group_id - (String)

        • :source_dest_check - (Boolean)

        • :hypervisor - (String)

        • :network_interface_set - (Array<Hash>)

          • :network_interface_id - (String)

          • :subnet_id - (String)

          • :vpc_id - (String)

          • :description - (String)

          • :owner_id - (String)

          • :status - (String)

          • :private_ip_address - (String)

          • :private_dns_name - (String)

          • :source_dest_check - (Boolean)

          • :group_set - (Array<Hash>)

            • :group_name - (String)

            • :group_id - (String)

          • :attachment - (Hash)

            • :attachment_id - (String)

            • :device_index - (Integer)

            • :status - (String)

            • :attach_time - (Time)

            • :delete_on_termination - (Boolean)

          • :association - (Hash)

            • :public_ip - (String)

            • :public_dns_name - (String)

            • :ip_owner_id - (String)

          • :private_ip_addresses_set - (Array<Hash>)

            • :private_ip_address - (String)

            • :private_dns_name - (String)

            • :primary - (Boolean)

            • :association - (Hash)

              • :public_ip - (String)

              • :public_dns_name - (String)

              • :ip_owner_id - (String)

        • :iam_instance_profile - (Hash)

          • :arn - (String)

          • :id - (String)

        • :ebs_optimized - (Boolean)




# File 'lib/aws/ec2/client.rb', line 1528

#describe_internet_gateways(options = {}) ⇒ Core::Response

Calls the DescribeInternetGateways API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :internet_gateway_ids - (Array<String>) One or more Internet gateway IDs.

    • :filters - (Array<Hash>) A list of filters used to match properties for Internet Gateways. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :internet_gateway_set - (Array<Hash>)

      • :internet_gateway_id - (String)

      • :attachment_set - (Array<Hash>)

        • :vpc_id - (String)

        • :state - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 1641

#describe_key_pairs(options = {}) ⇒ Core::Response

Calls the DescribeKeyPairs API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :key_names - (Array<String>) The optional list of key pair names to describe.

    • :filters - (Array<Hash>) A list of filters used to match properties for KeyPairs. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :key_set - (Array<Hash>)

      • :key_name - (String)

      • :key_fingerprint - (String)




# File 'lib/aws/ec2/client.rb', line 1665

#describe_licenses(options = {}) ⇒ Core::Response

Calls the DescribeLicenses API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :license_ids - (Array<String>) Specifies the license registration for which details are to be returned.

    • :filters - (Array<Hash>) A list of filters used to match properties for Licenses. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :license_set - (Array<Hash>)

      • :license_id - (String)

      • :type - (String)

      • :pool - (String)

      • :capacity_set - (Array<Hash>)

        • :capacity - (Integer)

        • :instance_capacity - (Integer)

        • :state - (String)

        • :earliest_allowed_deactivation_time - (Time)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 1683

#describe_network_acls(options = {}) ⇒ Core::Response

Calls the DescribeNetworkAcls API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_acl_ids - (Array<String>) One or more network ACL IDs.

    • :filters - (Array<Hash>) A list of filters used to match properties for Network ACLs. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :network_acl_set - (Array<Hash>)

      • :network_acl_id - (String)

      • :vpc_id - (String)

      • :default - (Boolean)

      • :entry_set - (Array<Hash>)

        • :rule_number - (Integer)

        • :protocol - (String)

        • :rule_action - (String)

        • :egress - (Boolean)

        • :cidr_block - (String)

        • :icmp_type_code - (Hash)

          • :type - (Integer)

          • :code - (Integer)

        • :port_range - (Hash)

          • :from - (Integer)

          • :to - (Integer)

      • :association_set - (Array<Hash>)

        • :network_acl_association_id - (String)

        • :network_acl_id - (String)

        • :subnet_id - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 1710

#describe_network_interface_attribute(options = {}) ⇒ Core::Response

Calls the DescribeNetworkInterfaceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_interface_id - required - (String)

    • :description - (String)

    • :source_dest_check - (String)

    • :groups - (String)

    • :attachment - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :network_interface_id - (String)

    • :description - (Hash)

      • :value - (String)

    • :source_dest_check - (Hash)

      • :value - (Boolean)

    • :group_set - (Array<Hash>)

      • :group_name - (String)

      • :group_id - (String)

    • :attachment - (Hash)

      • :attachment_id - (String)

      • :instance_id - (String)

      • :instance_owner_id - (String)

      • :device_index - (Integer)

      • :status - (String)

      • :attach_time - (Time)

      • :delete_on_termination - (Boolean)




# File 'lib/aws/ec2/client.rb', line 1748

#describe_network_interfaces(options = {}) ⇒ Core::Response

Calls the DescribeNetworkInterfaces API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_interface_ids - (Array<String>)

    • :filters - (Array<Hash>)

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :network_interface_set - (Array<Hash>)

      • :network_interface_id - (String)

      • :subnet_id - (String)

      • :vpc_id - (String)

      • :availability_zone - (String)

      • :description - (String)

      • :owner_id - (String)

      • :requester_id - (String)

      • :requester_managed - (Boolean)

      • :status - (String)

      • :mac_address - (String)

      • :private_ip_address - (String)

      • :private_dns_name - (String)

      • :source_dest_check - (Boolean)

      • :groups - (Array<Hash>)

        • :group_name - (String)

        • :group_id - (String)

      • :attachment - (Hash)

        • :attachment_id - (String)

        • :instance_id - (String)

        • :instance_owner_id - (String)

        • :device_index - (Integer)

        • :status - (String)

        • :attach_time - (Time)

        • :delete_on_termination - (Boolean)

      • :association - (Hash)

        • :public_ip - (String)

        • :ip_owner_id - (String)

        • :allocation_id - (String)

        • :association_id - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :private_ip_addresses_set - (Array<Hash>)

        • :private_ip_address - (String)

        • :private_dns_name - (String)

        • :primary - (Boolean)

        • :association - (Hash)

          • :public_ip - (String)

          • :ip_owner_id - (String)

          • :allocation_id - (String)

          • :association_id - (String)




# File 'lib/aws/ec2/client.rb', line 1776

#describe_placement_groups(options = {}) ⇒ Core::Response

Calls the DescribePlacementGroups API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :group_names - (Array<String>) The name of the PlacementGroup.

    • :filters - (Array<Hash>) A list of filters used to match properties for Placement Groups. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :placement_group_set - (Array<Hash>)

      • :group_name - (String)

      • :strategy - (String)

      • :state - (String)




# File 'lib/aws/ec2/client.rb', line 1830

#describe_regions(options = {}) ⇒ Core::Response

Calls the DescribeRegions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :region_names - (Array<String>) The optional list of regions to describe.

    • :filters - (Array<Hash>) A list of filters used to match properties for Regions. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :region_info - (Array<Hash>)

      • :region_name - (String)

      • :region_endpoint - (String)




# File 'lib/aws/ec2/client.rb', line 1849

#describe_reserved_instances(options = {}) ⇒ Core::Response

Calls the DescribeReservedInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :reserved_instances_ids - (Array<String>) The optional list of Reserved Instance IDs to describe.

    • :filters - (Array<Hash>) A list of filters used to match properties for ReservedInstances. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

    • :offering_type - (String) The Reserved Instance offering type.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :reserved_instances_set - (Array<Hash>)

      • :reserved_instances_id - (String)

      • :instance_type - (String)

      • :availability_zone - (String)

      • :start - (Time)

      • :duration - (Integer)

      • :usage_price - (Numeric)

      • :fixed_price - (Numeric)

      • :instance_count - (Integer)

      • :product_description - (String)

      • :state - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :instance_tenancy - (String)

      • :currency_code - (String)

      • :offering_type - (String)

      • :recurring_charges - (Array<Hash>)

        • :frequency - (String)

        • :amount - (Numeric)




# File 'lib/aws/ec2/client.rb', line 1867

#describe_reserved_instances_listings(options = {}) ⇒ Core::Response

Calls the DescribeReservedInstancesListings API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :reserved_instances_id - (String)

    • :reserved_instances_listing_id - (String)

    • :filters - (Array<Hash>)

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :reserved_instances_listings_set - (Array<Hash>)

      • :reserved_instances_listing_id - (String)

      • :reserved_instances_id - (String)

      • :create_date - (Time)

      • :update_date - (Time)

      • :status - (String)

      • :status_message - (String)

      • :instance_counts - (Array<Hash>)

        • :state - (String)

        • :instance_count - (Integer)

      • :price_schedules - (Array<Hash>)

        • :term - (Integer)

        • :price - (Numeric)

        • :currency_code - (String)

        • :active - (Boolean)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :client_token - (String)




# File 'lib/aws/ec2/client.rb', line 1904

#describe_reserved_instances_offerings(options = {}) ⇒ Core::Response

Calls the DescribeReservedInstancesOfferings API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :reserved_instances_offering_ids - (Array<String>) An optional list of the unique IDs of the Reserved Instance offerings to describe.

    • :instance_type - (String) The instance type on which the Reserved Instance can be used.

    • :availability_zone - (String) The Availability Zone in which the Reserved Instance can be used.

    • :product_description - (String) The Reserved Instance product description.

    • :filters - (Array<Hash>) A list of filters used to match properties for ReservedInstancesOfferings. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

    • :instance_tenancy - (String) The tenancy of the Reserved Instance offering. A Reserved Instance with tenancy of dedicated will run on single-tenant hardware and can only be launched within a VPC.

    • :offering_type - (String) The Reserved Instance offering type.

    • :next_token - (String)

    • :max_results - (Integer)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :reserved_instances_offerings_set - (Array<Hash>)

      • :reserved_instances_offering_id - (String)

      • :instance_type - (String)

      • :availability_zone - (String)

      • :duration - (Integer)

      • :usage_price - (Numeric)

      • :fixed_price - (Numeric)

      • :product_description - (String)

      • :instance_tenancy - (String)

      • :currency_code - (String)

      • :offering_type - (String)

      • :recurring_charges - (Array<Hash>)

        • :frequency - (String)

        • :amount - (Numeric)

      • :marketplace - (Boolean)

      • :pricing_details_set - (Array<Hash>)

        • :price - (Numeric)

        • :count - (Integer)

    • :next_token - (String)




# File 'lib/aws/ec2/client.rb', line 1936

#describe_route_tables(options = {}) ⇒ Core::Response

Calls the DescribeRouteTables API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :route_table_ids - (Array<String>) One or more route table IDs.

    • :filters - (Array<Hash>) A list of filters used to match properties for Route Tables. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :route_table_set - (Array<Hash>)

      • :route_table_id - (String)

      • :vpc_id - (String)

      • :route_set - (Array<Hash>)

        • :destination_cidr_block - (String)

        • :gateway_id - (String)

        • :instance_id - (String)

        • :instance_owner_id - (String)

        • :network_interface_id - (String)

        • :state - (String)

      • :association_set - (Array<Hash>)

        • :route_table_association_id - (String)

        • :route_table_id - (String)

        • :subnet_id - (String)

        • :main - (Boolean)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :propagating_vgw_set - (Array<Hash>)

        • :gateway_id - (String)




# File 'lib/aws/ec2/client.rb', line 1984

#describe_security_groups(options = {}) ⇒ Core::Response

Calls the DescribeSecurityGroups API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :group_names - (Array<String>) The optional list of Amazon EC2 security groups to describe.

    • :group_ids - (Array<String>)

    • :filters - (Array<Hash>) A list of filters used to match properties for SecurityGroups. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :security_group_info - (Array<Hash>)

      • :owner_id - (String)

      • :group_name - (String)

      • :group_id - (String)

      • :group_description - (String)

      • :ip_permissions - (Array<Hash>)

        • :ip_protocol - (String)

        • :from_port - (Integer)

        • :to_port - (Integer)

        • :groups - (Array<Hash>)

          • :user_id - (String)

          • :group_name - (String)

          • :group_id - (String)

        • :ip_ranges - (Array<Hash>)

          • :cidr_ip - (String)

      • :ip_permissions_egress - (Array<Hash>)

        • :ip_protocol - (String)

        • :from_port - (Integer)

        • :to_port - (Integer)

        • :groups - (Array<Hash>)

          • :user_id - (String)

          • :group_name - (String)

          • :group_id - (String)

        • :ip_ranges - (Array<Hash>)

          • :cidr_ip - (String)

      • :vpc_id - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 2019

#describe_snapshot_attribute(options = {}) ⇒ Core::Response

Calls the DescribeSnapshotAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :snapshot_id - required - (String) The ID of the EBS snapshot whose attribute is being described.

    • :attribute - required - (String) The name of the EBS attribute to describe. Available attribute names: createVolumePermission

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :snapshot_id - (String)

    • :create_volume_permission - (Array<Hash>)

      • :user_id - (String)

      • :group - (String)

    • :product_codes - (Array<Hash>)

      • :product_code - (String)

      • :type - (String)




# File 'lib/aws/ec2/client.rb', line 2065

#describe_snapshots(options = {}) ⇒ Core::Response

Calls the DescribeSnapshots API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :snapshot_ids - (Array<String>) The optional list of EBS snapshot IDs to describe.

    • :owner_ids - (Array<String>) The optional list of EBS snapshot owners.

    • :restorable_by_user_ids - (Array<String>) The optional list of users who have permission to create volumes from the described EBS snapshots.

    • :filters - (Array<Hash>) A list of filters used to match properties for Snapshots. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :snapshot_set - (Array<Hash>)

      • :snapshot_id - (String)

      • :volume_id - (String)

      • :status - (String)

      • :start_time - (Time)

      • :progress - (String)

      • :owner_id - (String)

      • :description - (String)

      • :volume_size - (Integer)

      • :owner_alias - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 2083

#describe_spot_datafeed_subscription(options = {}) ⇒ Core::Response

Calls the DescribeSpotDatafeedSubscription API operation.

Parameters:

  • options (Hash) (defaults to: {})

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :spot_datafeed_subscription - (Hash)

      • :owner_id - (String)

      • :bucket - (String)

      • :prefix - (String)

      • :state - (String)

      • :fault - (Hash)

        • :code - (String)

        • :message - (String)




# File 'lib/aws/ec2/client.rb', line 2116

#describe_spot_instance_requests(options = {}) ⇒ Core::Response

Calls the DescribeSpotInstanceRequests API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :spot_instance_request_ids - (Array<String>) The ID of the request.

    • :filters - (Array<Hash>) A list of filters used to match properties for SpotInstances. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :spot_instance_request_set - (Array<Hash>)

      • :spot_instance_request_id - (String)

      • :spot_price - (String)

      • :type - (String)

      • :state - (String)

      • :fault - (Hash)

        • :code - (String)

        • :message - (String)

      • :status - (Hash)

        • :code - (String)

        • :update_time - (Time)

        • :message - (String)

      • :valid_from - (Time)

      • :valid_until - (Time)

      • :launch_group - (String)

      • :availability_zone_group - (String)

      • :launch_specification - (Hash)

        • :image_id - (String)

        • :key_name - (String)

        • :group_set - (Array<Hash>)

          • :group_name - (String)

          • :group_id - (String)

        • :user_data - (String)

        • :addressing_type - (String)

        • :instance_type - (String)

        • :placement - (Hash)

          • :availability_zone - (String)

          • :group_name - (String)

        • :kernel_id - (String)

        • :ramdisk_id - (String)

        • :block_device_mapping - (Array<Hash>)

          • :virtual_name - (String)

          • :device_name - (String)

          • :ebs - (Hash)

            • :snapshot_id - (String)

            • :volume_size - (Integer)

            • :delete_on_termination - (Boolean)

            • :volume_type - (String)

            • :iops - (Integer)

          • :no_device - (String)

        • :monitoring_enabled - (Boolean)

        • :subnet_id - (String)

        • :network_interface_set - (Array<Hash>)

          • :network_interface_id - (String)

          • :device_index - (Integer)

          • :subnet_id - (String)

          • :description - (String)

          • :private_ip_address - (String)

          • :security_group_id - (Array<String>)

          • :delete_on_termination - (Boolean)

          • :private_ip_addresses_set - (Array<Hash>)

            • :private_ip_address - (String)

            • :primary - (Boolean)

          • :secondary_private_ip_address_count - (Integer)

        • :iam_instance_profile - (Hash)

          • :arn - (String)

          • :name - (String)

        • :ebs_optimized - (Boolean)

      • :instance_id - (String)

      • :create_time - (Time)

      • :product_description - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :launched_availability_zone - (String)




# File 'lib/aws/ec2/client.rb', line 2131

#describe_spot_price_history(options = {}) ⇒ Core::Response

Calls the DescribeSpotPriceHistory API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :start_time - (String<ISO8601 datetime>) The start date and time of the Spot Instance price history data.

    • :end_time - (String<ISO8601 datetime>) The end date and time of the Spot Instance price history data.

    • :instance_types - (Array<String>) Specifies the instance type to return.

    • :product_descriptions - (Array<String>) The description of the AMI.

    • :filters - (Array<Hash>) A list of filters used to match properties for SpotPriceHistory. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

    • :availability_zone - (String) Filters the results by availability zone (ex: ‘us-east-1a’).

    • :max_results - (Integer) Specifies the number of rows to return.

    • :next_token - (String) Specifies the next set of rows to return.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :spot_price_history_set - (Array<Hash>)

      • :instance_type - (String)

      • :product_description - (String)

      • :spot_price - (String)

      • :timestamp - (Time)

      • :availability_zone - (String)

    • :next_token - (String)




# File 'lib/aws/ec2/client.rb', line 2212

#describe_subnets(options = {}) ⇒ Core::Response

Calls the DescribeSubnets API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :subnet_ids - (Array<String>) A set of one or more subnet IDs.

    • :filters - (Array<Hash>) A list of filters used to match properties for Subnets. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :subnet_set - (Array<Hash>)

      • :subnet_id - (String)

      • :state - (String)

      • :vpc_id - (String)

      • :cidr_block - (String)

      • :available_ip_address_count - (Integer)

      • :availability_zone - (String)

      • :default_for_az - (Boolean)

      • :map_public_ip_on_launch - (Boolean)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 2245

#describe_tags(options = {}) ⇒ Core::Response

Calls the DescribeTags API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :filters - (Array<Hash>) A list of filters used to match properties for tags.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :tag_set - (Array<Hash>)

      • :resource_id - (String)

      • :resource_type - (String)

      • :key - (String)

      • :value - (String)




# File 'lib/aws/ec2/client.rb', line 2271

#describe_volume_attribute(options = {}) ⇒ Core::Response

Calls the DescribeVolumeAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :volume_id - required - (String)

    • :attribute - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :volume_id - (String)

    • :auto_enable_io - (Hash)

      • :value - (Boolean)

    • :product_codes - (Array<Hash>)

      • :product_code - (String)

      • :type - (String)




# File 'lib/aws/ec2/client.rb', line 2288

#describe_volume_status(options = {}) ⇒ Core::Response

Calls the DescribeVolumeStatus API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :volume_ids - (Array<String>)

    • :filters - (Array<Hash>)

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

    • :next_token - (String)

    • :max_results - (Integer)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :volume_status_set - (Array<Hash>)

      • :volume_id - (String)

      • :availability_zone - (String)

      • :volume_status - (Hash)

        • :status - (String)

        • :details - (Array<Hash>)

          • :name - (String)

          • :status - (String)

      • :events_set - (Array<Hash>)

        • :event_type - (String)

        • :description - (String)

        • :not_before - (Time)

        • :not_after - (Time)

        • :event_id - (String)

      • :actions_set - (Array<Hash>)

        • :code - (String)

        • :description - (String)

        • :event_type - (String)

        • :event_id - (String)

    • :next_token - (String)




# File 'lib/aws/ec2/client.rb', line 2303

#describe_volumes(options = {}) ⇒ Core::Response

Calls the DescribeVolumes API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :volume_ids - (Array<String>) The optional list of EBS volumes to describe.

    • :filters - (Array<Hash>) A list of filters used to match properties for Volumes. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :volume_set - (Array<Hash>)

      • :volume_id - (String)

      • :size - (Integer)

      • :snapshot_id - (String)

      • :availability_zone - (String)

      • :status - (String)

      • :create_time - (Time)

      • :attachment_set - (Array<Hash>)

        • :volume_id - (String)

        • :instance_id - (String)

        • :device - (String)

        • :status - (String)

        • :attach_time - (Time)

        • :delete_on_termination - (Boolean)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :volume_type - (String)

      • :iops - (Integer)




# File 'lib/aws/ec2/client.rb', line 2337

#describe_vpc_attribute(options = {}) ⇒ Core::Response

Calls the DescribeVpcAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpc_id - required - (String)

    • :attribute - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :vpc_id - (String)

    • :enable_dns_support - (Hash)

      • :value - (Boolean)

    • :enable_dns_hostnames - (Hash)

      • :value - (Boolean)




# File 'lib/aws/ec2/client.rb', line 2371

#describe_vpcs(options = {}) ⇒ Core::Response

Calls the DescribeVpcs API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpc_ids - (Array<String>) The ID of a VPC you want information about.

    • :filters - (Array<Hash>) A list of filters used to match properties for VPCs. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :vpc_set - (Array<Hash>)

      • :vpc_id - (String)

      • :state - (String)

      • :cidr_block - (String)

      • :dhcp_options_id - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :instance_tenancy - (String)

      • :is_default - (Boolean)




# File 'lib/aws/ec2/client.rb', line 2385

#describe_vpn_connections(options = {}) ⇒ Core::Response

Calls the DescribeVpnConnections API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpn_connection_ids - (Array<String>) A VPN connection ID. More than one may be specified per request.

    • :filters - (Array<Hash>) A list of filters used to match properties for VPN Connections. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :vpn_connection_set - (Array<Hash>)

      • :vpn_connection_id - (String)

      • :state - (String)

      • :customer_gateway_configuration - (String)

      • :vpn_type - (String)

      • :customer_gateway_id - (String)

      • :vpn_gateway_id - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :vgw_telemetry - (Array<Hash>)

        • :outside_ip_address - (String)

        • :status - (String)

        • :last_status_change - (Time)

        • :status_message - (String)

        • :accepted_route_count - (Integer)

      • :options - (Hash)

        • :static_routes_only - (Boolean)

      • :routes - (Array<Hash>)

        • :destination_cidr_block - (String)

        • :source - (String)

        • :state - (String)




# File 'lib/aws/ec2/client.rb', line 2410

#describe_vpn_gateways(options = {}) ⇒ Core::Response

Calls the DescribeVpnGateways API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpn_gateway_ids - (Array<String>) A list of filters used to match properties for VPN Gateways. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

    • :filters - (Array<Hash>) A list of filters used to match properties for VPN Gateways. For a complete reference to the available filter keys for this operation, see the Amazon EC2 API reference.

      • :name - (String) Specifies the name of the filter.

      • :values - (Array<String>) Contains one or more values for the filter.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :vpn_gateway_set - (Array<Hash>)

      • :vpn_gateway_id - (String)

      • :state - (String)

      • :vpn_type - (String)

      • :availability_zone - (String)

      • :attachments - (Array<Hash>)

        • :vpc_id - (String)

        • :state - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 2448

#detach_internet_gateway(options = {}) ⇒ Core::Response

Calls the DetachInternetGateway API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :internet_gateway_id - required - (String) The ID of the Internet gateway to detach.

    • :vpc_id - required - (String) The ID of the VPC.

Returns:




# File 'lib/aws/ec2/client.rb', line 2477

#detach_network_interface(options = {}) ⇒ Core::Response

Calls the DetachNetworkInterface API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :attachment_id - required - (String)

    • :force - (Boolean)

Returns:




# File 'lib/aws/ec2/client.rb', line 2485

#detach_volume(options = {}) ⇒ Core::Response

Calls the DetachVolume API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :volume_id - required - (String) The ID of the volume to detach.

    • :instance_id - (String) The ID of the instance from which to detach the the specified volume.

    • :device - (String) The device name to which the volume is attached on the specified instance.

    • :force - (Boolean) Forces detachment if the previous detachment attempt did not occur cleanly (logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance will not have an opportunity to flush file system caches nor file system meta data. If you use this option, you must perform file system check and repair procedures.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :volume_id - (String)

    • :instance_id - (String)

    • :device - (String)

    • :status - (String)

    • :attach_time - (Time)

    • :delete_on_termination - (Boolean)




# File 'lib/aws/ec2/client.rb', line 2492

#detach_vpn_gateway(options = {}) ⇒ Core::Response

Calls the DetachVpnGateway API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpn_gateway_id - required - (String) The ID of the VPN gateway to detach from the VPC.

    • :vpc_id - required - (String) The ID of the VPC to detach the VPN gateway from.

Returns:




# File 'lib/aws/ec2/client.rb', line 2519

#disable_vgw_route_propagation(options = {}) ⇒ Core::Response

Calls the DisableVgwRoutePropagation API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :route_table_id - required - (String)

    • :gateway_id - required - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 2528

#disassociate_address(options = {}) ⇒ Core::Response

Calls the DisassociateAddress API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :public_ip - (String) The elastic IP address that you are disassociating from the instance.

    • :association_id - (String) Association ID corresponding to the VPC elastic IP address you want to disassociate.

Returns:




# File 'lib/aws/ec2/client.rb', line 2535

#disassociate_route_table(options = {}) ⇒ Core::Response

Calls the DisassociateRouteTable API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :association_id - required - (String) The association ID representing the current association between the route table and subnet.

Returns:




# File 'lib/aws/ec2/client.rb', line 2544

#enable_vgw_route_propagation(options = {}) ⇒ Core::Response

Calls the EnableVgwRoutePropagation API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :route_table_id - required - (String)

    • :gateway_id - required - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 2552

#enable_volume_io(options = {}) ⇒ Core::Response

Calls the EnableVolumeIO API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :volume_id - required - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 2559

#get_console_output(options = {}) ⇒ Core::Response

Calls the GetConsoleOutput API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_id - required - (String) The ID of the instance for which you want console output.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instance_id - (String)

    • :timestamp - (Time)

    • :output - (String)




# File 'lib/aws/ec2/client.rb', line 2565

#get_password_data(options = {}) ⇒ Core::Response

Calls the GetPasswordData API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_id - required - (String) The ID of the instance for which you want the Windows administrator password.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instance_id - (String)

    • :timestamp - (Time)

    • :password_data - (String)




# File 'lib/aws/ec2/client.rb', line 2577

#import_instance(options = {}) ⇒ Core::Response

Calls the ImportInstance API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :description - (String)

    • :launch_specification - (Hash)

      • :architecture - (String)

      • :security_groups - (Array<String>)

      • :additional_info - (String)

      • :user_data - (String)

      • :instance_type - (String)

      • :placement - (Hash)

        • :availability_zone - (String) The availability zone in which an Amazon EC2 instance runs.

        • :group_name - (String) The name of the PlacementGroup in which an Amazon EC2 instance runs. Placement groups are primarily used for launching High Performance Computing instances in the same group to ensure fast connection speeds.

        • :tenancy - (String) The allowed tenancy of instances launched into the VPC. A value of default means instances can be launched with any tenancy; a value of dedicated means all instances launched into the VPC will be launched as dedicated tenancy regardless of the tenancy assigned to the instance at launch.

      • :block_device_mappings - (Array<Hash>)

        • :virtual_name - (String) Specifies the virtual device name.

        • :device_name - (String) Specifies the device name (e.g., /dev/sdh).

        • :ebs - (Hash) Specifies parameters used to automatically setup Amazon EBS volumes when the instance is launched.

          • :snapshot_id - (String) The ID of the snapshot from which the volume will be created.

          • :volume_size - (Integer) The size of the volume, in gigabytes.

          • :delete_on_termination - (Boolean) Specifies whether the Amazon EBS volume is deleted on instance termination.

          • :volume_type - (String)

          • :iops - (Integer)

        • :no_device - (String) Specifies the device name to suppress during instance launch.

      • :monitoring - (Boolean)

      • :subnet_id - (String)

      • :disable_api_termination - (Boolean)

      • :instance_initiated_shutdown_behavior - (String)

      • :private_ip_address - (String)

    • :disk_images - (Array<Hash>)

      • :image - (Hash)

        • :format - required - (String)

        • :bytes - required - (Integer)

        • :import_manifest_url - required - (String)

      • :description - (String)

      • :volume - (Hash)

        • :size - required - (Integer)

    • :platform - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :conversion_task - (Hash)

      • :conversion_task_id - (String)

      • :expiration_time - (String)

      • :import_instance - (Hash)

        • :volumes - (Array<Hash>)

          • :bytes_converted - (Integer)

          • :availability_zone - (String)

          • :image - (Hash)

            • :format - (String)

            • :size - (Integer)

            • :import_manifest_url - (String)

            • :checksum - (String)

          • :volume - (Hash)

            • :size - (Integer)

            • :id - (String)

          • :status - (String)

          • :status_message - (String)

          • :description - (String)

        • :instance_id - (String)

        • :platform - (String)

        • :description - (String)

      • :import_volume - (Hash)

        • :bytes_converted - (Integer)

        • :availability_zone - (String)

        • :description - (String)

        • :image - (Hash)

          • :format - (String)

          • :size - (Integer)

          • :import_manifest_url - (String)

          • :checksum - (String)

        • :volume - (Hash)

          • :size - (Integer)

          • :id - (String)

      • :state - (String)

      • :status_message - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 2589

#import_key_pair(options = {}) ⇒ Core::Response

Calls the ImportKeyPair API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :key_name - required - (String) The unique name for the key pair.

    • :public_key_material - required - (String) The public key portion of the key pair being imported.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :key_name - (String)

    • :key_fingerprint - (String)




# File 'lib/aws/ec2/client.rb', line 2684

#import_volume(options = {}) ⇒ Core::Response

Calls the ImportVolume API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :availability_zone - (String)

    • :image - (Hash)

      • :format - required - (String)

      • :bytes - required - (Integer)

      • :import_manifest_url - required - (String)

    • :description - (String)

    • :volume - (Hash)

      • :size - required - (Integer)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :conversion_task - (Hash)

      • :conversion_task_id - (String)

      • :expiration_time - (String)

      • :import_instance - (Hash)

        • :volumes - (Array<Hash>)

          • :bytes_converted - (Integer)

          • :availability_zone - (String)

          • :image - (Hash)

            • :format - (String)

            • :size - (Integer)

            • :import_manifest_url - (String)

            • :checksum - (String)

          • :volume - (Hash)

            • :size - (Integer)

            • :id - (String)

          • :status - (String)

          • :status_message - (String)

          • :description - (String)

        • :instance_id - (String)

        • :platform - (String)

        • :description - (String)

      • :import_volume - (Hash)

        • :bytes_converted - (Integer)

        • :availability_zone - (String)

        • :description - (String)

        • :image - (Hash)

          • :format - (String)

          • :size - (Integer)

          • :import_manifest_url - (String)

          • :checksum - (String)

        • :volume - (Hash)

          • :size - (Integer)

          • :id - (String)

      • :state - (String)

      • :status_message - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)




# File 'lib/aws/ec2/client.rb', line 2697

#modify_image_attribute(options = {}) ⇒ Core::Response

Calls the ModifyImageAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :image_id - required - (String) The ID of the AMI whose attribute you want to modify.

    • :attribute - (String) The name of the AMI attribute you want to modify. Available attributes: launchPermission, productCodes

    • :operation_type - (String) The type of operation being requested. Available operation types: add, remove

    • :user_ids - (Array<String>) The AWS user ID being added to or removed from the list of users with launch permissions for this AMI. Only valid when the launchPermission attribute is being modified.

    • :user_groups - (Array<String>) The user group being added to or removed from the list of user groups with launch permissions for this AMI. Only valid when the launchPermission attribute is being modified. Available user groups: all

    • :product_codes - (Array<String>) The list of product codes being added to or removed from the specified AMI. Only valid when the productCodes attribute is being modified.

    • :value - (String) The value of the attribute being modified. Only valid when the description attribute is being modified.

    • :launch_permission - (Hash)

      • :add - (Array<Hash>)

        • :user_id - (String) The AWS user ID of the user involved in this launch permission.

        • :group - (String) The AWS group of the user involved in this launch permission. Available groups: all

      • :remove - (Array<Hash>)

        • :user_id - (String) The AWS user ID of the user involved in this launch permission.

        • :group - (String) The AWS group of the user involved in this launch permission. Available groups: all

    • :description - (Hash)

      • :value - (String) String value

Returns:




# File 'lib/aws/ec2/client.rb', line 2750

#modify_instance_attribute(options = {}) ⇒ Core::Response

Calls the ModifyInstanceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_id - required - (String) The ID of the instance whose attribute is being modified.

    • :attribute - (String) The name of the attribute being modified. Available attribute names: instanceType, kernel, ramdisk, userData, disableApiTermination, instanceInitiatedShutdownBehavior, rootDevice, blockDeviceMapping

    • :value - (String) The new value of the instance attribute being modified. Only valid when kernel, ramdisk, userData, disableApiTermination or instanceInitiateShutdownBehavior is specified as the attribute being modified.

    • :block_device_mappings - (Array<Hash>) The new block device mappings for the instance whose attributes are being modified. Only valid when blockDeviceMapping is specified as the attribute being modified.

      • :device_name - (String) The device name (e.g., /dev/sdh) at which the block device is exposed on the instance.

      • :ebs - (Hash) The EBS instance block device specification describing the EBS block device to map to the specified device name on a running instance.

        • :volume_id - (String) The ID of the EBS volume that should be mounted as a block device on an Amazon EC2 instance.

        • :delete_on_termination - (Boolean) Specifies whether the Amazon EBS volume is deleted on instance termination.

      • :virtual_name - (String) The virtual device name.

      • :no_device - (String) When set to the empty string, specifies that the device name in this object should not be mapped to any real device.

    • :source_dest_check - (Hash)

      • :value - (Boolean) Boolean value

    • :disable_api_termination - (Hash)

      • :value - (Boolean) Boolean value

    • :instance_type - (Hash)

      • :value - (String) String value

    • :kernel - (Hash)

      • :value - (String) String value

    • :ramdisk - (Hash)

      • :value - (String) String value

    • :user_data - (Hash)

      • :value - (String) String value

    • :instance_initiated_shutdown_behavior - (Hash)

      • :value - (String) String value

    • :groups - (Array<String>)

    • :ebs_optimized - (Hash)

      • :value - (Boolean) Boolean value

Returns:




# File 'lib/aws/ec2/client.rb', line 2787

#modify_network_interface_attribute(options = {}) ⇒ Core::Response

Calls the ModifyNetworkInterfaceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_interface_id - required - (String)

    • :description - (Hash)

      • :value - (String) String value

    • :source_dest_check - (Hash)

      • :value - (Boolean) Boolean value

    • :groups - (Array<String>)

    • :attachment - (Hash)

      • :attachment_id - (String)

      • :delete_on_termination - (Boolean)

Returns:




# File 'lib/aws/ec2/client.rb', line 2836

#modify_snapshot_attribute(options = {}) ⇒ Core::Response

Calls the ModifySnapshotAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :snapshot_id - required - (String) The ID of the EBS snapshot whose attributes are being modified.

    • :attribute - (String) The name of the attribute being modified. Available attribute names: createVolumePermission

    • :operation_type - (String) The operation to perform on the attribute. Available operation names: add, remove

    • :user_ids - (Array<String>) The AWS user IDs to add to or remove from the list of users that have permission to create EBS volumes from the specified snapshot. Currently supports “all”. Only valid when the createVolumePermission attribute is being modified.

    • :group_names - (Array<String>) The AWS group names to add to or remove from the list of groups that have permission to create EBS volumes from the specified snapshot. Currently supports “all”. Only valid when the createVolumePermission attribute is being modified.

    • :create_volume_permission - (Hash)

      • :add - (Array<Hash>)

        • :user_id - (String) The user ID of the user that can create volumes from the snapshot.

        • :group - (String) The group that is allowed to create volumes from the snapshot (currently supports “all”).

      • :remove - (Array<Hash>)

        • :user_id - (String) The user ID of the user that can create volumes from the snapshot.

        • :group - (String) The group that is allowed to create volumes from the snapshot (currently supports “all”).

Returns:




# File 'lib/aws/ec2/client.rb', line 2850

#modify_volume_attribute(options = {}) ⇒ Core::Response

Calls the ModifyVolumeAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :volume_id - required - (String)

    • :auto_enable_io - (Boolean)

Returns:




# File 'lib/aws/ec2/client.rb', line 2880

#modify_vpc_attribute(options = {}) ⇒ Core::Response

Calls the ModifyVpcAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :vpc_id - required - (String)

    • :enable_dns_support - (Hash)

      • :value - (Boolean) Boolean value

    • :enable_dns_hostnames - (Hash)

      • :value - (Boolean) Boolean value

Returns:




# File 'lib/aws/ec2/client.rb', line 2887

#monitor_instances(options = {}) ⇒ Core::Response

Calls the MonitorInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_ids - required - (Array<String>) The list of Amazon EC2 instances on which to enable monitoring.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instances_set - (Array<Hash>)

      • :instance_id - (String)

      • :monitoring - (Hash)

        • :state - (String)




# File 'lib/aws/ec2/client.rb', line 2897

#purchase_reserved_instances_offering(options = {}) ⇒ Core::Response

Calls the PurchaseReservedInstancesOffering API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :reserved_instances_offering_id - required - (String) The unique ID of the Reserved Instances offering being purchased.

    • :instance_count - required - (Integer) The number of Reserved Instances to purchase.

    • :limit_price - (Hash)

      • :amount - (Float)

      • :currency_code - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :reserved_instances_id - (String)




# File 'lib/aws/ec2/client.rb', line 2910

#reboot_instances(options = {}) ⇒ Core::Response

Calls the RebootInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_ids - required - (Array<String>) The list of instances to terminate.

Returns:




# File 'lib/aws/ec2/client.rb', line 2925

#register_image(options = {}) ⇒ Core::Response

Calls the RegisterImage API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :image_location - (String) The full path to your AMI manifest in Amazon S3 storage.

    • :name - (String) The name to give the new Amazon Machine Image. Constraints: 3-128 alphanumeric characters, parenthesis (()), commas (,), slashes (/), dashes (-), or underscores(_)

    • :description - (String) The description describing the new AMI.

    • :architecture - (String) The architecture of the image. Valid Values: i386, x86_64

    • :kernel_id - (String) The optional ID of a specific kernel to register with the new AMI.

    • :ramdisk_id - (String) The optional ID of a specific ramdisk to register with the new AMI. Some kernels require additional drivers at launch. Check the kernel requirements for information on whether you need to specify a RAM disk.

    • :root_device_name - (String) The root device name (e.g., /dev/sda1).

    • :block_device_mappings - (Array<Hash>) The block device mappings for the new AMI, which specify how different block devices (ex: EBS volumes and ephemeral drives) will be exposed on instances launched from the new image.

      • :virtual_name - (String) Specifies the virtual device name.

      • :device_name - (String) Specifies the device name (e.g., /dev/sdh).

      • :ebs - (Hash) Specifies parameters used to automatically setup Amazon EBS volumes when the instance is launched.

        • :snapshot_id - (String) The ID of the snapshot from which the volume will be created.

        • :volume_size - (Integer) The size of the volume, in gigabytes.

        • :delete_on_termination - (Boolean) Specifies whether the Amazon EBS volume is deleted on instance termination.

        • :volume_type - (String)

        • :iops - (Integer)

      • :no_device - (String) Specifies the device name to suppress during instance launch.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :image_id - (String)




# File 'lib/aws/ec2/client.rb', line 2932

#release_address(options = {}) ⇒ Core::Response

Calls the ReleaseAddress API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :public_ip - (String) The elastic IP address that you are releasing from your account.

    • :allocation_id - (String) The allocation ID that AWS provided when you allocated the address for use with Amazon VPC.

Returns:




# File 'lib/aws/ec2/client.rb', line 2975

#replace_network_acl_association(options = {}) ⇒ Core::Response

Calls the ReplaceNetworkAclAssociation API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :association_id - required - (String) The ID representing the current association between the original network ACL and the subnet.

    • :network_acl_id - required - (String) The ID of the new ACL to associate with the subnet.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :new_association_id - (String)




# File 'lib/aws/ec2/client.rb', line 2984

#replace_network_acl_entry(options = {}) ⇒ Core::Response

Calls the ReplaceNetworkAclEntry API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_acl_id - required - (String) ID of the ACL where the entry will be replaced.

    • :rule_number - required - (Integer) Rule number of the entry to replace.

    • :protocol - required - (String) IP protocol the rule applies to. Valid Values: tcp, udp, icmp or an IP protocol number.

    • :rule_action - required - (String) Whether to allow or deny traffic that matches the rule.

    • :egress - required - (Boolean) Whether this rule applies to egress traffic from the subnet ( true ) or ingress traffic ( false ).

    • :cidr_block - required - (String) The CIDR range to allow or deny, in CIDR notation (e.g., 172.16.0.0/24).

    • :icmp_type_code - (Hash) ICMP values.

      • :type - (Integer) For the ICMP protocol, the ICMP type. A value of -1 is a wildcard meaning all types. Required if specifying icmp for the protocol.

      • :code - (Integer) For the ICMP protocol, the ICMP code. A value of -1 is a wildcard meaning all codes. Required if specifying icmp for the protocol.

    • :port_range - (Hash) Port ranges.

      • :from - (Integer) The first port in the range. Required if specifying tcp or udp for the protocol.

      • :to - (Integer) The last port in the range. Required if specifying tcp or udp for the protocol.

Returns:




# File 'lib/aws/ec2/client.rb', line 2997

#replace_route(options = {}) ⇒ Core::Response

Calls the ReplaceRoute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :route_table_id - required - (String) The ID of the route table where the route will be replaced.

    • :destination_cidr_block - required - (String) The CIDR address block used for the destination match. For example: 0.0.0.0/0. The value you provide must match the CIDR of an existing route in the table.

    • :gateway_id - (String) The ID of a VPN or Internet gateway attached to your VPC.

    • :instance_id - (String) The ID of a NAT instance in your VPC.

    • :network_interface_id - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 3027

#replace_route_table_association(options = {}) ⇒ Core::Response

Calls the ReplaceRouteTableAssociation API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :association_id - required - (String) The ID representing the current association between the original route table and the subnet.

    • :route_table_id - required - (String) The ID of the new route table to associate with the subnet.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :new_association_id - (String)




# File 'lib/aws/ec2/client.rb', line 3042

#report_instance_status(options = {}) ⇒ Core::Response

Calls the ReportInstanceStatus API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instances - (Array<String>)

    • :status - (String)

    • :start_time - (String<ISO8601 datetime>)

    • :end_time - (String<ISO8601 datetime>)

    • :reason_codes - (Array<String>)

    • :description - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 3055

#request_spot_instances(options = {}) ⇒ Core::Response

Calls the RequestSpotInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :spot_price - required - (String) Specifies the maximum hourly price for any Spot Instance launched to fulfill the request.

    • :instance_count - (Integer) Specifies the maximum number of Spot Instances to launch.

    • :type - (String) Specifies the Spot Instance type.

    • :valid_from - (String<ISO8601 datetime>) Defines the start date of the request. If this is a one-time request, the request becomes active at this date and time and remains active until all instances launch, the request expires, or the request is canceled. If the request is persistent, the request becomes active at this date and time and remains active until it expires or is canceled.

    • :valid_until - (String<ISO8601 datetime>) End date of the request. If this is a one-time request, the request remains active until all instances launch, the request is canceled, or this date is reached. If the request is persistent, it remains active until it is canceled or this date and time is reached.

    • :launch_group - (String) Specifies the instance launch group. Launch groups are Spot Instances that launch and terminate together.

    • :availability_zone_group - (String) Specifies the Availability Zone group. When specifying the same Availability Zone group for all Spot Instance requests, all Spot Instances are launched in the same Availability Zone.

    • :launch_specification - (Hash) Specifies additional launch instance information.

      • :image_id - (String) The AMI ID.

      • :key_name - (String) The name of the key pair.

      • :user_data - (String) Optional data, specific to a user’s application, to provide in the launch request. All instances that collectively comprise the launch request have access to this data. User data is never returned through API responses.

      • :addressing_type - (String) Deprecated.

      • :instance_type - (String) Specifies the instance type.

      • :placement - (Hash) Defines a placement item.

        • :availability_zone - (String) The availability zone in which an Amazon EC2 instance runs.

        • :group_name - (String) The name of the PlacementGroup in which an Amazon EC2 instance runs. Placement groups are primarily used for launching High Performance Computing instances in the same group to ensure fast connection speeds.

      • :kernel_id - (String) Specifies the ID of the kernel to select.

      • :ramdisk_id - (String) Specifies the ID of the RAM disk to select. Some kernels require additional drivers at launch. Check the kernel requirements for information on whether or not you need to specify a RAM disk and search for the kernel ID.

      • :block_device_mappings - (Array<Hash>) Specifies how block devices are exposed to the instance. Each mapping is made up of a virtualName and a deviceName.

        • :virtual_name - (String) Specifies the virtual device name.

        • :device_name - (String) Specifies the device name (e.g., /dev/sdh).

        • :ebs - (Hash) Specifies parameters used to automatically setup Amazon EBS volumes when the instance is launched.

          • :snapshot_id - (String) The ID of the snapshot from which the volume will be created.

          • :volume_size - (Integer) The size of the volume, in gigabytes.

          • :delete_on_termination - (Boolean) Specifies whether the Amazon EBS volume is deleted on instance termination.

          • :volume_type - (String)

          • :iops - (Integer)

        • :no_device - (String) Specifies the device name to suppress during instance launch.

      • :monitoring_enabled - (Boolean) Enables monitoring for the instance.

      • :subnet_id - (String) Specifies the Amazon VPC subnet ID within which to launch the instance(s) for Amazon Virtual Private Cloud.

      • :network_interfaces - (Array<Hash>)

        • :network_interface_id - (String)

        • :device_index - (Integer)

        • :subnet_id - (String)

        • :description - (String)

        • :private_ip_address - (String)

        • :groups - (Array<String>)

        • :delete_on_termination - (Boolean)

        • :private_ip_addresses - (Array<Hash>)

          • :private_ip_address - required - (String)

          • :primary - (Boolean)

        • :secondary_private_ip_address_count - (Integer)

      • :iam_instance_profile - (Hash)

        • :arn - (String)

        • :name - (String)

      • :ebs_optimized - (Boolean)

      • :security_groups - (Array<String>)

      • :security_group_ids - (Array<String>)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :spot_instance_request_set - (Array<Hash>)

      • :spot_instance_request_id - (String)

      • :spot_price - (String)

      • :type - (String)

      • :state - (String)

      • :fault - (Hash)

        • :code - (String)

        • :message - (String)

      • :status - (Hash)

        • :code - (String)

        • :update_time - (Time)

        • :message - (String)

      • :valid_from - (Time)

      • :valid_until - (Time)

      • :launch_group - (String)

      • :availability_zone_group - (String)

      • :launch_specification - (Hash)

        • :image_id - (String)

        • :key_name - (String)

        • :group_set - (Array<Hash>)

          • :group_name - (String)

          • :group_id - (String)

        • :user_data - (String)

        • :addressing_type - (String)

        • :instance_type - (String)

        • :placement - (Hash)

          • :availability_zone - (String)

          • :group_name - (String)

        • :kernel_id - (String)

        • :ramdisk_id - (String)

        • :block_device_mapping - (Array<Hash>)

          • :virtual_name - (String)

          • :device_name - (String)

          • :ebs - (Hash)

            • :snapshot_id - (String)

            • :volume_size - (Integer)

            • :delete_on_termination - (Boolean)

            • :volume_type - (String)

            • :iops - (Integer)

          • :no_device - (String)

        • :monitoring_enabled - (Boolean)

        • :subnet_id - (String)

        • :network_interface_set - (Array<Hash>)

          • :network_interface_id - (String)

          • :device_index - (Integer)

          • :subnet_id - (String)

          • :description - (String)

          • :private_ip_address - (String)

          • :security_group_id - (Array<String>)

          • :delete_on_termination - (Boolean)

          • :private_ip_addresses_set - (Array<Hash>)

            • :private_ip_address - (String)

            • :primary - (Boolean)

          • :secondary_private_ip_address_count - (Integer)

        • :iam_instance_profile - (Hash)

          • :arn - (String)

          • :name - (String)

        • :ebs_optimized - (Boolean)

      • :instance_id - (String)

      • :create_time - (Time)

      • :product_description - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :launched_availability_zone - (String)




# File 'lib/aws/ec2/client.rb', line 3066

#reset_image_attribute(options = {}) ⇒ Core::Response

Calls the ResetImageAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :image_id - required - (String) The ID of the AMI whose attribute is being reset.

    • :attribute - required - (String) The name of the attribute being reset. Available attribute names: launchPermission

Returns:




# File 'lib/aws/ec2/client.rb', line 3223

#reset_instance_attribute(options = {}) ⇒ Core::Response

Calls the ResetInstanceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_id - required - (String) The ID of the Amazon EC2 instance whose attribute is being reset.

    • :attribute - required - (String) The name of the attribute being reset. Available attribute names: kernel, ramdisk

Returns:




# File 'lib/aws/ec2/client.rb', line 3232

#reset_network_interface_attribute(options = {}) ⇒ Core::Response

Calls the ResetNetworkInterfaceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_interface_id - required - (String)

    • :source_dest_check - (String)

Returns:




# File 'lib/aws/ec2/client.rb', line 3241

#reset_snapshot_attribute(options = {}) ⇒ Core::Response

Calls the ResetSnapshotAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :snapshot_id - required - (String) The ID of the snapshot whose attribute is being reset.

    • :attribute - required - (String) The name of the attribute being reset. Available attribute names: createVolumePermission

Returns:




# File 'lib/aws/ec2/client.rb', line 3248

#revoke_security_group_egress(options = {}) ⇒ Core::Response

Calls the RevokeSecurityGroupEgress API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :group_id - required - (String) ID of the VPC security group to modify.

    • :source_security_group_name - (String) Deprecated.

    • :source_security_group_owner_id - (String) Deprecated.

    • :ip_protocol - (String) Deprecated.

    • :from_port - (Integer) Deprecated.

    • :to_port - (Integer) Deprecated.

    • :cidr_ip - (String) Deprecated.

    • :ip_permissions - (Array<Hash>) List of IP permissions to authorize on the specified security group. Specifying permissions through IP permissions is the preferred way of authorizing permissions since it offers more flexibility and control.

      • :ip_protocol - (String) The IP protocol of this permission. Valid protocol values: tcp, udp, icmp

      • :from_port - (Integer) Start of port range for the TCP and UDP protocols, or an ICMP type number. An ICMP type number of -1 indicates a wildcard (i.e., any ICMP type number).

      • :to_port - (Integer) End of port range for the TCP and UDP protocols, or an ICMP code. An ICMP code of -1 indicates a wildcard (i.e., any ICMP code).

      • :user_id_group_pairs - (Array<Hash>) The list of AWS user IDs and groups included in this permission.

        • :user_id - (String) The AWS user ID of an account.

        • :group_name - (String) Name of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.

        • :group_id - (String) ID of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.

      • :ip_ranges - (Array<Hash>) The list of CIDR IP ranges included in this permission.

        • :cidr_ip - (String) The list of CIDR IP ranges.

Returns:




# File 'lib/aws/ec2/client.rb', line 3257

#revoke_security_group_ingress(options = {}) ⇒ Core::Response

Calls the RevokeSecurityGroupIngress API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :group_name - (String) Name of the standard (EC2) security group to modify. The group must belong to your account. Can be used instead of GroupID for standard (EC2) security groups.

    • :group_id - (String) ID of the standard (EC2) or VPC security group to modify. The group must belong to your account. Required for VPC security groups; can be used instead of GroupName for standard (EC2) security groups.

    • :source_security_group_name - (String) Deprecated

    • :source_security_group_owner_id - (String) Deprecated

    • :ip_protocol - (String) Deprecated

    • :from_port - (Integer) Deprecated

    • :to_port - (Integer) Deprecated

    • :cidr_ip - (String) Deprecated

    • :ip_permissions - (Array<Hash>) List of IP permissions to revoke on the specified security group. For an IP permission to be removed, it must exactly match one of the IP permissions you specify in this list. Specifying permissions through IP permissions is the preferred way of revoking permissions since it offers more flexibility and control.

      • :ip_protocol - (String) The IP protocol of this permission. Valid protocol values: tcp, udp, icmp

      • :from_port - (Integer) Start of port range for the TCP and UDP protocols, or an ICMP type number. An ICMP type number of -1 indicates a wildcard (i.e., any ICMP type number).

      • :to_port - (Integer) End of port range for the TCP and UDP protocols, or an ICMP code. An ICMP code of -1 indicates a wildcard (i.e., any ICMP code).

      • :user_id_group_pairs - (Array<Hash>) The list of AWS user IDs and groups included in this permission.

        • :user_id - (String) The AWS user ID of an account.

        • :group_name - (String) Name of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.

        • :group_id - (String) ID of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.

      • :ip_ranges - (Array<Hash>) The list of CIDR IP ranges included in this permission.

        • :cidr_ip - (String) The list of CIDR IP ranges.

Returns:




# File 'lib/aws/ec2/client.rb', line 3294

#run_instances(options = {}) ⇒ Core::Response

Calls the RunInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :image_id - required - (String) Unique ID of a machine image, returned by a call to DescribeImages.

    • :min_count - required - (Integer) Minimum number of instances to launch. If the value is more than Amazon EC2 can launch, no instances are launched at all.

    • :max_count - required - (Integer) Maximum number of instances to launch. If the value is more than Amazon EC2 can launch, the largest possible number above minCount will be launched instead. Between 1 and the maximum number allowed for your account (default: 20).

    • :key_name - (String) The name of the key pair.

    • :security_groups - (Array<String>) The names of the security groups into which the instances will be launched.

    • :security_group_ids - (Array<String>)

    • :user_data - (String) Specifies additional information to make available to the instance(s).

    • :instance_type - (String) Specifies the instance type for the launched instances.

    • :placement - (Hash) Specifies the placement constraints (Availability Zones) for launching the instances.

      • :availability_zone - (String) The availability zone in which an Amazon EC2 instance runs.

      • :group_name - (String) The name of the PlacementGroup in which an Amazon EC2 instance runs. Placement groups are primarily used for launching High Performance Computing instances in the same group to ensure fast connection speeds.

      • :tenancy - (String) The allowed tenancy of instances launched into the VPC. A value of default means instances can be launched with any tenancy; a value of dedicated means all instances launched into the VPC will be launched as dedicated tenancy regardless of the tenancy assigned to the instance at launch.

    • :kernel_id - (String) The ID of the kernel with which to launch the instance.

    • :ramdisk_id - (String) The ID of the RAM disk with which to launch the instance. Some kernels require additional drivers at launch. Check the kernel requirements for information on whether you need to specify a RAM disk. To find kernel requirements, go to the Resource Center and search for the kernel ID.

    • :block_device_mappings - (Array<Hash>) Specifies how block devices are exposed to the instance. Each mapping is made up of a virtualName and a deviceName.

      • :virtual_name - (String) Specifies the virtual device name.

      • :device_name - (String) Specifies the device name (e.g., /dev/sdh).

      • :ebs - (Hash) Specifies parameters used to automatically setup Amazon EBS volumes when the instance is launched.

        • :snapshot_id - (String) The ID of the snapshot from which the volume will be created.

        • :volume_size - (Integer) The size of the volume, in gigabytes.

        • :delete_on_termination - (Boolean) Specifies whether the Amazon EBS volume is deleted on instance termination.

        • :volume_type - (String)

        • :iops - (Integer)

      • :no_device - (String) Specifies the device name to suppress during instance launch.

    • :monitoring - (Hash) Enables monitoring for the instance.

      • :enabled - required - (Boolean)

    • :subnet_id - (String) Specifies the subnet ID within which to launch the instance(s) for Amazon Virtual Private Cloud.

    • :disable_api_termination - (Boolean) Specifies whether the instance can be terminated using the APIs. You must modify this attribute before you can terminate any “locked” instances from the APIs.

    • :instance_initiated_shutdown_behavior - (String) Specifies whether the instance’s Amazon EBS volumes are stopped or terminated when the instance is shut down.

    • :license - (Hash) Specifies active licenses in use and attached to an Amazon EC2 instance.

      • :pool - (String) The license pool from which to take a license when starting Amazon EC2 instances in the associated RunInstances request.

    • :private_ip_address - (String) If you’re using Amazon Virtual Private Cloud, you can optionally use this parameter to assign the instance a specific available IP address from the subnet.

    • :client_token - (String) Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, go to How to Ensure Idempotency in the Amazon Elastic Compute Cloud User Guide.

    • :additional_info - (String)

    • :network_interfaces - (Array<Hash>)

      • :network_interface_id - (String)

      • :device_index - (Integer)

      • :subnet_id - (String)

      • :description - (String)

      • :private_ip_address - (String)

      • :groups - (Array<String>)

      • :delete_on_termination - (Boolean)

      • :private_ip_addresses - (Array<Hash>)

        • :private_ip_address - required - (String)

        • :primary - (Boolean)

      • :secondary_private_ip_address_count - (Integer)

    • :iam_instance_profile - (Hash)

      • :arn - (String)

      • :name - (String)

    • :ebs_optimized - (Boolean)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :reservation_id - (String)

    • :owner_id - (String)

    • :requester_id - (String)

    • :group_set - (Array<Hash>)

      • :group_name - (String)

      • :group_id - (String)

    • :instances_set - (Array<Hash>)

      • :instance_id - (String)

      • :image_id - (String)

      • :instance_state - (Hash)

        • :code - (Integer)

        • :name - (String)

      • :private_dns_name - (String)

      • :dns_name - (String)

      • :reason - (String)

      • :key_name - (String)

      • :ami_launch_index - (Integer)

      • :product_codes - (Array<Hash>)

        • :product_code - (String)

        • :type - (String)

      • :instance_type - (String)

      • :launch_time - (Time)

      • :placement - (Hash)

        • :availability_zone - (String)

        • :group_name - (String)

        • :tenancy - (String)

      • :kernel_id - (String)

      • :ramdisk_id - (String)

      • :platform - (String)

      • :monitoring - (Hash)

        • :state - (String)

      • :subnet_id - (String)

      • :vpc_id - (String)

      • :private_ip_address - (String)

      • :ip_address - (String)

      • :state_reason - (Hash)

        • :code - (String)

        • :message - (String)

      • :architecture - (String)

      • :root_device_type - (String)

      • :root_device_name - (String)

      • :block_device_mapping - (Array<Hash>)

        • :device_name - (String)

        • :ebs - (Hash)

          • :volume_id - (String)

          • :status - (String)

          • :attach_time - (Time)

          • :delete_on_termination - (Boolean)

      • :virtualization_type - (String)

      • :instance_lifecycle - (String)

      • :spot_instance_request_id - (String)

      • :license - (Hash)

        • :pool - (String)

      • :client_token - (String)

      • :tag_set - (Array<Hash>)

        • :key - (String)

        • :value - (String)

      • :group_set - (Array<Hash>)

        • :group_name - (String)

        • :group_id - (String)

      • :source_dest_check - (Boolean)

      • :hypervisor - (String)

      • :network_interface_set - (Array<Hash>)

        • :network_interface_id - (String)

        • :subnet_id - (String)

        • :vpc_id - (String)

        • :description - (String)

        • :owner_id - (String)

        • :status - (String)

        • :private_ip_address - (String)

        • :private_dns_name - (String)

        • :source_dest_check - (Boolean)

        • :group_set - (Array<Hash>)

          • :group_name - (String)

          • :group_id - (String)

        • :attachment - (Hash)

          • :attachment_id - (String)

          • :device_index - (Integer)

          • :status - (String)

          • :attach_time - (Time)

          • :delete_on_termination - (Boolean)

        • :association - (Hash)

          • :public_ip - (String)

          • :public_dns_name - (String)

          • :ip_owner_id - (String)

        • :private_ip_addresses_set - (Array<Hash>)

          • :private_ip_address - (String)

          • :private_dns_name - (String)

          • :primary - (Boolean)

          • :association - (Hash)

            • :public_ip - (String)

            • :public_dns_name - (String)

            • :ip_owner_id - (String)

      • :iam_instance_profile - (Hash)

        • :arn - (String)

        • :id - (String)

      • :ebs_optimized - (Boolean)




# File 'lib/aws/ec2/client.rb', line 3338

#start_instances(options = {}) ⇒ Core::Response

Calls the StartInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_ids - required - (Array<String>) The list of Amazon EC2 instances to start.

    • :additional_info - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instances_set - (Array<Hash>)

      • :instance_id - (String)

      • :current_state - (Hash)

        • :code - (Integer)

        • :name - (String)

      • :previous_state - (Hash)

        • :code - (Integer)

        • :name - (String)




# File 'lib/aws/ec2/client.rb', line 3538

#stop_instances(options = {}) ⇒ Core::Response

Calls the StopInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_ids - required - (Array<String>) The list of Amazon EC2 instances to stop.

    • :force - (Boolean) Forces the instance to stop. The instance will not have an opportunity to flush file system caches nor file system meta data. If you use this option, you must perform file system check and repair procedures. This option is not recommended for Windows instances.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instances_set - (Array<Hash>)

      • :instance_id - (String)

      • :current_state - (Hash)

        • :code - (Integer)

        • :name - (String)

      • :previous_state - (Hash)

        • :code - (Integer)

        • :name - (String)




# File 'lib/aws/ec2/client.rb', line 3556

#terminate_instances(options = {}) ⇒ Core::Response

Calls the TerminateInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_ids - required - (Array<String>) The list of instances to terminate.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instances_set - (Array<Hash>)

      • :instance_id - (String)

      • :current_state - (Hash)

        • :code - (Integer)

        • :name - (String)

      • :previous_state - (Hash)

        • :code - (Integer)

        • :name - (String)




# File 'lib/aws/ec2/client.rb', line 3578

#unassign_private_ip_addresses(options = {}) ⇒ Core::Response

Calls the UnassignPrivateIpAddresses API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :network_interface_id - required - (String)

    • :private_ip_addresses - required - (Array<String>)

Returns:




# File 'lib/aws/ec2/client.rb', line 3595

#unmonitor_instances(options = {}) ⇒ Core::Response

Calls the UnmonitorInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :instance_ids - required - (Array<String>) The list of Amazon EC2 instances on which to disable monitoring.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :instances_set - (Array<Hash>)

      • :instance_id - (String)

      • :monitoring - (Hash)

        • :state - (String)




# File 'lib/aws/ec2/client.rb', line 3602