aws-sdk-ec2 1.0.0.rc1

data/lib/aws-sdk-ec2/vpc.rb

@@ -0,0 +1,1698 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws
+  module EC2
+    class Vpc
+
+      extend Aws::Deprecations
+
+      # @overload def initialize(id, options = {})
+      #   @param [String] id
+      #   @option options [Client] :client
+      # @overload def initialize(options = {})
+      #   @option options [required, String] :id
+      #   @option options [Client] :client
+      def initialize(*args)
+        options = Hash === args.last ? args.pop.dup : {}
+        @id = extract_id(args, options)
+        @data = options.delete(:data)
+        @client = options.delete(:client) || Client.new(options)
+      end
+
+      # @!group Read-Only Attributes
+
+      # @return [String]
+      def id
+        @id
+      end
+      alias :vpc_id :id
+
+      # The current state of the VPC.
+      # @return [String]
+      def state
+        data.state
+      end
+
+      # The CIDR block for the VPC.
+      # @return [String]
+      def cidr_block
+        data.cidr_block
+      end
+
+      # The ID of the set of DHCP options you've associated with the VPC (or
+      # `default` if the default options are associated with the VPC).
+      # @return [String]
+      def dhcp_options_id
+        data.dhcp_options_id
+      end
+
+      # Any tags assigned to the VPC.
+      # @return [Array<Types::Tag>]
+      def tags
+        data.tags
+      end
+
+      # The allowed tenancy of instances launched into the VPC.
+      # @return [String]
+      def instance_tenancy
+        data.instance_tenancy
+      end
+
+      # Indicates whether the VPC is the default VPC.
+      # @return [Boolean]
+      def is_default
+        data.is_default
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # Loads, or reloads {#data} for the current {Vpc}.
+      # Returns `self` making it possible to chain methods.
+      #
+      #     vpc.reload.data
+      #
+      # @return [self]
+      def load
+        resp = @client.describe_vpcs(vpc_ids: [@id])
+        @data = resp.vpcs[0]
+        self
+      end
+      alias :reload :load
+
+      # @return [Types::Vpc]
+      #   Returns the data for this {Vpc}. Calls
+      #   {Client#describe_vpcs} if {#data_loaded?} is `false`.
+      def data
+        load unless @data
+        @data
+      end
+
+      # @return [Boolean]
+      #   Returns `true` if this resource is loaded.  Accessing attributes or
+      #   {#data} on an unloaded resource will trigger a call to {#load}.
+      def data_loaded?
+        !!@data
+      end
+
+      # @param [Hash] options ({})
+      # @return [Boolean]
+      #   Returns `true` if the Vpc exists.
+      def exists?(options = {})
+        begin
+          wait_until_exists(options.merge(max_attempts: 1))
+          true
+        rescue Aws::Waiters::Errors::UnexpectedError => e
+          raise e.error
+        rescue Aws::Waiters::Errors::WaiterFailed
+          false
+        end
+      end
+
+      # @param [Hash] options ({})
+      # @option options [Integer] :max_attempts (40)
+      # @option options [Float] :delay (15)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      # @return [Vpc]
+      def wait_until_available(options = {})
+        options, params = separate_params_and_options(options)
+        waiter = Waiters::VpcAvailable.new(options)
+        yield_waiter_and_warn(waiter, &Proc.new) if block_given?
+        waiter.wait(params.merge(vpc_ids: [@id]))
+        Vpc.new({
+          id: @id,
+          client: @client
+        })
+      end
+
+      # @param [Hash] options ({})
+      # @option options [Integer] :max_attempts (5)
+      # @option options [Float] :delay (1)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      # @return [Vpc]
+      def wait_until_exists(options = {})
+        options, params = separate_params_and_options(options)
+        waiter = Waiters::VpcExists.new(options)
+        yield_waiter_and_warn(waiter, &Proc.new) if block_given?
+        waiter.wait(params.merge(vpc_ids: [@id]))
+        Vpc.new({
+          id: @id,
+          client: @client
+        })
+      end
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpc.associate_dhcp_options({
+      #     dry_run: false,
+      #     dhcp_options_id: "String", # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [required, String] :dhcp_options_id
+      #   The ID of the DHCP options set, or `default` to associate no DHCP
+      #   options with the VPC.
+      # @return [EmptyStructure]
+      def associate_dhcp_options(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.associate_dhcp_options(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpc.attach_classic_link_instance({
+      #     dry_run: false,
+      #     instance_id: "String", # required
+      #     groups: ["String"], # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [required, String] :instance_id
+      #   The ID of an EC2-Classic instance to link to the ClassicLink-enabled
+      #   VPC.
+      # @option options [required, Array<String>] :groups
+      #   The ID of one or more of the VPC's security groups. You cannot
+      #   specify security groups from a different VPC.
+      # @return [Types::AttachClassicLinkVpcResult]
+      def attach_classic_link_instance(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.attach_classic_link_vpc(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpc.attach_internet_gateway({
+      #     dry_run: false,
+      #     internet_gateway_id: "String", # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [required, String] :internet_gateway_id
+      #   The ID of the Internet gateway.
+      # @return [EmptyStructure]
+      def attach_internet_gateway(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.attach_internet_gateway(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   networkacl = vpc.create_network_acl({
+      #     dry_run: false,
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @return [NetworkAcl]
+      def create_network_acl(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.create_network_acl(options)
+        NetworkAcl.new(
+          id: resp.data.network_acl.network_acl_id,
+          data: resp.data.network_acl,
+          client: @client
+        )
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   routetable = vpc.create_route_table({
+      #     dry_run: false,
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @return [RouteTable]
+      def create_route_table(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.create_route_table(options)
+        RouteTable.new(
+          id: resp.data.route_table.route_table_id,
+          data: resp.data.route_table,
+          client: @client
+        )
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   securitygroup = vpc.create_security_group({
+      #     dry_run: false,
+      #     group_name: "String", # required
+      #     description: "String", # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [required, String] :group_name
+      #   The name of the security group.
+      #
+      #   Constraints: Up to 255 characters in length
+      #
+      #   Constraints for EC2-Classic: ASCII characters
+      #
+      #   Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and
+      #   .\_-:/()#,@\[\]+=&amp;;\\\{\\}!$*
+      # @option options [required, String] :description
+      #   A description for the security group. This is informational only.
+      #
+      #   Constraints: Up to 255 characters in length
+      #
+      #   Constraints for EC2-Classic: ASCII characters
+      #
+      #   Constraints for EC2-VPC: a-z, A-Z, 0-9, spaces, and
+      #   .\_-:/()#,@\[\]+=&amp;;\\\{\\}!$*
+      # @return [SecurityGroup]
+      def create_security_group(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.create_security_group(options)
+        SecurityGroup.new(
+          id: resp.data.group_id,
+          client: @client
+        )
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   subnet = vpc.create_subnet({
+      #     dry_run: false,
+      #     cidr_block: "String", # required
+      #     availability_zone: "String",
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [required, String] :cidr_block
+      #   The network range for the subnet, in CIDR notation. For example,
+      #   `10.0.0.0/24`.
+      # @option options [String] :availability_zone
+      #   The Availability Zone for the subnet.
+      #
+      #   Default: AWS selects one for you. If you create more than one subnet
+      #   in your VPC, we may not necessarily select a different zone for each
+      #   subnet.
+      # @return [Subnet]
+      def create_subnet(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.create_subnet(options)
+        Subnet.new(
+          id: resp.data.subnet.subnet_id,
+          data: resp.data.subnet,
+          client: @client
+        )
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   tag = vpc.create_tags({
+      #     dry_run: false,
+      #     tags: [ # required
+      #       {
+      #         key: "String",
+      #         value: "String",
+      #       },
+      #     ],
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [required, Array<Types::Tag>] :tags
+      #   One or more tags. The `value` parameter is required, but if you don't
+      #   want the tag to have a value, specify the parameter with no value, and
+      #   we set the value to an empty string.
+      # @return [Tag::Collection]
+      def create_tags(options = {})
+        batch = []
+        options = Aws::Util.deep_merge(options, resources: [@id])
+        resp = @client.create_tags(options)
+        options[:tags].each do |t|
+          batch << Tag.new(
+            resource_id: @id,
+            key: t[:key],
+            value: t[:value],
+            client: @client
+          )
+        end
+        Tag::Collection.new([batch], size: batch.size)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpc.delete({
+      #     dry_run: false,
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @return [EmptyStructure]
+      def delete(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.delete_vpc(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpc.describe_attribute({
+      #     dry_run: false,
+      #     attribute: "enableDnsSupport", # required, accepts enableDnsSupport, enableDnsHostnames
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [required, String] :attribute
+      #   The VPC attribute.
+      # @return [Types::DescribeVpcAttributeResult]
+      def describe_attribute(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.describe_vpc_attribute(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpc.detach_classic_link_instance({
+      #     dry_run: false,
+      #     instance_id: "String", # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [required, String] :instance_id
+      #   The ID of the instance to unlink from the VPC.
+      # @return [Types::DetachClassicLinkVpcResult]
+      def detach_classic_link_instance(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.detach_classic_link_vpc(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpc.detach_internet_gateway({
+      #     dry_run: false,
+      #     internet_gateway_id: "String", # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [required, String] :internet_gateway_id
+      #   The ID of the Internet gateway.
+      # @return [EmptyStructure]
+      def detach_internet_gateway(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.detach_internet_gateway(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpc.disable_classic_link({
+      #     dry_run: false,
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @return [Types::DisableVpcClassicLinkResult]
+      def disable_classic_link(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.disable_vpc_classic_link(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpc.enable_classic_link({
+      #     dry_run: false,
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @return [Types::EnableVpcClassicLinkResult]
+      def enable_classic_link(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.enable_vpc_classic_link(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpc.modify_attribute({
+      #     enable_dns_support: {
+      #       value: false,
+      #     },
+      #     enable_dns_hostnames: {
+      #       value: false,
+      #     },
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Types::AttributeBooleanValue] :enable_dns_support
+      #   Indicates whether the DNS resolution is supported for the VPC. If
+      #   enabled, queries to the Amazon provided DNS server at the
+      #   169.254.169.253 IP address, or the reserved IP address at the base of
+      #   the VPC network range "plus two" will succeed. If disabled, the
+      #   Amazon provided DNS service in the VPC that resolves public DNS
+      #   hostnames to IP addresses is not enabled.
+      #
+      #   You cannot modify the DNS resolution and DNS hostnames attributes in
+      #   the same request. Use separate requests for each attribute.
+      # @option options [Types::AttributeBooleanValue] :enable_dns_hostnames
+      #   Indicates whether the instances launched in the VPC get DNS hostnames.
+      #   If enabled, instances in the VPC get DNS hostnames; otherwise, they do
+      #   not.
+      #
+      #   You cannot modify the DNS resolution and DNS hostnames attributes in
+      #   the same request. Use separate requests for each attribute. You can
+      #   only enable DNS hostnames if you've enabled DNS support.
+      # @return [EmptyStructure]
+      def modify_attribute(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.modify_vpc_attribute(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   vpcpeeringconnection = vpc.request_vpc_peering_connection({
+      #     dry_run: false,
+      #     peer_vpc_id: "String",
+      #     peer_owner_id: "String",
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [String] :peer_vpc_id
+      #   The ID of the VPC with which you are creating the VPC peering
+      #   connection.
+      # @option options [String] :peer_owner_id
+      #   The AWS account ID of the owner of the peer VPC.
+      #
+      #   Default: Your AWS account ID
+      # @return [VpcPeeringConnection]
+      def request_vpc_peering_connection(options = {})
+        options = options.merge(vpc_id: @id)
+        resp = @client.create_vpc_peering_connection(options)
+        VpcPeeringConnection.new(
+          id: resp.data.vpc_peering_connection.vpc_peering_connection_id,
+          data: resp.data.vpc_peering_connection,
+          client: @client
+        )
+      end
+
+      # @!group Associations
+
+      # @example Request syntax with placeholder values
+      #
+      #   acceptedvpcpeeringconnections = vpc.accepted_vpc_peering_connections({
+      #     dry_run: false,
+      #     vpc_peering_connection_ids: ["String"],
+      #     filters: [
+      #       {
+      #         name: "String",
+      #         values: ["String"],
+      #       },
+      #     ],
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [Array<String>] :vpc_peering_connection_ids
+      #   One or more VPC peering connection IDs.
+      #
+      #   Default: Describes all your VPC peering connections.
+      # @option options [Array<Types::Filter>] :filters
+      #   One or more filters.
+      #
+      #   * `accepter-vpc-info.cidr-block` - The CIDR block of the peer VPC.
+      #
+      #   * `accepter-vpc-info.owner-id` - The AWS account ID of the owner of
+      #     the peer VPC.
+      #
+      #   * `accepter-vpc-info.vpc-id` - The ID of the peer VPC.
+      #
+      #   * `expiration-time` - The expiration date and time for the VPC peering
+      #     connection.
+      #
+      #   * `requester-vpc-info.cidr-block` - The CIDR block of the requester's
+      #     VPC.
+      #
+      #   * `requester-vpc-info.owner-id` - The AWS account ID of the owner of
+      #     the requester VPC.
+      #
+      #   * `requester-vpc-info.vpc-id` - The ID of the requester VPC.
+      #
+      #   * `status-code` - The status of the VPC peering connection
+      #     (`pending-acceptance` \| `failed` \| `expired` \| `provisioning` \|
+      #     `active` \| `deleted` \| `rejected`).
+      #
+      #   * `status-message` - A message that provides more information about
+      #     the status of the VPC peering connection, if applicable.
+      #
+      #   * `tag`\:*key*=*value* - The key/value combination of a tag assigned
+      #     to the resource.
+      #
+      #   * `tag-key` - The key of a tag assigned to the resource. This filter
+      #     is independent of the `tag-value` filter. For example, if you use
+      #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
+      #     you get any resources assigned both the tag key Purpose (regardless
+      #     of what the tag's value is), and the tag value X (regardless of
+      #     what the tag's key is). If you want to list only resources where
+      #     Purpose is X, see the `tag`\:*key*=*value* filter.
+      #
+      #   * `tag-value` - The value of a tag assigned to the resource. This
+      #     filter is independent of the `tag-key` filter.
+      #
+      #   * `vpc-peering-connection-id` - The ID of the VPC peering connection.
+      # @return [VpcPeeringConnection::Collection]
+      def accepted_vpc_peering_connections(options = {})
+        batches = Enumerator.new do |y|
+          batch = []
+          options = Aws::Util.deep_merge(options, filters: [{
+            name: "accepter-vpc-info.vpc-id",
+            values: [@id]
+          }])
+          resp = @client.describe_vpc_peering_connections(options)
+          resp.data.vpc_peering_connections.each do |v|
+            batch << VpcPeeringConnection.new(
+              id: v.vpc_peering_connection_id,
+              data: v,
+              client: @client
+            )
+          end
+          y.yield(batch)
+        end
+        VpcPeeringConnection::Collection.new(batches)
+      end
+
+      # @return [DhcpOptions, nil]
+      def dhcp_options
+        if data.dhcp_options_id
+          DhcpOptions.new(
+            id: data.dhcp_options_id,
+            client: @client
+          )
+        else
+          nil
+        end
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   instances = vpc.instances({
+      #     dry_run: false,
+      #     instance_ids: ["String"],
+      #     filters: [
+      #       {
+      #         name: "String",
+      #         values: ["String"],
+      #       },
+      #     ],
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [Array<String>] :instance_ids
+      #   One or more instance IDs.
+      #
+      #   Default: Describes all your instances.
+      # @option options [Array<Types::Filter>] :filters
+      #   One or more filters.
+      #
+      #   * `affinity` - The affinity setting for an instance running on a
+      #     Dedicated Host (`default` \| `host`).
+      #
+      #   * `architecture` - The instance architecture (`i386` \| `x86_64`).
+      #
+      #   * `availability-zone` - The Availability Zone of the instance.
+      #
+      #   * `block-device-mapping.attach-time` - The attach time for an EBS
+      #     volume mapped to the instance, for example,
+      #     `2010-09-15T17:15:20.000Z`.
+      #
+      #   * `block-device-mapping.delete-on-termination` - A Boolean that
+      #     indicates whether the EBS volume is deleted on instance termination.
+      #
+      #   * `block-device-mapping.device-name` - The device name for the EBS
+      #     volume (for example, `/dev/sdh` or `xvdh`).
+      #
+      #   * `block-device-mapping.status` - The status for the EBS volume
+      #     (`attaching` \| `attached` \| `detaching` \| `detached`).
+      #
+      #   * `block-device-mapping.volume-id` - The volume ID of the EBS volume.
+      #
+      #   * `client-token` - The idempotency token you provided when you
+      #     launched the instance.
+      #
+      #   * `dns-name` - The public DNS name of the instance.
+      #
+      #   * `group-id` - The ID of the security group for the instance.
+      #     EC2-Classic only.
+      #
+      #   * `group-name` - The name of the security group for the instance.
+      #     EC2-Classic only.
+      #
+      #   * `host-id` - The ID of the Dedicated Host on which the instance is
+      #     running, if applicable.
+      #
+      #   * `hypervisor` - The hypervisor type of the instance (`ovm` \| `xen`).
+      #
+      #   * `iam-instance-profile.arn` - The instance profile associated with
+      #     the instance. Specified as an ARN.
+      #
+      #   * `image-id` - The ID of the image used to launch the instance.
+      #
+      #   * `instance-id` - The ID of the instance.
+      #
+      #   * `instance-lifecycle` - Indicates whether this is a Spot Instance or
+      #     a Scheduled Instance (`spot` \| `scheduled`).
+      #
+      #   * `instance-state-code` - The state of the instance, as a 16-bit
+      #     unsigned integer. The high byte is an opaque internal value and
+      #     should be ignored. The low byte is set based on the state
+      #     represented. The valid values are: 0 (pending), 16 (running), 32
+      #     (shutting-down), 48 (terminated), 64 (stopping), and 80 (stopped).
+      #
+      #   * `instance-state-name` - The state of the instance (`pending` \|
+      #     `running` \| `shutting-down` \| `terminated` \| `stopping` \|
+      #     `stopped`).
+      #
+      #   * `instance-type` - The type of instance (for example, `t2.micro`).
+      #
+      #   * `instance.group-id` - The ID of the security group for the instance.
+      #
+      #   * `instance.group-name` - The name of the security group for the
+      #     instance.
+      #
+      #   * `ip-address` - The public IP address of the instance.
+      #
+      #   * `kernel-id` - The kernel ID.
+      #
+      #   * `key-name` - The name of the key pair used when the instance was
+      #     launched.
+      #
+      #   * `launch-index` - When launching multiple instances, this is the
+      #     index for the instance in the launch group (for example, 0, 1, 2,
+      #     and so on).
+      #
+      #   * `launch-time` - The time when the instance was launched.
+      #
+      #   * `monitoring-state` - Indicates whether monitoring is enabled for the
+      #     instance (`disabled` \| `enabled`).
+      #
+      #   * `owner-id` - The AWS account ID of the instance owner.
+      #
+      #   * `placement-group-name` - The name of the placement group for the
+      #     instance.
+      #
+      #   * `platform` - The platform. Use `windows` if you have Windows
+      #     instances; otherwise, leave blank.
+      #
+      #   * `private-dns-name` - The private DNS name of the instance.
+      #
+      #   * `private-ip-address` - The private IP address of the instance.
+      #
+      #   * `product-code` - The product code associated with the AMI used to
+      #     launch the instance.
+      #
+      #   * `product-code.type` - The type of product code (`devpay` \|
+      #     `marketplace`).
+      #
+      #   * `ramdisk-id` - The RAM disk ID.
+      #
+      #   * `reason` - The reason for the current state of the instance (for
+      #     example, shows "User Initiated \[date\]" when you stop or
+      #     terminate the instance). Similar to the state-reason-code filter.
+      #
+      #   * `requester-id` - The ID of the entity that launched the instance on
+      #     your behalf (for example, AWS Management Console, Auto Scaling, and
+      #     so on).
+      #
+      #   * `reservation-id` - The ID of the instance's reservation. A
+      #     reservation ID is created any time you launch an instance. A
+      #     reservation ID has a one-to-one relationship with an instance launch
+      #     request, but can be associated with more than one instance if you
+      #     launch multiple instances using the same launch request. For
+      #     example, if you launch one instance, you'll get one reservation ID.
+      #     If you launch ten instances using the same launch request, you'll
+      #     also get one reservation ID.
+      #
+      #   * `root-device-name` - The name of the root device for the instance
+      #     (for example, `/dev/sda1` or `/dev/xvda`).
+      #
+      #   * `root-device-type` - The type of root device that the instance uses
+      #     (`ebs` \| `instance-store`).
+      #
+      #   * `source-dest-check` - Indicates whether the instance performs
+      #     source/destination checking. A value of `true` means that checking
+      #     is enabled, and `false` means checking is disabled. The value must
+      #     be `false` for the instance to perform network address translation
+      #     (NAT) in your VPC.
+      #
+      #   * `spot-instance-request-id` - The ID of the Spot instance request.
+      #
+      #   * `state-reason-code` - The reason code for the state change.
+      #
+      #   * `state-reason-message` - A message that describes the state change.
+      #
+      #   * `subnet-id` - The ID of the subnet for the instance.
+      #
+      #   * `tag`\:*key*=*value* - The key/value combination of a tag assigned
+      #     to the resource, where `tag`\:*key* is the tag's key.
+      #
+      #   * `tag-key` - The key of a tag assigned to the resource. This filter
+      #     is independent of the `tag-value` filter. For example, if you use
+      #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
+      #     you get any resources assigned both the tag key Purpose (regardless
+      #     of what the tag's value is), and the tag value X (regardless of
+      #     what the tag's key is). If you want to list only resources where
+      #     Purpose is X, see the `tag`\:*key*=*value* filter.
+      #
+      #   * `tag-value` - The value of a tag assigned to the resource. This
+      #     filter is independent of the `tag-key` filter.
+      #
+      #   * `tenancy` - The tenancy of an instance (`dedicated` \| `default` \|
+      #     `host`).
+      #
+      #   * `virtualization-type` - The virtualization type of the instance
+      #     (`paravirtual` \| `hvm`).
+      #
+      #   * `vpc-id` - The ID of the VPC that the instance is running in.
+      #
+      #   * `network-interface.description` - The description of the network
+      #     interface.
+      #
+      #   * `network-interface.subnet-id` - The ID of the subnet for the network
+      #     interface.
+      #
+      #   * `network-interface.vpc-id` - The ID of the VPC for the network
+      #     interface.
+      #
+      #   * `network-interface.network-interface-id` - The ID of the network
+      #     interface.
+      #
+      #   * `network-interface.owner-id` - The ID of the owner of the network
+      #     interface.
+      #
+      #   * `network-interface.availability-zone` - The Availability Zone for
+      #     the network interface.
+      #
+      #   * `network-interface.requester-id` - The requester ID for the network
+      #     interface.
+      #
+      #   * `network-interface.requester-managed` - Indicates whether the
+      #     network interface is being managed by AWS.
+      #
+      #   * `network-interface.status` - The status of the network interface
+      #     (`available`) \| `in-use`).
+      #
+      #   * `network-interface.mac-address` - The MAC address of the network
+      #     interface.
+      #
+      #   * `network-interface.private-dns-name` - The private DNS name of the
+      #     network interface.
+      #
+      #   * `network-interface.source-dest-check` - Whether the network
+      #     interface performs source/destination checking. A value of `true`
+      #     means checking is enabled, and `false` means checking is disabled.
+      #     The value must be `false` for the network interface to perform
+      #     network address translation (NAT) in your VPC.
+      #
+      #   * `network-interface.group-id` - The ID of a security group associated
+      #     with the network interface.
+      #
+      #   * `network-interface.group-name` - The name of a security group
+      #     associated with the network interface.
+      #
+      #   * `network-interface.attachment.attachment-id` - The ID of the
+      #     interface attachment.
+      #
+      #   * `network-interface.attachment.instance-id` - The ID of the instance
+      #     to which the network interface is attached.
+      #
+      #   * `network-interface.attachment.instance-owner-id` - The owner ID of
+      #     the instance to which the network interface is attached.
+      #
+      #   * `network-interface.addresses.private-ip-address` - The private IP
+      #     address associated with the network interface.
+      #
+      #   * `network-interface.attachment.device-index` - The device index to
+      #     which the network interface is attached.
+      #
+      #   * `network-interface.attachment.status` - The status of the attachment
+      #     (`attaching` \| `attached` \| `detaching` \| `detached`).
+      #
+      #   * `network-interface.attachment.attach-time` - The time that the
+      #     network interface was attached to an instance.
+      #
+      #   * `network-interface.attachment.delete-on-termination` - Specifies
+      #     whether the attachment is deleted when an instance is terminated.
+      #
+      #   * `network-interface.addresses.primary` - Specifies whether the IP
+      #     address of the network interface is the primary private IP address.
+      #
+      #   * `network-interface.addresses.association.public-ip` - The ID of the
+      #     association of an Elastic IP address with a network interface.
+      #
+      #   * `network-interface.addresses.association.ip-owner-id` - The owner ID
+      #     of the private IP address associated with the network interface.
+      #
+      #   * `association.public-ip` - The address of the Elastic IP address
+      #     bound to the network interface.
+      #
+      #   * `association.ip-owner-id` - The owner of the Elastic IP address
+      #     associated with the network interface.
+      #
+      #   * `association.allocation-id` - The allocation ID returned when you
+      #     allocated the Elastic IP address for your network interface.
+      #
+      #   * `association.association-id` - The association ID returned when the
+      #     network interface was associated with an IP address.
+      # @return [Instance::Collection]
+      def instances(options = {})
+        batches = Enumerator.new do |y|
+          options = Aws::Util.deep_merge(options, filters: [{
+            name: "vpc-id",
+            values: [@id]
+          }])
+          resp = @client.describe_instances(options)
+          resp.each_page do |page|
+            batch = []
+            page.data.reservations.each do |r|
+              r.instances.each do |i|
+                batch << Instance.new(
+                  id: i.instance_id,
+                  data: i,
+                  client: @client
+                )
+              end
+            end
+            y.yield(batch)
+          end
+        end
+        Instance::Collection.new(batches)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   internetgateways = vpc.internet_gateways({
+      #     dry_run: false,
+      #     internet_gateway_ids: ["String"],
+      #     filters: [
+      #       {
+      #         name: "String",
+      #         values: ["String"],
+      #       },
+      #     ],
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [Array<String>] :internet_gateway_ids
+      #   One or more Internet gateway IDs.
+      #
+      #   Default: Describes all your Internet gateways.
+      # @option options [Array<Types::Filter>] :filters
+      #   One or more filters.
+      #
+      #   * `attachment.state` - The current state of the attachment between the
+      #     gateway and the VPC (`available`). Present only if a VPC is
+      #     attached.
+      #
+      #   * `attachment.vpc-id` - The ID of an attached VPC.
+      #
+      #   * `internet-gateway-id` - The ID of the Internet gateway.
+      #
+      #   * `tag`\:*key*=*value* - The key/value combination of a tag assigned
+      #     to the resource.
+      #
+      #   * `tag-key` - The key of a tag assigned to the resource. This filter
+      #     is independent of the `tag-value` filter. For example, if you use
+      #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
+      #     you get any resources assigned both the tag key Purpose (regardless
+      #     of what the tag's value is), and the tag value X (regardless of
+      #     what the tag's key is). If you want to list only resources where
+      #     Purpose is X, see the `tag`\:*key*=*value* filter.
+      #
+      #   * `tag-value` - The value of a tag assigned to the resource. This
+      #     filter is independent of the `tag-key` filter.
+      # @return [InternetGateway::Collection]
+      def internet_gateways(options = {})
+        batches = Enumerator.new do |y|
+          batch = []
+          options = Aws::Util.deep_merge(options, filters: [{
+            name: "attachment.vpc-id",
+            values: [@id]
+          }])
+          resp = @client.describe_internet_gateways(options)
+          resp.data.internet_gateways.each do |i|
+            batch << InternetGateway.new(
+              id: i.internet_gateway_id,
+              data: i,
+              client: @client
+            )
+          end
+          y.yield(batch)
+        end
+        InternetGateway::Collection.new(batches)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   networkacls = vpc.network_acls({
+      #     dry_run: false,
+      #     network_acl_ids: ["String"],
+      #     filters: [
+      #       {
+      #         name: "String",
+      #         values: ["String"],
+      #       },
+      #     ],
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [Array<String>] :network_acl_ids
+      #   One or more network ACL IDs.
+      #
+      #   Default: Describes all your network ACLs.
+      # @option options [Array<Types::Filter>] :filters
+      #   One or more filters.
+      #
+      #   * `association.association-id` - The ID of an association ID for the
+      #     ACL.
+      #
+      #   * `association.network-acl-id` - The ID of the network ACL involved in
+      #     the association.
+      #
+      #   * `association.subnet-id` - The ID of the subnet involved in the
+      #     association.
+      #
+      #   * `default` - Indicates whether the ACL is the default network ACL for
+      #     the VPC.
+      #
+      #   * `entry.cidr` - The CIDR range specified in the entry.
+      #
+      #   * `entry.egress` - Indicates whether the entry applies to egress
+      #     traffic.
+      #
+      #   * `entry.icmp.code` - The ICMP code specified in the entry, if any.
+      #
+      #   * `entry.icmp.type` - The ICMP type specified in the entry, if any.
+      #
+      #   * `entry.port-range.from` - The start of the port range specified in
+      #     the entry.
+      #
+      #   * `entry.port-range.to` - The end of the port range specified in the
+      #     entry.
+      #
+      #   * `entry.protocol` - The protocol specified in the entry (`tcp` \|
+      #     `udp` \| `icmp` or a protocol number).
+      #
+      #   * `entry.rule-action` - Allows or denies the matching traffic (`allow`
+      #     \| `deny`).
+      #
+      #   * `entry.rule-number` - The number of an entry (in other words, rule)
+      #     in the ACL's set of entries.
+      #
+      #   * `network-acl-id` - The ID of the network ACL.
+      #
+      #   * `tag`\:*key*=*value* - The key/value combination of a tag assigned
+      #     to the resource.
+      #
+      #   * `tag-key` - The key of a tag assigned to the resource. This filter
+      #     is independent of the `tag-value` filter. For example, if you use
+      #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
+      #     you get any resources assigned both the tag key Purpose (regardless
+      #     of what the tag's value is), and the tag value X (regardless of
+      #     what the tag's key is). If you want to list only resources where
+      #     Purpose is X, see the `tag`\:*key*=*value* filter.
+      #
+      #   * `tag-value` - The value of a tag assigned to the resource. This
+      #     filter is independent of the `tag-key` filter.
+      #
+      #   * `vpc-id` - The ID of the VPC for the network ACL.
+      # @return [NetworkAcl::Collection]
+      def network_acls(options = {})
+        batches = Enumerator.new do |y|
+          batch = []
+          options = Aws::Util.deep_merge(options, filters: [{
+            name: "vpc-id",
+            values: [@id]
+          }])
+          resp = @client.describe_network_acls(options)
+          resp.data.network_acls.each do |n|
+            batch << NetworkAcl.new(
+              id: n.network_acl_id,
+              data: n,
+              client: @client
+            )
+          end
+          y.yield(batch)
+        end
+        NetworkAcl::Collection.new(batches)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   networkinterfaces = vpc.network_interfaces({
+      #     dry_run: false,
+      #     network_interface_ids: ["String"],
+      #     filters: [
+      #       {
+      #         name: "String",
+      #         values: ["String"],
+      #       },
+      #     ],
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [Array<String>] :network_interface_ids
+      #   One or more network interface IDs.
+      #
+      #   Default: Describes all your network interfaces.
+      # @option options [Array<Types::Filter>] :filters
+      #   One or more filters.
+      #
+      #   * `addresses.private-ip-address` - The private IP addresses associated
+      #     with the network interface.
+      #
+      #   * `addresses.primary` - Whether the private IP address is the primary
+      #     IP address associated with the network interface.
+      #
+      #   * `addresses.association.public-ip` - The association ID returned when
+      #     the network interface was associated with the Elastic IP address.
+      #
+      #   * `addresses.association.owner-id` - The owner ID of the addresses
+      #     associated with the network interface.
+      #
+      #   * `association.association-id` - The association ID returned when the
+      #     network interface was associated with an IP address.
+      #
+      #   * `association.allocation-id` - The allocation ID returned when you
+      #     allocated the Elastic IP address for your network interface.
+      #
+      #   * `association.ip-owner-id` - The owner of the Elastic IP address
+      #     associated with the network interface.
+      #
+      #   * `association.public-ip` - The address of the Elastic IP address
+      #     bound to the network interface.
+      #
+      #   * `association.public-dns-name` - The public DNS name for the network
+      #     interface.
+      #
+      #   * `attachment.attachment-id` - The ID of the interface attachment.
+      #
+      #   * `attachment.attach.time` - The time that the network interface was
+      #     attached to an instance.
+      #
+      #   * `attachment.delete-on-termination` - Indicates whether the
+      #     attachment is deleted when an instance is terminated.
+      #
+      #   * `attachment.device-index` - The device index to which the network
+      #     interface is attached.
+      #
+      #   * `attachment.instance-id` - The ID of the instance to which the
+      #     network interface is attached.
+      #
+      #   * `attachment.instance-owner-id` - The owner ID of the instance to
+      #     which the network interface is attached.
+      #
+      #   * `attachment.nat-gateway-id` - The ID of the NAT gateway to which the
+      #     network interface is attached.
+      #
+      #   * `attachment.status` - The status of the attachment (`attaching` \|
+      #     `attached` \| `detaching` \| `detached`).
+      #
+      #   * `availability-zone` - The Availability Zone of the network
+      #     interface.
+      #
+      #   * `description` - The description of the network interface.
+      #
+      #   * `group-id` - The ID of a security group associated with the network
+      #     interface.
+      #
+      #   * `group-name` - The name of a security group associated with the
+      #     network interface.
+      #
+      #   * `mac-address` - The MAC address of the network interface.
+      #
+      #   * `network-interface-id` - The ID of the network interface.
+      #
+      #   * `owner-id` - The AWS account ID of the network interface owner.
+      #
+      #   * `private-ip-address` - The private IP address or addresses of the
+      #     network interface.
+      #
+      #   * `private-dns-name` - The private DNS name of the network interface.
+      #
+      #   * `requester-id` - The ID of the entity that launched the instance on
+      #     your behalf (for example, AWS Management Console, Auto Scaling, and
+      #     so on).
+      #
+      #   * `requester-managed` - Indicates whether the network interface is
+      #     being managed by an AWS service (for example, AWS Management
+      #     Console, Auto Scaling, and so on).
+      #
+      #   * `source-desk-check` - Indicates whether the network interface
+      #     performs source/destination checking. A value of `true` means
+      #     checking is enabled, and `false` means checking is disabled. The
+      #     value must be `false` for the network interface to perform network
+      #     address translation (NAT) in your VPC.
+      #
+      #   * `status` - The status of the network interface. If the network
+      #     interface is not attached to an instance, the status is `available`;
+      #     if a network interface is attached to an instance the status is
+      #     `in-use`.
+      #
+      #   * `subnet-id` - The ID of the subnet for the network interface.
+      #
+      #   * `tag`\:*key*=*value* - The key/value combination of a tag assigned
+      #     to the resource.
+      #
+      #   * `tag-key` - The key of a tag assigned to the resource. This filter
+      #     is independent of the `tag-value` filter. For example, if you use
+      #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
+      #     you get any resources assigned both the tag key Purpose (regardless
+      #     of what the tag's value is), and the tag value X (regardless of
+      #     what the tag's key is). If you want to list only resources where
+      #     Purpose is X, see the `tag`\:*key*=*value* filter.
+      #
+      #   * `tag-value` - The value of a tag assigned to the resource. This
+      #     filter is independent of the `tag-key` filter.
+      #
+      #   * `vpc-id` - The ID of the VPC for the network interface.
+      # @return [NetworkInterface::Collection]
+      def network_interfaces(options = {})
+        batches = Enumerator.new do |y|
+          batch = []
+          options = Aws::Util.deep_merge(options, filters: [{
+            name: "vpc-id",
+            values: [@id]
+          }])
+          resp = @client.describe_network_interfaces(options)
+          resp.data.network_interfaces.each do |n|
+            batch << NetworkInterface.new(
+              id: n.network_interface_id,
+              data: n,
+              client: @client
+            )
+          end
+          y.yield(batch)
+        end
+        NetworkInterface::Collection.new(batches)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   requestedvpcpeeringconnections = vpc.requested_vpc_peering_connections({
+      #     dry_run: false,
+      #     vpc_peering_connection_ids: ["String"],
+      #     filters: [
+      #       {
+      #         name: "String",
+      #         values: ["String"],
+      #       },
+      #     ],
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [Array<String>] :vpc_peering_connection_ids
+      #   One or more VPC peering connection IDs.
+      #
+      #   Default: Describes all your VPC peering connections.
+      # @option options [Array<Types::Filter>] :filters
+      #   One or more filters.
+      #
+      #   * `accepter-vpc-info.cidr-block` - The CIDR block of the peer VPC.
+      #
+      #   * `accepter-vpc-info.owner-id` - The AWS account ID of the owner of
+      #     the peer VPC.
+      #
+      #   * `accepter-vpc-info.vpc-id` - The ID of the peer VPC.
+      #
+      #   * `expiration-time` - The expiration date and time for the VPC peering
+      #     connection.
+      #
+      #   * `requester-vpc-info.cidr-block` - The CIDR block of the requester's
+      #     VPC.
+      #
+      #   * `requester-vpc-info.owner-id` - The AWS account ID of the owner of
+      #     the requester VPC.
+      #
+      #   * `requester-vpc-info.vpc-id` - The ID of the requester VPC.
+      #
+      #   * `status-code` - The status of the VPC peering connection
+      #     (`pending-acceptance` \| `failed` \| `expired` \| `provisioning` \|
+      #     `active` \| `deleted` \| `rejected`).
+      #
+      #   * `status-message` - A message that provides more information about
+      #     the status of the VPC peering connection, if applicable.
+      #
+      #   * `tag`\:*key*=*value* - The key/value combination of a tag assigned
+      #     to the resource.
+      #
+      #   * `tag-key` - The key of a tag assigned to the resource. This filter
+      #     is independent of the `tag-value` filter. For example, if you use
+      #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
+      #     you get any resources assigned both the tag key Purpose (regardless
+      #     of what the tag's value is), and the tag value X (regardless of
+      #     what the tag's key is). If you want to list only resources where
+      #     Purpose is X, see the `tag`\:*key*=*value* filter.
+      #
+      #   * `tag-value` - The value of a tag assigned to the resource. This
+      #     filter is independent of the `tag-key` filter.
+      #
+      #   * `vpc-peering-connection-id` - The ID of the VPC peering connection.
+      # @return [VpcPeeringConnection::Collection]
+      def requested_vpc_peering_connections(options = {})
+        batches = Enumerator.new do |y|
+          batch = []
+          options = Aws::Util.deep_merge(options, filters: [{
+            name: "requester-vpc-info.vpc-id",
+            values: [@id]
+          }])
+          resp = @client.describe_vpc_peering_connections(options)
+          resp.data.vpc_peering_connections.each do |v|
+            batch << VpcPeeringConnection.new(
+              id: v.vpc_peering_connection_id,
+              data: v,
+              client: @client
+            )
+          end
+          y.yield(batch)
+        end
+        VpcPeeringConnection::Collection.new(batches)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   routetables = vpc.route_tables({
+      #     dry_run: false,
+      #     route_table_ids: ["String"],
+      #     filters: [
+      #       {
+      #         name: "String",
+      #         values: ["String"],
+      #       },
+      #     ],
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [Array<String>] :route_table_ids
+      #   One or more route table IDs.
+      #
+      #   Default: Describes all your route tables.
+      # @option options [Array<Types::Filter>] :filters
+      #   One or more filters.
+      #
+      #   * `association.route-table-association-id` - The ID of an association
+      #     ID for the route table.
+      #
+      #   * `association.route-table-id` - The ID of the route table involved in
+      #     the association.
+      #
+      #   * `association.subnet-id` - The ID of the subnet involved in the
+      #     association.
+      #
+      #   * `association.main` - Indicates whether the route table is the main
+      #     route table for the VPC (`true` \| `false`).
+      #
+      #   * `route-table-id` - The ID of the route table.
+      #
+      #   * `route.destination-cidr-block` - The CIDR range specified in a route
+      #     in the table.
+      #
+      #   * `route.destination-prefix-list-id` - The ID (prefix) of the AWS
+      #     service specified in a route in the table.
+      #
+      #   * `route.gateway-id` - The ID of a gateway specified in a route in the
+      #     table.
+      #
+      #   * `route.instance-id` - The ID of an instance specified in a route in
+      #     the table.
+      #
+      #   * `route.nat-gateway-id` - The ID of a NAT gateway.
+      #
+      #   * `route.origin` - Describes how the route was created.
+      #     `CreateRouteTable` indicates that the route was automatically
+      #     created when the route table was created; `CreateRoute` indicates
+      #     that the route was manually added to the route table;
+      #     `EnableVgwRoutePropagation` indicates that the route was propagated
+      #     by route propagation.
+      #
+      #   * `route.state` - The state of a route in the route table (`active` \|
+      #     `blackhole`). The blackhole state indicates that the route's target
+      #     isn't available (for example, the specified gateway isn't attached
+      #     to the VPC, the specified NAT instance has been terminated, and so
+      #     on).
+      #
+      #   * `route.vpc-peering-connection-id` - The ID of a VPC peering
+      #     connection specified in a route in the table.
+      #
+      #   * `tag`\:*key*=*value* - The key/value combination of a tag assigned
+      #     to the resource.
+      #
+      #   * `tag-key` - The key of a tag assigned to the resource. This filter
+      #     is independent of the `tag-value` filter. For example, if you use
+      #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
+      #     you get any resources assigned both the tag key Purpose (regardless
+      #     of what the tag's value is), and the tag value X (regardless of
+      #     what the tag's key is). If you want to list only resources where
+      #     Purpose is X, see the `tag`\:*key*=*value* filter.
+      #
+      #   * `tag-value` - The value of a tag assigned to the resource. This
+      #     filter is independent of the `tag-key` filter.
+      #
+      #   * `vpc-id` - The ID of the VPC for the route table.
+      # @return [RouteTable::Collection]
+      def route_tables(options = {})
+        batches = Enumerator.new do |y|
+          batch = []
+          options = Aws::Util.deep_merge(options, filters: [{
+            name: "vpc-id",
+            values: [@id]
+          }])
+          resp = @client.describe_route_tables(options)
+          resp.data.route_tables.each do |r|
+            batch << RouteTable.new(
+              id: r.route_table_id,
+              data: r,
+              client: @client
+            )
+          end
+          y.yield(batch)
+        end
+        RouteTable::Collection.new(batches)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   securitygroups = vpc.security_groups({
+      #     dry_run: false,
+      #     group_names: ["String"],
+      #     group_ids: ["String"],
+      #     filters: [
+      #       {
+      #         name: "String",
+      #         values: ["String"],
+      #       },
+      #     ],
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [Array<String>] :group_names
+      #   \[EC2-Classic and default VPC only\] One or more security group names.
+      #   You can specify either the security group name or the security group
+      #   ID. For security groups in a nondefault VPC, use the `group-name`
+      #   filter to describe security groups by name.
+      #
+      #   Default: Describes all your security groups.
+      # @option options [Array<String>] :group_ids
+      #   One or more security group IDs. Required for security groups in a
+      #   nondefault VPC.
+      #
+      #   Default: Describes all your security groups.
+      # @option options [Array<Types::Filter>] :filters
+      #   One or more filters. If using multiple filters for rules, the results
+      #   include security groups for which any combination of rules - not
+      #   necessarily a single rule - match all filters.
+      #
+      #   * `description` - The description of the security group.
+      #
+      #   * `egress.ip-permission.prefix-list-id` - The ID (prefix) of the AWS
+      #     service to which the security group allows access.
+      #
+      #   * `group-id` - The ID of the security group.
+      #
+      #   * `group-name` - The name of the security group.
+      #
+      #   * `ip-permission.cidr` - A CIDR range that has been granted
+      #     permission.
+      #
+      #   * `ip-permission.from-port` - The start of port range for the TCP and
+      #     UDP protocols, or an ICMP type number.
+      #
+      #   * `ip-permission.group-id` - The ID of a security group that has been
+      #     granted permission.
+      #
+      #   * `ip-permission.group-name` - The name of a security group that has
+      #     been granted permission.
+      #
+      #   * `ip-permission.protocol` - The IP protocol for the permission (`tcp`
+      #     \| `udp` \| `icmp` or a protocol number).
+      #
+      #   * `ip-permission.to-port` - The end of port range for the TCP and UDP
+      #     protocols, or an ICMP code.
+      #
+      #   * `ip-permission.user-id` - The ID of an AWS account that has been
+      #     granted permission.
+      #
+      #   * `owner-id` - The AWS account ID of the owner of the security group.
+      #
+      #   * `tag-key` - The key of a tag assigned to the security group.
+      #
+      #   * `tag-value` - The value of a tag assigned to the security group.
+      #
+      #   * `vpc-id` - The ID of the VPC specified when the security group was
+      #     created.
+      # @return [SecurityGroup::Collection]
+      def security_groups(options = {})
+        batches = Enumerator.new do |y|
+          batch = []
+          options = Aws::Util.deep_merge(options, filters: [{
+            name: "vpc-id",
+            values: [@id]
+          }])
+          resp = @client.describe_security_groups(options)
+          resp.data.security_groups.each do |s|
+            batch << SecurityGroup.new(
+              id: s.group_id,
+              data: s,
+              client: @client
+            )
+          end
+          y.yield(batch)
+        end
+        SecurityGroup::Collection.new(batches)
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   subnets = vpc.subnets({
+      #     dry_run: false,
+      #     subnet_ids: ["String"],
+      #     filters: [
+      #       {
+      #         name: "String",
+      #         values: ["String"],
+      #       },
+      #     ],
+      #   })
+      # @param [Hash] options ({})
+      # @option options [Boolean] :dry_run
+      #   Checks whether you have the required permissions for the action,
+      #   without actually making the request, and provides an error response.
+      #   If you have the required permissions, the error response is
+      #   `DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.
+      # @option options [Array<String>] :subnet_ids
+      #   One or more subnet IDs.
+      #
+      #   Default: Describes all your subnets.
+      # @option options [Array<Types::Filter>] :filters
+      #   One or more filters.
+      #
+      #   * `availabilityZone` - The Availability Zone for the subnet. You can
+      #     also use `availability-zone` as the filter name.
+      #
+      #   * `available-ip-address-count` - The number of IP addresses in the
+      #     subnet that are available.
+      #
+      #   * `cidrBlock` - The CIDR block of the subnet. The CIDR block you
+      #     specify must exactly match the subnet's CIDR block for information
+      #     to be returned for the subnet. You can also use `cidr` or
+      #     `cidr-block` as the filter names.
+      #
+      #   * `defaultForAz` - Indicates whether this is the default subnet for
+      #     the Availability Zone. You can also use `default-for-az` as the
+      #     filter name.
+      #
+      #   * `state` - The state of the subnet (`pending` \| `available`).
+      #
+      #   * `subnet-id` - The ID of the subnet.
+      #
+      #   * `tag`\:*key*=*value* - The key/value combination of a tag assigned
+      #     to the resource.
+      #
+      #   * `tag-key` - The key of a tag assigned to the resource. This filter
+      #     is independent of the `tag-value` filter. For example, if you use
+      #     both the filter "tag-key=Purpose" and the filter "tag-value=X",
+      #     you get any resources assigned both the tag key Purpose (regardless
+      #     of what the tag's value is), and the tag value X (regardless of
+      #     what the tag's key is). If you want to list only resources where
+      #     Purpose is X, see the `tag`\:*key*=*value* filter.
+      #
+      #   * `tag-value` - The value of a tag assigned to the resource. This
+      #     filter is independent of the `tag-key` filter.
+      #
+      #   * `vpc-id` - The ID of the VPC for the subnet.
+      # @return [Subnet::Collection]
+      def subnets(options = {})
+        batches = Enumerator.new do |y|
+          batch = []
+          options = Aws::Util.deep_merge(options, filters: [{
+            name: "vpc-id",
+            values: [@id]
+          }])
+          resp = @client.describe_subnets(options)
+          resp.data.subnets.each do |s|
+            batch << Subnet.new(
+              id: s.subnet_id,
+              data: s,
+              client: @client
+            )
+          end
+          y.yield(batch)
+        end
+        Subnet::Collection.new(batches)
+      end
+
+      # @deprecated
+      # @api private
+      def identifiers
+        { id: @id }
+      end
+      deprecated(:identifiers)
+
+      private
+
+      def extract_id(args, options)
+        value = args[0] || options.delete(:id)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :id"
+        else
+          msg = "expected :id to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      def yield_waiter_and_warn(waiter, &block)
+        if !@waiter_block_warned
+          msg = "pass options to configure the waiter; "
+          msg << "yielding the waiter is deprecated"
+          warn(msg)
+          @waiter_block_warned = true
+        end
+        yield(waiter.waiter)
+      end
+
+      def separate_params_and_options(options)
+        opts = Set.new([:client, :max_attempts, :delay, :before_attempt, :before_wait])
+        waiter_opts = {}
+        waiter_params = {}
+        options.each_pair do |key, value|
+          if opts.include?(key)
+            waiter_opts[key] = value
+          else
+            waiter_params[key] = value
+          end
+        end
+        waiter_opts[:client] ||= @client
+        [waiter_opts, waiter_params]
+      end
+
+      class Collection < Aws::Resources::Collection; end
+    end
+  end
+end