AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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

Direct Known Subclasses

V20130815, V20131001, V20131015, V20140201

Defined Under Namespace

Classes: V20130815, V20131001, V20131015, V20140201

Constant Summary

API_VERSION =
'2014-02-01'

Instance Attribute Summary

Attributes inherited from Core::Client

#config

Instance Method Summary (collapse)

Methods inherited from Core::Client

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

Constructor Details

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

Instance Method Details

- (Core::Response) activate_license(options = {})

Calls the ActivateLicense API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) allocate_address(options = {})

Calls the AllocateAddress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) assign_private_ip_addresses(options = {})

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:

- (Core::Response) associate_address(options = {})

Calls the AssociateAddress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) associate_dhcp_options(options = {})

Calls the AssociateDhcpOptions API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) associate_route_table(options = {})

Calls the AssociateRouteTable API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) attach_internet_gateway(options = {})

Calls the AttachInternetGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :internet_gateway_id - required - (String) The ID of the Internet gateway to attach.
    • :vpc_id - required - (String) The ID of the VPC.

Returns:

- (Core::Response) attach_network_interface(options = {})

Calls the AttachNetworkInterface API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) attach_volume(options = {})

Calls the AttachVolume API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) attach_vpn_gateway(options = {})

Calls the AttachVpnGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) authorize_security_group_egress(options = {})

Calls the AuthorizeSecurityGroupEgress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) authorize_security_group_ingress(options = {})

Calls the AuthorizeSecurityGroupIngress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) bundle_instance(options = {})

Calls the BundleInstance API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) cancel_bundle_task(options = {})

Calls the CancelBundleTask API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) cancel_conversion_task(options = {})

Calls the CancelConversionTask API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :conversion_task_id - required - (String)
    • :reason_message - (String)

Returns:

- (Core::Response) cancel_export_task(options = {})

Calls the CancelExportTask API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :export_task_id - required - (String)

Returns:

- (Core::Response) cancel_reserved_instances_listing(options = {})

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)

- (Core::Response) cancel_spot_instance_requests(options = {})

Calls the CancelSpotInstanceRequests API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) confirm_product_instance(options = {})

Calls the ConfirmProductInstance API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) copy_image(options = {})

Calls the CopyImage API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) copy_snapshot(options = {})

Calls the CopySnapshot API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_customer_gateway(options = {})

Calls the CreateCustomerGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_dhcp_options(options = {})

Calls the CreateDhcpOptions API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_image(options = {})

Calls the CreateImage API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_instance_export_task(options = {})

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)

- (Core::Response) create_internet_gateway(options = {})

Calls the CreateInternetGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)

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)

- (Core::Response) create_key_pair(options = {})

Calls the CreateKeyPair API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_network_acl(options = {})

Calls the CreateNetworkAcl API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_network_acl_entry(options = {})

Calls the CreateNetworkAclEntry API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) create_network_interface(options = {})

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)
    • :dry_run - (Boolean)

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)

- (Core::Response) create_placement_group(options = {})

Calls the CreatePlacementGroup API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :group_name - required - (String) The name of the PlacementGroup.
    • :strategy - required - (String) The PlacementGroup strategy. Valid values include:
      • cluster

Returns:

- (Core::Response) create_reserved_instances_listing(options = {})

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)

- (Core::Response) create_route(options = {})

Calls the CreateRoute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) create_route_table(options = {})

Calls the CreateRouteTable API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_security_group(options = {})

Calls the CreateSecurityGroup API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_snapshot(options = {})

Calls the CreateSnapshot API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_spot_datafeed_subscription(options = {})

Calls the CreateSpotDatafeedSubscription API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_subnet(options = {})

Calls the CreateSubnet API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_tags(options = {})

Calls the CreateTags API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) create_volume(options = {})

Calls the CreateVolume API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_vpc(options = {})

Calls the CreateVpc API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_vpn_connection(options = {})

Calls the CreateVpnConnection API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) create_vpn_connection_route(options = {})

Calls the CreateVpnConnectionRoute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :vpn_connection_id - required - (String)
    • :destination_cidr_block - required - (String)

Returns:

- (Core::Response) create_vpn_gateway(options = {})

Calls the CreateVpnGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) deactivate_license(options = {})

Calls the DeactivateLicense API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) delete_customer_gateway(options = {})

Calls the DeleteCustomerGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :customer_gateway_id - required - (String) The ID of the customer gateway to delete.

Returns:

- (Core::Response) delete_dhcp_options(options = {})

Calls the DeleteDhcpOptions API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :dhcp_options_id - required - (String) The ID of the DHCP options set to delete.

Returns:

- (Core::Response) delete_internet_gateway(options = {})

Calls the DeleteInternetGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :internet_gateway_id - required - (String) The ID of the Internet gateway to be deleted.

Returns:

- (Core::Response) delete_key_pair(options = {})

Calls the DeleteKeyPair API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :key_name - required - (String) The name of the Amazon EC2 key pair to delete.

Returns:

- (Core::Response) delete_network_acl(options = {})

Calls the DeleteNetworkAcl API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :network_acl_id - required - (String) The ID of the network ACL to be deleted.

Returns:

- (Core::Response) delete_network_acl_entry(options = {})

Calls the DeleteNetworkAclEntry API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) delete_network_interface(options = {})

Calls the DeleteNetworkInterface API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :network_interface_id - required - (String)

Returns:

- (Core::Response) delete_placement_group(options = {})

Calls the DeletePlacementGroup API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :group_name - required - (String) The name of the PlacementGroup to delete.

Returns:

- (Core::Response) delete_route(options = {})

Calls the DeleteRoute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) delete_route_table(options = {})

Calls the DeleteRouteTable API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :route_table_id - required - (String) The ID of the route table to be deleted.

Returns:

- (Core::Response) delete_security_group(options = {})

Calls the DeleteSecurityGroup API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) delete_snapshot(options = {})

Calls the DeleteSnapshot API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :snapshot_id - required - (String) The ID of the snapshot to delete.

Returns:

- (Core::Response) delete_spot_datafeed_subscription(options = {})

Calls the DeleteSpotDatafeedSubscription API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)

Returns:

- (Core::Response) delete_subnet(options = {})

Calls the DeleteSubnet API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :subnet_id - required - (String) The ID of the subnet you want to delete.

Returns:

- (Core::Response) delete_tags(options = {})

Calls the DeleteTags API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) delete_volume(options = {})

Calls the DeleteVolume API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :volume_id - required - (String) The ID of the EBS volume to delete.

Returns:

- (Core::Response) delete_vpc(options = {})

Calls the DeleteVpc API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :vpc_id - required - (String) The ID of the VPC you want to delete.

Returns:

- (Core::Response) delete_vpn_connection(options = {})

Calls the DeleteVpnConnection API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :vpn_connection_id - required - (String) The ID of the VPN connection to delete

Returns:

- (Core::Response) delete_vpn_connection_route(options = {})

Calls the DeleteVpnConnectionRoute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :vpn_connection_id - required - (String)
    • :destination_cidr_block - required - (String)

Returns:

- (Core::Response) delete_vpn_gateway(options = {})

Calls the DeleteVpnGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :vpn_gateway_id - required - (String) The ID of the VPN gateway to delete.

Returns:

- (Core::Response) deregister_image(options = {})

Calls the DeregisterImage API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :image_id - required - (String) The ID of the AMI to deregister.

Returns:

- (Core::Response) describe_account_attributes(options = {})

Calls the DescribeAccountAttributes API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_addresses(options = {})

Calls the DescribeAddresses API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_availability_zones(options = {})

Calls the DescribeAvailabilityZones API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_bundle_tasks(options = {})

Calls the DescribeBundleTasks API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_conversion_tasks(options = {})

Calls the DescribeConversionTasks API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_customer_gateways(options = {})

Calls the DescribeCustomerGateways API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_dhcp_options(options = {})

Calls the DescribeDhcpOptions API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_export_tasks(options = {})

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)

- (Core::Response) describe_image_attribute(options = {})

Calls the DescribeImageAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_images(options = {})

Calls the DescribeImages API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :image_ids - (Array<) An optional list of the AMI IDs to describe. If not specified, all AMIs will be described.
    • :owners - (Array<) An optional list of owners by which to scope the described AMIs. Valid values are: self : AMIs owned by you AWS account ID : AMIs owned by this account ID aws-marketplace : AMIs owned by the AWS Marketplace amazon : AMIs owned by Amazon all : Do not scope the AMIs returned by owner The values self, aws-marketplace, amazon, and all are literals.
    • :executable_users - (Array<) An optional list of users whose launch permissions will be used to scope the described AMIs. Valid values are: self : AMIs for which you have explicit launch permissions AWS account ID : AMIs for which this account ID has launch permissions all : AMIs that have public launch permissions The values self and all are literals.
    • :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)

- (Core::Response) describe_instance_attribute(options = {})

Calls the DescribeInstanceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_instance_status(options = {})

Calls the DescribeInstanceStatus API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_instances(options = {})

Calls the DescribeInstances API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_internet_gateways(options = {})

Calls the DescribeInternetGateways API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_key_pairs(options = {})

Calls the DescribeKeyPairs API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_licenses(options = {})

Calls the DescribeLicenses API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_network_acls(options = {})

Calls the DescribeNetworkAcls API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_network_interface_attribute(options = {})

Calls the DescribeNetworkInterfaceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_network_interfaces(options = {})

Calls the DescribeNetworkInterfaces API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_placement_groups(options = {})

Calls the DescribePlacementGroups API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_regions(options = {})

Calls the DescribeRegions API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_reserved_instances(options = {})

Calls the DescribeReservedInstances API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)
      • :end - (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)

- (Core::Response) describe_reserved_instances_listings(options = {})

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)

- (Core::Response) describe_reserved_instances_modifications(options = {})

Calls the DescribeReservedInstancesModifications API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :reserved_instances_modification_ids - (Array<) An optional list of Reserved Instances modification IDs to describe.
    • :next_token - (String) A string specifying the next paginated set of results to return.
    • :filters - (Array<) A list of filters used to match properties for ReservedInstancesModifications. 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:

    • :reserved_instances_modifications_set - (Array)
      • :reserved_instances_modification_id - (String)
      • :reserved_instances_set - (Array)
        • :reserved_instances_id - (String)
      • :modification_result_set - (Array)
        • :reserved_instances_id - (String)
        • :target_configuration - (Hash)
          • :availability_zone - (String)
          • :platform - (String)
          • :instance_count - (Integer)
      • :create_date - (Time)
      • :update_date - (Time)
      • :effective_date - (Time)
      • :status - (String)
      • :status_message - (String)
      • :client_token - (String)
    • :next_token - (String)

- (Core::Response) describe_reserved_instances_offerings(options = {})

Calls the DescribeReservedInstancesOfferings API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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
      • cr1.8xlarge
    • :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)
    • :include_marketplace - (Boolean) Include Marketplace offerings in the response.
    • :min_duration - (Integer) Minimum duration (in seconds) to filter when searching for offerings.
    • :max_duration - (Integer) Maximum duration (in seconds) to filter when searching for offerings.
    • :max_instance_count - (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)

- (Core::Response) describe_route_tables(options = {})

Calls the DescribeRouteTables API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_security_groups(options = {})

Calls the DescribeSecurityGroups API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :group_names - (Array<) An optional list of group names that specify the 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)

- (Core::Response) describe_snapshot_attribute(options = {})

Calls the DescribeSnapshotAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_snapshots(options = {})

Calls the DescribeSnapshots API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :snapshot_ids - (Array<) The optional list of EBS snapshot IDs to describe.
    • :owner_ids - (Array<) An optional list of owners by which to scope the described EBS snapshots. Valid values are: self : Snapshots owned by you AWS account ID : Snapshots owned by this account ID amazon : Snapshots owned by Amazon The values self and amazon are literals.
    • :restorable_by_user_ids - (Array<) An optional list of users. The described snapshots are scoped to only those snapshots from which these users can create volumes.
    • :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)

- (Core::Response) describe_spot_datafeed_subscription(options = {})

Calls the DescribeSpotDatafeedSubscription API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)

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)

- (Core::Response) describe_spot_instance_requests(options = {})

Calls the DescribeSpotInstanceRequests API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)
          • :associate_public_ip_address - (Boolean)
        • :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)

- (Core::Response) describe_spot_price_history(options = {})

Calls the DescribeSpotPriceHistory API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_subnets(options = {})

Calls the DescribeSubnets API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_tags(options = {})

Calls the DescribeTags API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_volume_attribute(options = {})

Calls the DescribeVolumeAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_volume_status(options = {})

Calls the DescribeVolumeStatus API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_volumes(options = {})

Calls the DescribeVolumes API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_vpc_attribute(options = {})

Calls the DescribeVpcAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_vpcs(options = {})

Calls the DescribeVpcs API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_vpn_connections(options = {})

Calls the DescribeVpnConnections API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) describe_vpn_gateways(options = {})

Calls the DescribeVpnGateways API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) detach_internet_gateway(options = {})

Calls the DetachInternetGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :internet_gateway_id - required - (String) The ID of the Internet gateway to detach.
    • :vpc_id - required - (String) The ID of the VPC.

Returns:

- (Core::Response) detach_network_interface(options = {})

Calls the DetachNetworkInterface API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :attachment_id - required - (String)
    • :force - (Boolean)

Returns:

- (Core::Response) detach_volume(options = {})

Calls the DetachVolume API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) detach_vpn_gateway(options = {})

Calls the DetachVpnGateway API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) disable_vgw_route_propagation(options = {})

Calls the DisableVgwRoutePropagation API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :route_table_id - required - (String)
    • :gateway_id - required - (String)

Returns:

- (Core::Response) disassociate_address(options = {})

Calls the DisassociateAddress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) disassociate_route_table(options = {})

Calls the DisassociateRouteTable API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :association_id - required - (String) The association ID representing the current association between the route table and subnet.

Returns:

- (Core::Response) enable_vgw_route_propagation(options = {})

Calls the EnableVgwRoutePropagation API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :route_table_id - required - (String)
    • :gateway_id - required - (String)

Returns:

- (Core::Response) enable_volume_io(options = {})

Calls the EnableVolumeIO API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :volume_id - required - (String)

Returns:

- (Core::Response) get_console_output(options = {})

Calls the GetConsoleOutput API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) get_password_data(options = {})

Calls the GetPasswordData API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) import_instance(options = {})

Calls the ImportInstance API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :description - (String)
    • :launch_specification - (Hash)
      • :architecture - (String)
      • :group_names - (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
        • cr1.8xlarge
      • :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.
      • :monitoring - (Boolean)
      • :subnet_id - (String)
      • :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)

- (Core::Response) import_key_pair(options = {})

Calls the ImportKeyPair API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) import_volume(options = {})

Calls the ImportVolume API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) modify_image_attribute(options = {})

Calls the ModifyImageAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) modify_instance_attribute(options = {})

Calls the ModifyInstanceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) modify_network_interface_attribute(options = {})

Calls the ModifyNetworkInterfaceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) modify_reserved_instances(options = {})

Calls the ModifyReservedInstances API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :client_token - (String) A unique, case-sensitive, token you provide to ensure idempotency of your modification request.
    • :reserved_instances_ids - required - (Array<) The IDs of the Reserved Instances to modify.
    • :target_configurations - required - (Array<) The configuration settings for the Reserved Instances to modify.
      • :availability_zone - (String) The Availability Zone for the modified Reserved Instances.
      • :platform - (String) The network platform of the modified Reserved Instances, which is either EC2-Classic or EC2-VPC.
      • :instance_count - (Integer) The number of modified Reserved Instances.

Returns:

  • (Core::Response)

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

    • :reserved_instances_modification_id - (String)

- (Core::Response) modify_snapshot_attribute(options = {})

Calls the ModifySnapshotAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) modify_volume_attribute(options = {})

Calls the ModifyVolumeAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :volume_id - required - (String)
    • :auto_enable_io - (Boolean)

Returns:

- (Core::Response) modify_vpc_attribute(options = {})

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:

- (Core::Response) monitor_instances(options = {})

Calls the MonitorInstances API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) purchase_reserved_instances_offering(options = {})

Calls the PurchaseReservedInstancesOffering API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) reboot_instances(options = {})

Calls the RebootInstances API operation.

Parameters:

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

Returns:

- (Core::Response) register_image(options = {})

Calls the RegisterImage API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) release_address(options = {})

Calls the ReleaseAddress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) replace_network_acl_association(options = {})

Calls the ReplaceNetworkAclAssociation API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) replace_network_acl_entry(options = {})

Calls the ReplaceNetworkAclEntry API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) replace_route(options = {})

Calls the ReplaceRoute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) replace_route_table_association(options = {})

Calls the ReplaceRouteTableAssociation API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) report_instance_status(options = {})

Calls the ReportInstanceStatus API operation.

Parameters:

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

Returns:

- (Core::Response) request_spot_instances(options = {})

Calls the RequestSpotInstances API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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
        • cr1.8xlarge
      • :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) An existing interface to attach to a single instance. Requires n=1 instances.
        • :device_index - (Integer) The device index. Applies to both attaching an existing network interface and when creating a network interface. Condition: If you are specifying a network interface in the request, you must provide the device index.
        • :subnet_id - (String) The subnet ID. Applies only when creating a network interface.
        • :description - (String) A description. Applies only when creating a network interface.
        • :private_ip_address - (String) The primary private IP address. Applies only when creating a network interface. Requires n=1 network interfaces in launch.
        • :groups - (Array<)
        • :delete_on_termination - (Boolean)
        • :private_ip_addresses - (Array<)
          • :private_ip_address - required - (String)
          • :primary - (Boolean)
        • :secondary_private_ip_address_count - (Integer)
        • :associate_public_ip_address - (Boolean) Indicates whether to assign a public IP address to an instance in a VPC. The public IP address is associated with a specific network interface. If set to true , the following rules apply: Can only be associated with a single network interface with the device index of 0. You can't associate a public IP address with a second network interface, and you can't associate a public IP address if you are launching more than one network interface. Can only be associated with a new network interface, not an existing one. Default: If launching into a default subnet, the default value is true . If launching into a nondefault subnet, the default value is false .
      • :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)
          • :associate_public_ip_address - (Boolean)
        • :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)

- (Core::Response) reset_image_attribute(options = {})

Calls the ResetImageAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) reset_instance_attribute(options = {})

Calls the ResetInstanceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) reset_network_interface_attribute(options = {})

Calls the ResetNetworkInterfaceAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :network_interface_id - required - (String)
    • :source_dest_check - (String)

Returns:

- (Core::Response) reset_snapshot_attribute(options = {})

Calls the ResetSnapshotAttribute API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) revoke_security_group_egress(options = {})

Calls the RevokeSecurityGroupEgress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) revoke_security_group_ingress(options = {})

Calls the RevokeSecurityGroupIngress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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:

- (Core::Response) run_instances(options = {})

Calls the RunInstances API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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). This parameter must be passed as a Base64-encoded string.
    • :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
      • cr1.8xlarge
    • :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) Do not use. Reserved for internal use.
    • :network_interfaces - (Array<) List of network interfaces associated with the instance.
      • :network_interface_id - (String) An existing interface to attach to a single instance. Requires n=1 instances.
      • :device_index - (Integer) The device index. Applies to both attaching an existing network interface and when creating a network interface. Condition: If you are specifying a network interface in the request, you must provide the device index.
      • :subnet_id - (String) The subnet ID. Applies only when creating a network interface.
      • :description - (String) A description. Applies only when creating a network interface.
      • :private_ip_address - (String) The primary private IP address. Applies only when creating a network interface. Requires n=1 network interfaces in launch.
      • :groups - (Array<)
      • :delete_on_termination - (Boolean)
      • :private_ip_addresses - (Array<)
        • :private_ip_address - required - (String)
        • :primary - (Boolean)
      • :secondary_private_ip_address_count - (Integer)
      • :associate_public_ip_address - (Boolean) Indicates whether to assign a public IP address to an instance in a VPC. The public IP address is associated with a specific network interface. If set to true , the following rules apply: Can only be associated with a single network interface with the device index of 0. You can't associate a public IP address with a second network interface, and you can't associate a public IP address if you are launching more than one network interface. Can only be associated with a new network interface, not an existing one. Default: If launching into a default subnet, the default value is true . If launching into a nondefault subnet, the default value is false .
    • :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)

- (Object) sign_request(request)



22
23
24
25
26
27
28
29
30
31
32
# File 'lib/aws/ec2/client.rb', line 22

def sign_request request
  version = @config.ec2_signature_version ?
    @config.ec2_signature_version.to_sym :
    (@region =~ /cn-/ ? :v4 : :v2)
  case version
  when :v4 then v4_signer.sign_request(request)
  when :v2 then v2_signer.sign_request(request)
  else
    raise "invalid signature version #{version.inspect}"
  end
end

- (Core::Response) start_instances(options = {})

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)
    • :dry_run - (Boolean)

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)

- (Core::Response) stop_instances(options = {})

Calls the StopInstances API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) terminate_instances(options = {})

Calls the TerminateInstances API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)

- (Core::Response) unassign_private_ip_addresses(options = {})

Calls the UnassignPrivateIpAddresses API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :network_interface_id - required - (String)
    • :private_ip_addresses - required - (Array<)

Returns:

- (Core::Response) unmonitor_instances(options = {})

Calls the UnmonitorInstances API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :dry_run - (Boolean)
    • :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)