aws-sdk-ec2 1.0.0.rc1

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

@@ -0,0 +1,243 @@
+# 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 Route
+
+      extend Aws::Deprecations
+
+      # @overload def initialize(route_table_id, destination_cidr_block, options = {})
+      #   @param [String] route_table_id
+      #   @param [String] destination_cidr_block
+      #   @option options [Client] :client
+      # @overload def initialize(options = {})
+      #   @option options [required, String] :route_table_id
+      #   @option options [required, String] :destination_cidr_block
+      #   @option options [Client] :client
+      def initialize(*args)
+        options = Hash === args.last ? args.pop.dup : {}
+        @route_table_id = extract_route_table_id(args, options)
+        @destination_cidr_block = extract_destination_cidr_block(args, options)
+        @data = options.delete(:data)
+        @client = options.delete(:client) || Client.new(options)
+      end
+
+      # @!group Read-Only Attributes
+
+      # @return [String]
+      def route_table_id
+        @route_table_id
+      end
+
+      # @return [String]
+      def destination_cidr_block
+        @destination_cidr_block
+      end
+
+      # The prefix of the AWS service.
+      # @return [String]
+      def destination_prefix_list_id
+        data.destination_prefix_list_id
+      end
+
+      # The ID of a gateway attached to your VPC.
+      # @return [String]
+      def gateway_id
+        data.gateway_id
+      end
+
+      # The ID of a NAT instance in your VPC.
+      # @return [String]
+      def instance_id
+        data.instance_id
+      end
+
+      # The AWS account ID of the owner of the instance.
+      # @return [String]
+      def instance_owner_id
+        data.instance_owner_id
+      end
+
+      # The ID of the network interface.
+      # @return [String]
+      def network_interface_id
+        data.network_interface_id
+      end
+
+      # The ID of the VPC peering connection.
+      # @return [String]
+      def vpc_peering_connection_id
+        data.vpc_peering_connection_id
+      end
+
+      # The ID of a NAT gateway.
+      # @return [String]
+      def nat_gateway_id
+        data.nat_gateway_id
+      end
+
+      # The state of the route. The `blackhole` state indicates that the
+      # route's target isn't available (for example, the specified gateway
+      # isn't attached to the VPC, or the specified NAT instance has been
+      # terminated).
+      # @return [String]
+      def state
+        data.state
+      end
+
+      # Describes how the route was created.
+      #
+      # * `CreateRouteTable` - The route was automatically created when the
+      #   route table was created.
+      #
+      # * `CreateRoute` - The route was manually added to the route table.
+      #
+      # * `EnableVgwRoutePropagation` - The route was propagated by route
+      #   propagation.
+      # @return [String]
+      def origin
+        data.origin
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # @raise [Errors::ResourceNotLoadable]
+      # @api private
+      def load
+        msg = "#load is not implemented, data only available via enumeration"
+        raise Errors::ResourceNotLoadable, msg
+      end
+      alias :reload :load
+
+      # @raise [Errors::ResourceNotLoadableError] Raises when {#data_loaded?} is `false`.
+      # @return [Types::Route]
+      #   Returns the data for this {Route}.
+      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
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   route.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(
+          route_table_id: @route_table_id,
+          destination_cidr_block: @destination_cidr_block
+        )
+        resp = @client.delete_route(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   route.replace({
+      #     dry_run: false,
+      #     gateway_id: "String",
+      #     instance_id: "String",
+      #     network_interface_id: "String",
+      #     vpc_peering_connection_id: "String",
+      #     nat_gateway_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] :gateway_id
+      #   The ID of an Internet gateway or virtual private gateway.
+      # @option options [String] :instance_id
+      #   The ID of a NAT instance in your VPC.
+      # @option options [String] :network_interface_id
+      #   The ID of a network interface.
+      # @option options [String] :vpc_peering_connection_id
+      #   The ID of a VPC peering connection.
+      # @option options [String] :nat_gateway_id
+      #   The ID of a NAT gateway.
+      # @return [EmptyStructure]
+      def replace(options = {})
+        options = options.merge(
+          route_table_id: @route_table_id,
+          destination_cidr_block: @destination_cidr_block
+        )
+        resp = @client.replace_route(options)
+        resp.data
+      end
+
+      # @!group Associations
+
+      # @return [RouteTable]
+      def route_table
+        RouteTable.new(
+          id: @route_table_id,
+          client: @client
+        )
+      end
+
+      # @deprecated
+      # @api private
+      def identifiers
+        {
+          route_table_id: @route_table_id,
+          destination_cidr_block: @destination_cidr_block
+        }
+      end
+      deprecated(:identifiers)
+
+      private
+
+      def extract_route_table_id(args, options)
+        value = args[0] || options.delete(:route_table_id)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :route_table_id"
+        else
+          msg = "expected :route_table_id to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      def extract_destination_cidr_block(args, options)
+        value = args[1] || options.delete(:destination_cidr_block)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :destination_cidr_block"
+        else
+          msg = "expected :destination_cidr_block to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      class Collection < Aws::Resources::Collection; end
+    end
+  end
+end

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

@@ -0,0 +1,277 @@
+# 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 RouteTable
+
+      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 :route_table_id :id
+
+      # The ID of the VPC.
+      # @return [String]
+      def vpc_id
+        data.vpc_id
+      end
+
+      # Any tags assigned to the route table.
+      # @return [Array<Types::Tag>]
+      def tags
+        data.tags
+      end
+
+      # Any virtual private gateway (VGW) propagating routes.
+      # @return [Array<Types::PropagatingVgw>]
+      def propagating_vgws
+        data.propagating_vgws
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # Loads, or reloads {#data} for the current {RouteTable}.
+      # Returns `self` making it possible to chain methods.
+      #
+      #     route_table.reload.data
+      #
+      # @return [self]
+      def load
+        resp = @client.describe_route_tables(route_table_ids: [@id])
+        @data = resp.routetables[0]
+        self
+      end
+      alias :reload :load
+
+      # @return [Types::RouteTable]
+      #   Returns the data for this {RouteTable}. Calls
+      #   {Client#describe_route_tables} 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
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   routetableassociation = route_table.associate_with_subnet({
+      #     dry_run: false,
+      #     subnet_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] :subnet_id
+      #   The ID of the subnet.
+      # @return [RouteTableAssociation]
+      def associate_with_subnet(options = {})
+        options = options.merge(route_table_id: @id)
+        resp = @client.associate_route_table(options)
+        RouteTableAssociation.new(
+          id: resp.data.association_id,
+          client: @client
+        )
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   route = route_table.create_route({
+      #     dry_run: false,
+      #     destination_cidr_block: "String", # required
+      #     gateway_id: "String",
+      #     instance_id: "String",
+      #     network_interface_id: "String",
+      #     vpc_peering_connection_id: "String",
+      #     nat_gateway_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 [required, String] :destination_cidr_block
+      #   The CIDR address block used for the destination match. Routing
+      #   decisions are based on the most specific match.
+      # @option options [String] :gateway_id
+      #   The ID of an Internet gateway or virtual private gateway attached to
+      #   your VPC.
+      # @option options [String] :instance_id
+      #   The ID of a NAT instance in your VPC. The operation fails if you
+      #   specify an instance ID unless exactly one network interface is
+      #   attached.
+      # @option options [String] :network_interface_id
+      #   The ID of a network interface.
+      # @option options [String] :vpc_peering_connection_id
+      #   The ID of a VPC peering connection.
+      # @option options [String] :nat_gateway_id
+      #   The ID of a NAT gateway.
+      # @return [Route]
+      def create_route(options = {})
+        options = options.merge(route_table_id: @id)
+        resp = @client.create_route(options)
+        Route.new(
+          route_table_id: @id,
+          destination_cidr_block: options[:destination_cidr_block],
+          client: @client
+        )
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   tag = route_table.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
+      #
+      #   route_table.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(route_table_id: @id)
+        resp = @client.delete_route_table(options)
+        resp.data
+      end
+
+      # @!group Associations
+
+      # @return [RouteTableAssociation::Collection]
+      def associations
+        batch = []
+        data.associations.each do |a|
+          batch << RouteTableAssociation.new(
+            id: a.route_table_association_id,
+            data: a,
+            client: @client
+          )
+        end
+        RouteTableAssociation::Collection.new([batch], size: batch.size)
+      end
+
+      # @return [Route::Collection]
+      def routes
+        batch = []
+        data.routes.each do |r|
+          batch << Route.new(
+            route_table_id: @id,
+            destination_cidr_block: r.destination_cidr_block,
+            data: r,
+            client: @client
+          )
+        end
+        Route::Collection.new([batch], size: batch.size)
+      end
+
+      # @return [Vpc, nil]
+      def vpc
+        if data.vpc_id
+          Vpc.new(
+            id: data.vpc_id,
+            client: @client
+          )
+        else
+          nil
+        end
+      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
+
+      class Collection < Aws::Resources::Collection; end
+    end
+  end
+end