# 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 RDS
    class DBSubnetGroup

      extend Aws::Deprecations

      # @overload def initialize(name, options = {})
      #   @param [String] name
      #   @option options [Client] :client
      # @overload def initialize(options = {})
      #   @option options [required, String] :name
      #   @option options [Client] :client
      def initialize(*args)
        options = Hash === args.last ? args.pop.dup : {}
        @name = extract_name(args, options)
        @data = options.delete(:data)
        @client = options.delete(:client) || Client.new(options)
      end

      # @!group Read-Only Attributes

      # @return [String]
      def name
        @name
      end
      alias :db_subnet_group_name :name

      # Provides the description of the DB subnet group.
      # @return [String]
      def db_subnet_group_description
        data.db_subnet_group_description
      end

      # Provides the VpcId of the DB subnet group.
      # @return [String]
      def vpc_id
        data.vpc_id
      end

      # Provides the status of the DB subnet group.
      # @return [String]
      def subnet_group_status
        data.subnet_group_status
      end

      # Contains a list of Subnet elements.
      # @return [Array<Types::Subnet>]
      def subnets
        data.subnets
      end

      # The Amazon Resource Name (ARN) for the DB subnet group.
      # @return [String]
      def db_subnet_group_arn
        data.db_subnet_group_arn
      end

      # @!endgroup

      # @return [Client]
      def client
        @client
      end

      # Loads, or reloads {#data} for the current {DBSubnetGroup}.
      # Returns `self` making it possible to chain methods.
      #
      #     db_subnet_group.reload.data
      #
      # @return [self]
      def load
        resp = @client.describe_db_subnet_groups(db_subnet_group_name: @name)
        @data = resp.dbsubnetgroups[0]
        self
      end
      alias :reload :load

      # @return [Types::DBSubnetGroup]
      #   Returns the data for this {DBSubnetGroup}. Calls
      #   {Client#describe_db_subnet_groups} 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
      #
      #   dbsubnetgroup = db_subnet_group.create({
      #     db_subnet_group_description: "String", # required
      #     subnet_ids: ["String"], # required
      #     tags: [
      #       {
      #         key: "String",
      #         value: "String",
      #       },
      #     ],
      #   })
      # @param [Hash] options ({})
      # @option options [required, String] :db_subnet_group_description
      #   The description for the DB subnet group.
      # @option options [required, Array<String>] :subnet_ids
      #   The EC2 Subnet IDs for the DB subnet group.
      # @option options [Array<Types::Tag>] :tags
      #   A list of tags.
      # @return [DBSubnetGroup]
      def create(options = {})
        options = options.merge(db_subnet_group_name: @name)
        resp = @client.create_db_subnet_group(options)
        DBSubnetGroup.new(
          name: resp.data.db_subnet_group.db_subnet_group_name,
          data: resp.data.db_subnet_group,
          client: @client
        )
      end

      # @example Request syntax with placeholder values
      #
      #   db_subnet_group.delete()
      # @param [Hash] options ({})
      # @return [EmptyStructure]
      def delete(options = {})
        options = options.merge(db_subnet_group_name: @name)
        resp = @client.delete_db_subnet_group(options)
        resp.data
      end

      # @example Request syntax with placeholder values
      #
      #   dbsubnetgroup = db_subnet_group.modify({
      #     db_subnet_group_description: "String",
      #     subnet_ids: ["String"], # required
      #   })
      # @param [Hash] options ({})
      # @option options [String] :db_subnet_group_description
      #   The description for the DB subnet group.
      # @option options [required, Array<String>] :subnet_ids
      #   The EC2 subnet IDs for the DB subnet group.
      # @return [DBSubnetGroup]
      def modify(options = {})
        options = options.merge(db_subnet_group_name: @name)
        resp = @client.modify_db_subnet_group(options)
        DBSubnetGroup.new(
          name: resp.data.db_subnet_group.db_subnet_group_name,
          data: resp.data.db_subnet_group,
          client: @client
        )
      end

      # @deprecated
      # @api private
      def identifiers
        { name: @name }
      end
      deprecated(:identifiers)

      private

      def extract_name(args, options)
        value = args[0] || options.delete(:name)
        case value
        when String then value
        when nil then raise ArgumentError, "missing required option :name"
        else
          msg = "expected :name to be a String, got #{value.class}"
          raise ArgumentError, msg
        end
      end

      class Collection < Aws::Resources::Collection; end
    end
  end
end