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

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. Valid values include:
      • vpc
      • standard

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)
    • :secondary_private_ip_address_count - (Integer)
    • :allow_reassignment - (Boolean)

Returns:




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

#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 93

#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 110

#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 120

#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 131

#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 139

#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 150

#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 171

#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) 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) 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) 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 185

#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) 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) 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) 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 222

#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 264

#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 306

#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 332

#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 339

#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)
      • :reserved_instances_listing_id - (String)
      • :reserved_instances_id - (String)
      • :create_date - (Time)
      • :update_date - (Time)
      • :status - (String)
      • :status_message - (String)
      • :instance_counts - (Array)
      • :state - (String)
      • :instance_count - (Integer)
      • :price_schedules - (Array)
      • :term - (Integer)
      • :price - (Numeric)
      • :currency_code - (String)
      • :active - (Boolean)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)
      • :client_token - (String)



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

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

Calls the CancelSpotInstanceRequests API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :spot_instance_request_ids - required - (Array) 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)
      • :spot_instance_request_id - (String)
      • :state - (String)



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

#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 384

#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 396

#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 409

#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)
      • :key - (String)
      • :value - (String)



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

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

Calls the CreateDhcpOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :dhcp_configurations - required - (Array) A set of one or more DHCP configurations.
      • :key - (String) Contains the name of a DHCP option.
      • :values - (Array) 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)
      • :key - (String)
      • :value_set - (Array)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

#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)
      • :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) Valid values include:
        • standard
        • io1
      • :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 463

#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) Valid values include:
      • citrix
      • vmware
    • :export_to_s3_task - (Hash)
      • :disk_image_format - (String) Valid values include:
      • vmdk
      • vhd
      • :container_format - (String) Valid values include:
      • ova
      • :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 501

#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)
      • :vpc_id - (String)
      • :state - (String)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

#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 549

#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)
      • :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)
      • :network_acl_association_id - (String)
      • :network_acl_id - (String)
      • :subnet_id - (String)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

#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. Valid values include:
      • allow
      • deny
    • :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 594

#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)
    • :private_ip_addresses - (Array)
      • :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)
      • :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)
      • :key - (String)
      • :value - (String)
      • :private_ip_addresses_set - (Array)
      • :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 627

#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. Valid values include:
      • cluster

Returns:




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

#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)
      • :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)
      • :reserved_instances_listing_id - (String)
      • :reserved_instances_id - (String)
      • :create_date - (Time)
      • :update_date - (Time)
      • :status - (String)
      • :status_message - (String)
      • :instance_counts - (Array)
      • :state - (String)
      • :instance_count - (Integer)
      • :price_schedules - (Array)
      • :term - (Integer)
      • :price - (Numeric)
      • :currency_code - (String)
      • :active - (Boolean)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)
      • :client_token - (String)



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

#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 727

#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)
      • :destination_cidr_block - (String)
      • :gateway_id - (String)
      • :instance_id - (String)
      • :instance_owner_id - (String)
      • :network_interface_id - (String)
      • :state - (String)
      • :association_set - (Array)
      • :route_table_association_id - (String)
      • :route_table_id - (String)
      • :subnet_id - (String)
      • :main - (Boolean)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)
      • :propagating_vgw_set - (Array)
      • :gateway_id - (String)



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

#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 772

#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)
      • :key - (String)
      • :value - (String)



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

#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 806

#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)
      • :key - (String)
      • :value - (String)



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

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

Calls the CreateTags API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :resources - required - (Array) 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) 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 850

#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) Valid values include:
      • standard
      • io1
    • :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)
      • :volume_id - (String)
      • :instance_id - (String)
      • :device - (String)
      • :status - (String)
      • :attach_time - (Time)
      • :delete_on_termination - (Boolean)
    • :tag_set - (Array)
      • :key - (String)
      • :value - (String)
    • :volume_type - (String)
    • :iops - (Integer)



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

#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)
      • :key - (String)
      • :value - (String)
      • :instance_tenancy - (String)
      • :is_default - (Boolean)



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

#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)
      • :key - (String)
      • :value - (String)
      • :vgw_telemetry - (Array)
      • :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)
      • :destination_cidr_block - (String)
      • :source - (String)
      • :state - (String)



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

#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 956

#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)
      • :vpc_id - (String)
      • :state - (String)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

#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 985

#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 994

#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 1001

#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 1008

#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 1015

#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 1022

#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 1029

#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 1039

#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 1045

#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 1052

#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 1062

#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 1069

#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 1078

#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 1085

#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 1090

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

Calls the DeleteTags API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :resources - required - (Array) 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) 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 1097

#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 1111

#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 1118

#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 1125

#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 1132

#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 1139

#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 1146

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

Calls the DescribeAccountAttributes API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :attribute_names - (Array)

Returns:

  • (Core::Response) —

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

    • :account_attribute_set - (Array)
      • :attribute_name - (String)
      • :attribute_value_set - (Array)
      • :attribute_value - (String)



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

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

Calls the DescribeAddresses API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :public_ips - (Array) The optional list of Elastic IP addresses to describe.
    • :filters - (Array) 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) Contains one or more values for the filter.
    • :allocation_ids - (Array)

Returns:

  • (Core::Response) —

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

    • :addresses_set - (Array)
      • :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 1165

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

Calls the DescribeAvailabilityZones API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :zone_names - (Array) A list of the availability zone names to describe.
    • :filters - (Array) 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) 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)
      • :zone_name - (String)
      • :zone_state - (String)
      • :region_name - (String)
      • :message_set - (Array)
      • :message - (String)



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

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

Calls the DescribeBundleTasks API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :bundle_ids - (Array) The list of bundle task IDs to describe.
    • :filters - (Array) 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) 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)
      • :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 1212

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

Calls the DescribeConversionTasks API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :filters - (Array)
      • :name - (String) Specifies the name of the filter.
      • :values - (Array) Contains one or more values for the filter.
    • :conversion_task_ids - (Array)

Returns:

  • (Core::Response) —

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

    • :conversion_tasks - (Array)
      • :conversion_task_id - (String)
      • :expiration_time - (String)
      • :import_instance - (Hash)
      • :volumes - (Array)
        • :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)
      • :key - (String)
      • :value - (String)



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

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

Calls the DescribeCustomerGateways API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :customer_gateway_ids - (Array) A set of one or more customer gateway IDs.
    • :filters - (Array) 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) 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)
      • :customer_gateway_id - (String)
      • :state - (String)
      • :vpn_type - (String)
      • :ip_address - (String)
      • :bgp_asn - (String)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

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

Calls the DescribeDhcpOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :dhcp_options_ids - (Array)
    • :filters - (Array) 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) 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)
      • :dhcp_options_id - (String)
      • :dhcp_configuration_set - (Array)
      • :key - (String)
      • :value_set - (Array)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

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

Calls the DescribeExportTasks API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :export_task_ids - (Array)

Returns:

  • (Core::Response) —

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

    • :export_task_set - (Array)
      • :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 1343

#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)
      • :user_id - (String)
      • :group - (String)
    • :product_codes - (Array)
      • :product_code - (String)
      • :type - (String)
    • :kernel - (Hash)
      • :value - (String)
    • :ramdisk - (Hash)
      • :value - (String)
    • :description - (Hash)
      • :value - (String)
    • :block_device_mapping - (Array)
      • :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 1364

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

Calls the DescribeImages API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :image_ids - (Array) An optional list of the AMI IDs to describe. If not specified, all AMIs will be described.
    • :owners - (Array) 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) 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) 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) 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)
      • :image_id - (String)
      • :image_location - (String)
      • :image_state - (String)
      • :image_owner_id - (String)
      • :is_public - (Boolean)
      • :product_codes - (Array)
      • :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)
      • :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)
      • :key - (String)
      • :value - (String)
      • :hypervisor - (String)



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

#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 Valid values include:
      • instanceType
      • kernel
      • ramdisk
      • userData
      • disableApiTermination
      • instanceInitiatedShutdownBehavior
      • rootDeviceName
      • blockDeviceMapping
      • productCodes
      • sourceDestCheck
      • groupSet
      • ebsOptimized

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)
      • :device_name - (String)
      • :ebs - (Hash)
      • :volume_id - (String)
      • :status - (String)
      • :attach_time - (Time)
      • :delete_on_termination - (Boolean)
    • :product_codes - (Array)
      • :product_code - (String)
      • :type - (String)
    • :ebs_optimized - (Hash)
      • :value - (Boolean)



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

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

Calls the DescribeInstanceStatus API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_ids - (Array) The list of instance IDs. If not specified, all instances are described.
    • :filters - (Array) The list of filters to limit returned results.
      • :name - (String) Specifies the name of the filter.
      • :values - (Array) 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)
      • :instance_id - (String)
      • :availability_zone - (String)
      • :events_set - (Array)
      • :code - (String)
      • :description - (String)
      • :not_before - (Time)
      • :not_after - (Time)
      • :instance_state - (Hash)
      • :code - (Integer)
      • :name - (String)
      • :system_status - (Hash)
      • :status - (String)
      • :details - (Array)
        • :name - (String)
        • :status - (String)
        • :impaired_since - (Time)
      • :instance_status - (Hash)
      • :status - (String)
      • :details - (Array)
        • :name - (String)
        • :status - (String)
        • :impaired_since - (Time)
    • :next_token - (String)



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

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

Calls the DescribeInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_ids - (Array) An optional list of the instances to describe.
    • :filters - (Array) 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) 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)
      • :reservation_id - (String)
      • :owner_id - (String)
      • :requester_id - (String)
      • :group_set - (Array)
      • :group_name - (String)
      • :group_id - (String)
      • :instances_set - (Array)
      • :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)
        • :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)
        • :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)
        • :key - (String)
        • :value - (String)
      • :group_set - (Array)
        • :group_name - (String)
        • :group_id - (String)
      • :source_dest_check - (Boolean)
      • :hypervisor - (String)
      • :network_interface_set - (Array)
        • :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)
        • :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)
        • :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 1555

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

Calls the DescribeInternetGateways API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :internet_gateway_ids - (Array) One or more Internet gateway IDs.
    • :filters - (Array) 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) 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)
      • :internet_gateway_id - (String)
      • :attachment_set - (Array)
      • :vpc_id - (String)
      • :state - (String)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

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

Calls the DescribeKeyPairs API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :key_names - (Array) The optional list of key pair names to describe.
    • :filters - (Array) 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) 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)
      • :key_name - (String)
      • :key_fingerprint - (String)



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

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

Calls the DescribeLicenses API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :license_ids - (Array) Specifies the license registration for which details are to be returned.
    • :filters - (Array) 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) 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)
      • :license_id - (String)
      • :type - (String)
      • :pool - (String)
      • :capacity_set - (Array)
      • :capacity - (Integer)
      • :instance_capacity - (Integer)
      • :state - (String)
      • :earliest_allowed_deactivation_time - (Time)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

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

Calls the DescribeNetworkAcls API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :network_acl_ids - (Array) One or more network ACL IDs.
    • :filters - (Array) 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) 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)
      • :network_acl_id - (String)
      • :vpc_id - (String)
      • :default - (Boolean)
      • :entry_set - (Array)
      • :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)
      • :network_acl_association_id - (String)
      • :network_acl_id - (String)
      • :subnet_id - (String)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

#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)
      • :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 1775

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

Calls the DescribeNetworkInterfaces API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :network_interface_ids - (Array)
    • :filters - (Array)
      • :name - (String) Specifies the name of the filter.
      • :values - (Array) 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)
      • :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)
      • :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)
      • :key - (String)
      • :value - (String)
      • :private_ip_addresses_set - (Array)
      • :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 1803

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

Calls the DescribePlacementGroups API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_names - (Array) The name of the PlacementGroup.
    • :filters - (Array) 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) 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)
      • :group_name - (String)
      • :strategy - (String)
      • :state - (String)



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

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

Calls the DescribeRegions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :region_names - (Array) The optional list of regions to describe.
    • :filters - (Array) 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) 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)
      • :region_name - (String)
      • :region_endpoint - (String)



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

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

Calls the DescribeReservedInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :reserved_instances_ids - (Array) The optional list of Reserved Instance IDs to describe.
    • :filters - (Array) 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) 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)
      • :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)
      • :key - (String)
      • :value - (String)
      • :instance_tenancy - (String)
      • :currency_code - (String)
      • :offering_type - (String)
      • :recurring_charges - (Array)
      • :frequency - (String)
      • :amount - (Numeric)



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

#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)
      • :name - (String) Specifies the name of the filter.
      • :values - (Array) 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)
      • :reserved_instances_listing_id - (String)
      • :reserved_instances_id - (String)
      • :create_date - (Time)
      • :update_date - (Time)
      • :status - (String)
      • :status_message - (String)
      • :instance_counts - (Array)
      • :state - (String)
      • :instance_count - (Integer)
      • :price_schedules - (Array)
      • :term - (Integer)
      • :price - (Numeric)
      • :currency_code - (String)
      • :active - (Boolean)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)
      • :client_token - (String)



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

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

Calls the DescribeReservedInstancesOfferings API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :reserved_instances_offering_ids - (Array) 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. Valid values include:
      • t1.micro
      • m1.small
      • m1.medium
      • m1.large
      • m1.xlarge
      • m2.xlarge
      • m2.2xlarge
      • m2.4xlarge
      • m3.xlarge
      • m3.2xlarge
      • c1.medium
      • c1.xlarge
      • hi1.4xlarge
      • hs1.8xlarge
      • cc1.4xlarge
      • cc2.8xlarge
      • cg1.4xlarge
    • :availability_zone - (String) The Availability Zone in which the Reserved Instance can be used.
    • :product_description - (String) The Reserved Instance product description.
    • :filters - (Array) 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) 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)
      • :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)
      • :frequency - (String)
      • :amount - (Numeric)
      • :marketplace - (Boolean)
      • :pricing_details_set - (Array)
      • :price - (Numeric)
      • :count - (Integer)
    • :next_token - (String)



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

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

Calls the DescribeRouteTables API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :route_table_ids - (Array) One or more route table IDs.
    • :filters - (Array) 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) 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)
      • :route_table_id - (String)
      • :vpc_id - (String)
      • :route_set - (Array)
      • :destination_cidr_block - (String)
      • :gateway_id - (String)
      • :instance_id - (String)
      • :instance_owner_id - (String)
      • :network_interface_id - (String)
      • :state - (String)
      • :association_set - (Array)
      • :route_table_association_id - (String)
      • :route_table_id - (String)
      • :subnet_id - (String)
      • :main - (Boolean)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)
      • :propagating_vgw_set - (Array)
      • :gateway_id - (String)



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

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

Calls the DescribeSecurityGroups API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :group_names - (Array) The optional list of Amazon EC2 security groups to describe.
    • :group_ids - (Array)
    • :filters - (Array) 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) 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)
      • :owner_id - (String)
      • :group_name - (String)
      • :group_id - (String)
      • :group_description - (String)
      • :ip_permissions - (Array)
      • :ip_protocol - (String)
      • :from_port - (Integer)
      • :to_port - (Integer)
      • :groups - (Array)
        • :user_id - (String)
        • :group_name - (String)
        • :group_id - (String)
      • :ip_ranges - (Array)
        • :cidr_ip - (String)
      • :ip_permissions_egress - (Array)
      • :ip_protocol - (String)
      • :from_port - (Integer)
      • :to_port - (Integer)
      • :groups - (Array)
        • :user_id - (String)
        • :group_name - (String)
        • :group_id - (String)
      • :ip_ranges - (Array)
        • :cidr_ip - (String)
      • :vpc_id - (String)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

#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 Valid values include:
      • productCodes
      • 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)
      • :user_id - (String)
      • :group - (String)
    • :product_codes - (Array)
      • :product_code - (String)
      • :type - (String)



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

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

Calls the DescribeSnapshots API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :snapshot_ids - (Array) The optional list of EBS snapshot IDs to describe.
    • :owner_ids - (Array) The optional list of EBS snapshot owners.
    • :restorable_by_user_ids - (Array) The optional list of users who have permission to create volumes from the described EBS snapshots.
    • :filters - (Array) 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) 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)
      • :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)
      • :key - (String)
      • :value - (String)



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

#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 2163

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

Calls the DescribeSpotInstanceRequests API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :spot_instance_request_ids - (Array) The ID of the request.
    • :filters - (Array) 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) 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)
      • :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)
        • :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)
        • :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)
        • :network_interface_id - (String)
        • :device_index - (Integer)
        • :subnet_id - (String)
        • :description - (String)
        • :private_ip_address - (String)
        • :security_group_id - (Array)
        • :delete_on_termination - (Boolean)
        • :private_ip_addresses_set - (Array)
        • :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)
      • :key - (String)
      • :value - (String)
      • :launched_availability_zone - (String)



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

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

Calls the DescribeSpotPriceHistory API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :start_time - (String) The start date and time of the Spot Instance price history data.
    • :end_time - (String) The end date and time of the Spot Instance price history data.
    • :instance_types - (Array) Specifies the instance type to return.
    • :product_descriptions - (Array) The description of the AMI.
    • :filters - (Array) 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) 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)
      • :instance_type - (String)
      • :product_description - (String)
      • :spot_price - (String)
      • :timestamp - (Time)
      • :availability_zone - (String)
    • :next_token - (String)



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

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

Calls the DescribeSubnets API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :subnet_ids - (Array) A set of one or more subnet IDs.
    • :filters - (Array) 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) 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)
      • :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)
      • :key - (String)
      • :value - (String)



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

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

Calls the DescribeTags API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :filters - (Array) A list of filters used to match properties for tags.
      • :name - (String) Specifies the name of the filter.
      • :values - (Array) 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)
      • :resource_id - (String)
      • :resource_type - (String)
      • :key - (String)
      • :value - (String)



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

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

Calls the DescribeVolumeAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :volume_id - required - (String)
    • :attribute - (String) Valid values include:
      • autoEnableIO
      • productCodes

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)
      • :product_code - (String)
      • :type - (String)



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

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

Calls the DescribeVolumeStatus API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :volume_ids - (Array)
    • :filters - (Array)
      • :name - (String) Specifies the name of the filter.
      • :values - (Array) 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)
      • :volume_id - (String)
      • :availability_zone - (String)
      • :volume_status - (Hash)
      • :status - (String)
      • :details - (Array)
        • :name - (String)
        • :status - (String)
      • :events_set - (Array)
      • :event_type - (String)
      • :description - (String)
      • :not_before - (Time)
      • :not_after - (Time)
      • :event_id - (String)
      • :actions_set - (Array)
      • :code - (String)
      • :description - (String)
      • :event_type - (String)
      • :event_id - (String)
    • :next_token - (String)



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

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

Calls the DescribeVolumes API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :volume_ids - (Array) The optional list of EBS volumes to describe.
    • :filters - (Array) 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) 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)
      • :volume_id - (String)
      • :size - (Integer)
      • :snapshot_id - (String)
      • :availability_zone - (String)
      • :status - (String)
      • :create_time - (Time)
      • :attachment_set - (Array)
      • :volume_id - (String)
      • :instance_id - (String)
      • :device - (String)
      • :status - (String)
      • :attach_time - (Time)
      • :delete_on_termination - (Boolean)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)
      • :volume_type - (String)
      • :iops - (Integer)



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

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

Calls the DescribeVpcAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :vpc_id - required - (String)
    • :attribute - (String) Valid values include:
      • enableDnsSupport
      • enableDnsHostnames

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 2420

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

Calls the DescribeVpcs API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :vpc_ids - (Array) The ID of a VPC you want information about.
    • :filters - (Array) 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) 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)
      • :vpc_id - (String)
      • :state - (String)
      • :cidr_block - (String)
      • :dhcp_options_id - (String)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)
      • :instance_tenancy - (String)
      • :is_default - (Boolean)



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

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

Calls the DescribeVpnConnections API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :vpn_connection_ids - (Array) A VPN connection ID. More than one may be specified per request.
    • :filters - (Array) 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) 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)
      • :vpn_connection_id - (String)
      • :state - (String)
      • :customer_gateway_configuration - (String)
      • :vpn_type - (String)
      • :customer_gateway_id - (String)
      • :vpn_gateway_id - (String)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)
      • :vgw_telemetry - (Array)
      • :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)
      • :destination_cidr_block - (String)
      • :source - (String)
      • :state - (String)



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

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

Calls the DescribeVpnGateways API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :vpn_gateway_ids - (Array) 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) 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) 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)
      • :vpn_gateway_id - (String)
      • :state - (String)
      • :vpn_type - (String)
      • :availability_zone - (String)
      • :attachments - (Array)
      • :vpc_id - (String)
      • :state - (String)
      • :tag_set - (Array)
      • :key - (String)
      • :value - (String)



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

#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 2528

#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 2536

#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 2543

#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 2570

#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 2579

#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 2586

#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 2595

#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 2603

#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 2610

#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 2616

#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 2628

#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)
      • :additional_info - (String)
      • :user_data - (String)
      • :instance_type - (String) Valid values include:
      • t1.micro
      • m1.small
      • m1.medium
      • m1.large
      • m1.xlarge
      • m2.xlarge
      • m2.2xlarge
      • m2.4xlarge
      • m3.xlarge
      • m3.2xlarge
      • c1.medium
      • c1.xlarge
      • hi1.4xlarge
      • hs1.8xlarge
      • cc1.4xlarge
      • cc2.8xlarge
      • cg1.4xlarge
      • :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)
      • :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) Valid values include:
        • standard
        • io1
        • :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)
      • :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)
        • :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)
      • :key - (String)
      • :value - (String)



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

#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 2754

#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)
        • :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)
      • :key - (String)
      • :value - (String)



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

#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) 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) 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) 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)
      • :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)
      • :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 2820

#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 Valid values include:
      • instanceType
      • kernel
      • ramdisk
      • userData
      • disableApiTermination
      • instanceInitiatedShutdownBehavior
      • rootDeviceName
      • blockDeviceMapping
      • productCodes
      • sourceDestCheck
      • groupSet
      • ebsOptimized
    • :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) 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)
    • :ebs_optimized - (Hash)
      • :value - (Boolean) Boolean value

Returns:




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

#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)
    • :attachment - (Hash)
      • :attachment_id - (String)
      • :delete_on_termination - (Boolean)

Returns:




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

#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 Valid values include:
      • productCodes
      • createVolumePermission
    • :operation_type - (String) The operation to perform on the attribute. Available operation names: add, remove
    • :user_ids - (Array) 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) 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)
      • :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)
      • :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 2932

#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 2965

#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 2972

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

Calls the MonitorInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_ids - required - (Array) 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)
      • :instance_id - (String)
      • :monitoring - (Hash)
      • :state - (String)



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

#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 2995

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

Calls the RebootInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_ids - required - (Array) The list of instances to terminate.

Returns:




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

#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) 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) Valid values include:
        • standard
        • io1
      • :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 3017

#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 3062

#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 3071

#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. Valid values include:
      • allow
      • deny
    • :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 3084

#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 3116

#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 3131

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

Calls the ReportInstanceStatus API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instances - (Array)
    • :status - (String)
    • :start_time - (String)
    • :end_time - (String)
    • :reason_codes - (Array)
    • :description - (String)

Returns:




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

#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 values include:
      • one-time
      • persistent
    • :valid_from - (String) 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) 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. Valid values include:
      • t1.micro
      • m1.small
      • m1.medium
      • m1.large
      • m1.xlarge
      • m2.xlarge
      • m2.2xlarge
      • m2.4xlarge
      • m3.xlarge
      • m3.2xlarge
      • c1.medium
      • c1.xlarge
      • hi1.4xlarge
      • hs1.8xlarge
      • cc1.4xlarge
      • cc2.8xlarge
      • cg1.4xlarge
      • :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) 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) Valid values include:
        • standard
        • io1
        • :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)
      • :network_interface_id - (String)
      • :device_index - (Integer)
      • :subnet_id - (String)
      • :description - (String)
      • :private_ip_address - (String)
      • :groups - (Array)
      • :delete_on_termination - (Boolean)
      • :private_ip_addresses - (Array)
        • :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)
      • :security_group_ids - (Array)

Returns:

  • (Core::Response) —

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

    • :spot_instance_request_set - (Array)
      • :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)
        • :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)
        • :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)
        • :network_interface_id - (String)
        • :device_index - (Integer)
        • :subnet_id - (String)
        • :description - (String)
        • :private_ip_address - (String)
        • :security_group_id - (Array)
        • :delete_on_termination - (Boolean)
        • :private_ip_addresses_set - (Array)
        • :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)
      • :key - (String)
      • :value - (String)
      • :launched_availability_zone - (String)



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

#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 3335

#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 Valid values include:
      • instanceType
      • kernel
      • ramdisk
      • userData
      • disableApiTermination
      • instanceInitiatedShutdownBehavior
      • rootDeviceName
      • blockDeviceMapping
      • productCodes
      • sourceDestCheck
      • groupSet
      • ebsOptimized

Returns:




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

#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 3366

#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 Valid values include:
      • productCodes
      • createVolumePermission

Returns:




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

#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) 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) 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) 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 3385

#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) 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) 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) 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 3422

#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) The names of the security groups into which the instances will be launched.
    • :security_group_ids - (Array)
    • :user_data - (String) Specifies additional information to make available to the instance(s).
    • :instance_type - (String) Specifies the instance type for the launched instances. Valid values include:
      • t1.micro
      • m1.small
      • m1.medium
      • m1.large
      • m1.xlarge
      • m2.xlarge
      • m2.2xlarge
      • m2.4xlarge
      • m3.xlarge
      • m3.2xlarge
      • c1.medium
      • c1.xlarge
      • hi1.4xlarge
      • hs1.8xlarge
      • cc1.4xlarge
      • cc2.8xlarge
      • cg1.4xlarge
    • :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) 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) Valid values include:
        • standard
        • io1
      • :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)
      • :network_interface_id - (String)
      • :device_index - (Integer)
      • :subnet_id - (String)
      • :description - (String)
      • :private_ip_address - (String)
      • :groups - (Array)
      • :delete_on_termination - (Boolean)
      • :private_ip_addresses - (Array)
      • :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)
      • :group_name - (String)
      • :group_id - (String)
    • :instances_set - (Array)
      • :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)
      • :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)
      • :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)
      • :key - (String)
      • :value - (String)
      • :group_set - (Array)
      • :group_name - (String)
      • :group_id - (String)
      • :source_dest_check - (Boolean)
      • :hypervisor - (String)
      • :network_interface_set - (Array)
      • :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)
        • :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)
        • :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 3466

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

Calls the StartInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_ids - required - (Array) 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)
      • :instance_id - (String)
      • :current_state - (Hash)
      • :code - (Integer)
      • :name - (String)
      • :previous_state - (Hash)
      • :code - (Integer)
      • :name - (String)



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

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

Calls the StopInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_ids - required - (Array) 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)
      • :instance_id - (String)
      • :current_state - (Hash)
      • :code - (Integer)
      • :name - (String)
      • :previous_state - (Hash)
      • :code - (Integer)
      • :name - (String)



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

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

Calls the TerminateInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_ids - required - (Array) 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)
      • :instance_id - (String)
      • :current_state - (Hash)
      • :code - (Integer)
      • :name - (String)
      • :previous_state - (Hash)
      • :code - (Integer)
      • :name - (String)



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

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

Returns:




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

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

Calls the UnmonitorInstances API operation.

Parameters:

  • options (Hash) (defaults to: {}) —
    • :instance_ids - required - (Array) 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)
      • :instance_id - (String)
      • :monitoring - (Hash)
      • :state - (String)



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