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

      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 :db_instance_identifier :id

      # Contains the name of the compute and memory capacity class of the DB
      # instance.
      # @return [String]
      def db_instance_class
        data.db_instance_class
      end

      # Provides the name of the database engine to be used for this DB
      # instance.
      # @return [String]
      def engine
        data.engine
      end

      # Specifies the current state of this database.
      # @return [String]
      def db_instance_status
        data.db_instance_status
      end

      # Contains the master username for the DB instance.
      # @return [String]
      def master_username
        data.master_username
      end

      # The meaning of this parameter differs according to the database engine
      # you use. For example, this value returns MySQL, MariaDB, or PostgreSQL
      # information when returning values from CreateDBInstanceReadReplica
      # since Read Replicas are only supported for these engines.
      #
      # **MySQL, MariaDB, SQL Server, PostgreSQL, Amazon Aurora**
      #
      # Contains the name of the initial database of this instance that was
      # provided at create time, if one was specified when the DB instance was
      # created. This same name is returned for the life of the DB instance.
      #
      # Type: String
      #
      # **Oracle**
      #
      # Contains the Oracle System ID (SID) of the created DB instance. Not
      # shown when the returned parameters do not apply to an Oracle DB
      # instance.
      # @return [String]
      def db_name
        data.db_name
      end

      # Specifies the connection endpoint.
      # @return [Types::Endpoint]
      def endpoint
        data.endpoint
      end

      # Specifies the allocated storage size specified in gigabytes.
      # @return [Integer]
      def allocated_storage
        data.allocated_storage
      end

      # Provides the date and time the DB instance was created.
      # @return [Time]
      def instance_create_time
        data.instance_create_time
      end

      # Specifies the daily time range during which automated backups are
      # created if automated backups are enabled, as determined by the
      # `BackupRetentionPeriod`.
      # @return [String]
      def preferred_backup_window
        data.preferred_backup_window
      end

      # Specifies the number of days for which automatic DB snapshots are
      # retained.
      # @return [Integer]
      def backup_retention_period
        data.backup_retention_period
      end

      # Provides List of DB security group elements containing only
      # `DBSecurityGroup.Name` and `DBSecurityGroup.Status` subelements.
      # @return [Array<Types::DBSecurityGroupMembership>]
      def db_security_groups
        data.db_security_groups
      end

      # Provides a list of VPC security group elements that the DB instance
      # belongs to.
      # @return [Array<Types::VpcSecurityGroupMembership>]
      def vpc_security_groups
        data.vpc_security_groups
      end

      # Provides the list of DB parameter groups applied to this DB instance.
      # @return [Array<Types::DBParameterGroupStatus>]
      def db_parameter_groups
        data.db_parameter_groups
      end

      # Specifies the name of the Availability Zone the DB instance is located
      # in.
      # @return [String]
      def availability_zone
        data.availability_zone
      end

      # Specifies information on the subnet group associated with the DB
      # instance, including the name, description, and subnets in the subnet
      # group.
      # @return [Types::DBSubnetGroup]
      def db_subnet_group
        data.db_subnet_group
      end

      # Specifies the weekly time range during which system maintenance can
      # occur, in Universal Coordinated Time (UTC).
      # @return [String]
      def preferred_maintenance_window
        data.preferred_maintenance_window
      end

      # Specifies that changes to the DB instance are pending. This element is
      # only included when changes are pending. Specific changes are
      # identified by subelements.
      # @return [Types::PendingModifiedValues]
      def pending_modified_values
        data.pending_modified_values
      end

      # Specifies the latest time to which a database can be restored with
      # point-in-time restore.
      # @return [Time]
      def latest_restorable_time
        data.latest_restorable_time
      end

      # Specifies if the DB instance is a Multi-AZ deployment.
      # @return [Boolean]
      def multi_az
        data.multi_az
      end

      # Indicates the database engine version.
      # @return [String]
      def engine_version
        data.engine_version
      end

      # Indicates that minor version patches are applied automatically.
      # @return [Boolean]
      def auto_minor_version_upgrade
        data.auto_minor_version_upgrade
      end

      # Contains the identifier of the source DB instance if this DB instance
      # is a Read Replica.
      # @return [String]
      def read_replica_source_db_instance_identifier
        data.read_replica_source_db_instance_identifier
      end

      # Contains one or more identifiers of the Read Replicas associated with
      # this DB instance.
      # @return [Array<String>]
      def read_replica_db_instance_identifiers
        data.read_replica_db_instance_identifiers
      end

      # License model information for this DB instance.
      # @return [String]
      def license_model
        data.license_model
      end

      # Specifies the Provisioned IOPS (I/O operations per second) value.
      # @return [Integer]
      def iops
        data.iops
      end

      # Provides the list of option group memberships for this DB instance.
      # @return [Array<Types::OptionGroupMembership>]
      def option_group_memberships
        data.option_group_memberships
      end

      # If present, specifies the name of the character set that this instance
      # is associated with.
      # @return [String]
      def character_set_name
        data.character_set_name
      end

      # If present, specifies the name of the secondary Availability Zone for
      # a DB instance with multi-AZ support.
      # @return [String]
      def secondary_availability_zone
        data.secondary_availability_zone
      end

      # Specifies the accessibility options for the DB instance. A value of
      # true specifies an Internet-facing instance with a publicly resolvable
      # DNS name, which resolves to a public IP address. A value of false
      # specifies an internal instance with a DNS name that resolves to a
      # private IP address.
      #
      # Default: The default behavior varies depending on whether a VPC has
      # been requested or not. The following list shows the default behavior
      # in each case.
      #
      # * **Default VPC:**true
      #
      # * **VPC:**false
      #
      # If no DB subnet group has been specified as part of the request and
      # the PubliclyAccessible value has not been set, the DB instance will be
      # publicly accessible. If a specific DB subnet group has been specified
      # as part of the request and the PubliclyAccessible value has not been
      # set, the DB instance will be private.
      # @return [Boolean]
      def publicly_accessible
        data.publicly_accessible
      end

      # The status of a Read Replica. If the instance is not a Read Replica,
      # this will be blank.
      # @return [Array<Types::DBInstanceStatusInfo>]
      def status_infos
        data.status_infos
      end

      # Specifies the storage type associated with DB instance.
      # @return [String]
      def storage_type
        data.storage_type
      end

      # The ARN from the key store with which the instance is associated for
      # TDE encryption.
      # @return [String]
      def tde_credential_arn
        data.tde_credential_arn
      end

      # Specifies the port that the DB instance listens on. If the DB instance
      # is part of a DB cluster, this can be a different port than the DB
      # cluster port.
      # @return [Integer]
      def db_instance_port
        data.db_instance_port
      end

      # If the DB instance is a member of a DB cluster, contains the name of
      # the DB cluster that the DB instance is a member of.
      # @return [String]
      def db_cluster_identifier
        data.db_cluster_identifier
      end

      # Specifies whether the DB instance is encrypted.
      # @return [Boolean]
      def storage_encrypted
        data.storage_encrypted
      end

      # If `StorageEncrypted` is true, the KMS key identifier for the
      # encrypted DB instance.
      # @return [String]
      def kms_key_id
        data.kms_key_id
      end

      # The region-unique, immutable identifier for the DB instance. This
      # identifier is found in AWS CloudTrail log entries whenever the KMS key
      # for the DB instance is accessed.
      # @return [String]
      def dbi_resource_id
        data.dbi_resource_id
      end

      # The identifier of the CA certificate for this DB instance.
      # @return [String]
      def ca_certificate_identifier
        data.ca_certificate_identifier
      end

      # The Active Directory Domain membership records associated with the DB
      # instance.
      # @return [Array<Types::DomainMembership>]
      def domain_memberships
        data.domain_memberships
      end

      # Specifies whether tags are copied from the DB instance to snapshots of
      # the DB instance.
      # @return [Boolean]
      def copy_tags_to_snapshot
        data.copy_tags_to_snapshot
      end

      # The interval, in seconds, between points when Enhanced Monitoring
      # metrics are collected for the DB instance.
      # @return [Integer]
      def monitoring_interval
        data.monitoring_interval
      end

      # The Amazon Resource Name (ARN) of the Amazon CloudWatch Logs log
      # stream that receives the Enhanced Monitoring metrics data for the DB
      # instance.
      # @return [String]
      def enhanced_monitoring_resource_arn
        data.enhanced_monitoring_resource_arn
      end

      # The ARN for the IAM role that permits RDS to send Enhanced Monitoring
      # metrics to CloudWatch Logs.
      # @return [String]
      def monitoring_role_arn
        data.monitoring_role_arn
      end

      # A value that specifies the order in which an Aurora Replica is
      # promoted to the primary instance after a failure of the existing
      # primary instance. For more information, see [ Fault Tolerance for an
      # Aurora DB Cluster][1].
      #
      #
      #
      # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Aurora.Managing.html#Aurora.Managing.FaultTolerance
      # @return [Integer]
      def promotion_tier
        data.promotion_tier
      end

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

      # The time zone of the DB instance. In most cases, the `Timezone`
      # element is empty. `Timezone` content appears only for Microsoft SQL
      # Server DB instances that were created with a time zone specified.
      # @return [String]
      def timezone
        data.timezone
      end

      # @!endgroup

      # @return [Client]
      def client
        @client
      end

      # Loads, or reloads {#data} for the current {DBInstance}.
      # Returns `self` making it possible to chain methods.
      #
      #     db_instance.reload.data
      #
      # @return [self]
      def load
        resp = @client.describe_db_instances(db_instance_identifier: @id)
        @data = resp.dbinstances[0]
        self
      end
      alias :reload :load

      # @return [Types::DBInstance]
      #   Returns the data for this {DBInstance}. Calls
      #   {Client#describe_db_instances} 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
      #
      #   dbinstance = db_instance.create({
      #     db_name: "String",
      #     allocated_storage: 1,
      #     db_instance_class: "String", # required
      #     engine: "String", # required
      #     master_username: "String",
      #     master_user_password: "String",
      #     db_security_groups: ["String"],
      #     vpc_security_group_ids: ["String"],
      #     availability_zone: "String",
      #     db_subnet_group_name: "String",
      #     preferred_maintenance_window: "String",
      #     db_parameter_group_name: "String",
      #     backup_retention_period: 1,
      #     preferred_backup_window: "String",
      #     port: 1,
      #     multi_az: false,
      #     engine_version: "String",
      #     auto_minor_version_upgrade: false,
      #     license_model: "String",
      #     iops: 1,
      #     option_group_name: "String",
      #     character_set_name: "String",
      #     publicly_accessible: false,
      #     tags: [
      #       {
      #         key: "String",
      #         value: "String",
      #       },
      #     ],
      #     db_cluster_identifier: "String",
      #     storage_type: "String",
      #     tde_credential_arn: "String",
      #     tde_credential_password: "String",
      #     storage_encrypted: false,
      #     kms_key_id: "String",
      #     domain: "String",
      #     copy_tags_to_snapshot: false,
      #     monitoring_interval: 1,
      #     monitoring_role_arn: "String",
      #     domain_iam_role_name: "String",
      #     promotion_tier: 1,
      #     timezone: "String",
      #   })
      # @param [Hash] options ({})
      # @option options [String] :db_name
      #   The meaning of this parameter differs according to the database engine
      #   you use.
      #
      #   Type: String
      #
      #   **MySQL**
      #
      #   The name of the database to create when the DB instance is created. If
      #   this parameter is not specified, no database is created in the DB
      #   instance.
      #
      #   Constraints:
      #
      #   * Must contain 1 to 64 alphanumeric characters
      #
      #   * Cannot be a word reserved by the specified database engine
      #
      #   **MariaDB**
      #
      #   The name of the database to create when the DB instance is created. If
      #   this parameter is not specified, no database is created in the DB
      #   instance.
      #
      #   Constraints:
      #
      #   * Must contain 1 to 64 alphanumeric characters
      #
      #   * Cannot be a word reserved by the specified database engine
      #
      #   **PostgreSQL**
      #
      #   The name of the database to create when the DB instance is created. If
      #   this parameter is not specified, the default "postgres" database is
      #   created in the DB instance.
      #
      #   Constraints:
      #
      #   * Must contain 1 to 63 alphanumeric characters
      #
      #   * Must begin with a letter or an underscore. Subsequent characters can
      #     be letters, underscores, or digits (0-9).
      #
      #   * Cannot be a word reserved by the specified database engine
      #
      #   **Oracle**
      #
      #   The Oracle System ID (SID) of the created DB instance.
      #
      #   Default: `ORCL`
      #
      #   Constraints:
      #
      #   * Cannot be longer than 8 characters
      #
      #   ^
      #
      #   **SQL Server**
      #
      #   Not applicable. Must be null.
      #
      #   **Amazon Aurora**
      #
      #   The name of the database to create when the primary instance of the DB
      #   cluster is created. If this parameter is not specified, no database is
      #   created in the DB instance.
      #
      #   Constraints:
      #
      #   * Must contain 1 to 64 alphanumeric characters
      #
      #   * Cannot be a word reserved by the specified database engine
      # @option options [Integer] :allocated_storage
      #   The amount of storage (in gigabytes) to be initially allocated for the
      #   database instance.
      #
      #   Type: Integer
      #
      #   **MySQL**
      #
      #   Constraints: Must be an integer from 5 to 6144.
      #
      #   **MariaDB**
      #
      #   Constraints: Must be an integer from 5 to 6144.
      #
      #   **PostgreSQL**
      #
      #   Constraints: Must be an integer from 5 to 6144.
      #
      #   **Oracle**
      #
      #   Constraints: Must be an integer from 10 to 6144.
      #
      #   **SQL Server**
      #
      #   Constraints: Must be an integer from 200 to 4096 (Standard Edition and
      #   Enterprise Edition) or from 20 to 4096 (Express Edition and Web
      #   Edition)
      # @option options [required, String] :db_instance_class
      #   The compute and memory capacity of the DB instance.
      #
      #   Valid Values: `db.t1.micro | db.m1.small | db.m1.medium | db.m1.large
      #   | db.m1.xlarge | db.m2.xlarge |db.m2.2xlarge | db.m2.4xlarge |
      #   db.m3.medium | db.m3.large | db.m3.xlarge | db.m3.2xlarge |
      #   db.m4.large | db.m4.xlarge | db.m4.2xlarge | db.m4.4xlarge |
      #   db.m4.10xlarge | db.r3.large | db.r3.xlarge | db.r3.2xlarge |
      #   db.r3.4xlarge | db.r3.8xlarge | db.t2.micro | db.t2.small |
      #   db.t2.medium | db.t2.large`
      # @option options [required, String] :engine
      #   The name of the database engine to be used for this instance.
      #
      #   Valid Values: `mysql` \| `mariadb` \| `oracle-se1` \| `oracle-se2` \|
      #   `oracle-se` \| `oracle-ee` \| `sqlserver-ee` \| `sqlserver-se` \|
      #   `sqlserver-ex` \| `sqlserver-web` \| `postgres` \| `aurora`
      #
      #   Not every database engine is available for every AWS region.
      # @option options [String] :master_username
      #   The name of master user for the client DB instance.
      #
      #   **MySQL**
      #
      #   Constraints:
      #
      #   * Must be 1 to 16 alphanumeric characters.
      #
      #   * First character must be a letter.
      #
      #   * Cannot be a reserved word for the chosen database engine.
      #
      #   **MariaDB**
      #
      #   Constraints:
      #
      #   * Must be 1 to 16 alphanumeric characters.
      #
      #   * Cannot be a reserved word for the chosen database engine.
      #
      #   Type: String
      #
      #   **Oracle**
      #
      #   Constraints:
      #
      #   * Must be 1 to 30 alphanumeric characters.
      #
      #   * First character must be a letter.
      #
      #   * Cannot be a reserved word for the chosen database engine.
      #
      #   **SQL Server**
      #
      #   Constraints:
      #
      #   * Must be 1 to 128 alphanumeric characters.
      #
      #   * First character must be a letter.
      #
      #   * Cannot be a reserved word for the chosen database engine.
      #
      #   **PostgreSQL**
      #
      #   Constraints:
      #
      #   * Must be 1 to 63 alphanumeric characters.
      #
      #   * First character must be a letter.
      #
      #   * Cannot be a reserved word for the chosen database engine.
      # @option options [String] :master_user_password
      #   The password for the master database user. Can be any printable ASCII
      #   character except "/", """, or "@".
      #
      #   Type: String
      #
      #   **MySQL**
      #
      #   Constraints: Must contain from 8 to 41 characters.
      #
      #   **MariaDB**
      #
      #   Constraints: Must contain from 8 to 41 characters.
      #
      #   **Oracle**
      #
      #   Constraints: Must contain from 8 to 30 characters.
      #
      #   **SQL Server**
      #
      #   Constraints: Must contain from 8 to 128 characters.
      #
      #   **PostgreSQL**
      #
      #   Constraints: Must contain from 8 to 128 characters.
      #
      #   **Amazon Aurora**
      #
      #   Constraints: Must contain from 8 to 41 characters.
      # @option options [Array<String>] :db_security_groups
      #   A list of DB security groups to associate with this DB instance.
      #
      #   Default: The default DB security group for the database engine.
      # @option options [Array<String>] :vpc_security_group_ids
      #   A list of EC2 VPC security groups to associate with this DB instance.
      #
      #   Default: The default EC2 VPC security group for the DB subnet group's
      #   VPC.
      # @option options [String] :availability_zone
      #   The EC2 Availability Zone that the database instance will be created
      #   in. For information on regions and Availability Zones, see [Regions
      #   and Availability Zones][1].
      #
      #   Default: A random, system-chosen Availability Zone in the endpoint's
      #   region.
      #
      #   Example: `us-east-1d`
      #
      #   Constraint: The AvailabilityZone parameter cannot be specified if the
      #   MultiAZ parameter is set to `true`. The specified Availability Zone
      #   must be in the same region as the current endpoint.
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html
      # @option options [String] :db_subnet_group_name
      #   A DB subnet group to associate with this DB instance.
      #
      #   If there is no DB subnet group, then it is a non-VPC DB instance.
      # @option options [String] :preferred_maintenance_window
      #   The weekly time range during which system maintenance can occur, in
      #   Universal Coordinated Time (UTC). For more information, see [DB
      #   Instance Maintenance][1].
      #
      #   Format: `ddd:hh24:mi-ddd:hh24:mi`
      #
      #   Default: A 30-minute window selected at random from an 8-hour block of
      #   time per region, occurring on a random day of the week. To see the
      #   time blocks available, see [ Adjusting the Preferred Maintenance
      #   Window][2] in the *Amazon RDS User Guide.*
      #
      #   Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
      #
      #   Constraints: Minimum 30-minute window.
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBMaintenance.html
      #   [2]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/AdjustingTheMaintenanceWindow.html
      # @option options [String] :db_parameter_group_name
      #   The name of the DB parameter group to associate with this DB instance.
      #   If this argument is omitted, the default DBParameterGroup for the
      #   specified engine will be used.
      #
      #   Constraints:
      #
      #   * Must be 1 to 255 alphanumeric characters
      #
      #   * First character must be a letter
      #
      #   * Cannot end with a hyphen or contain two consecutive hyphens
      # @option options [Integer] :backup_retention_period
      #   The number of days for which automated backups are retained. Setting
      #   this parameter to a positive number enables backups. Setting this
      #   parameter to 0 disables automated backups.
      #
      #   Default: 1
      #
      #   Constraints:
      #
      #   * Must be a value from 0 to 35
      #
      #   * Cannot be set to 0 if the DB instance is a source to Read Replicas
      # @option options [String] :preferred_backup_window
      #   The daily time range during which automated backups are created if
      #   automated backups are enabled, using the `BackupRetentionPeriod`
      #   parameter. For more information, see [DB Instance Backups][1].
      #
      #   Default: A 30-minute window selected at random from an 8-hour block of
      #   time per region. To see the time blocks available, see [ Adjusting the
      #   Preferred Maintenance Window][2] in the *Amazon RDS User Guide.*
      #
      #   Constraints:
      #
      #   * Must be in the format `hh24:mi-hh24:mi`.
      #
      #   * Times should be in Universal Coordinated Time (UTC).
      #
      #   * Must not conflict with the preferred maintenance window.
      #
      #   * Must be at least 30 minutes.
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.BackingUpAndRestoringAmazonRDSInstances.html
      #   [2]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/AdjustingTheMaintenanceWindow.html
      # @option options [Integer] :port
      #   The port number on which the database accepts connections.
      #
      #   **MySQL**
      #
      #   Default: `3306`
      #
      #   Valid Values: `1150-65535`
      #
      #   Type: Integer
      #
      #   **MariaDB**
      #
      #   Default: `3306`
      #
      #   Valid Values: `1150-65535`
      #
      #   Type: Integer
      #
      #   **PostgreSQL**
      #
      #   Default: `5432`
      #
      #   Valid Values: `1150-65535`
      #
      #   Type: Integer
      #
      #   **Oracle**
      #
      #   Default: `1521`
      #
      #   Valid Values: `1150-65535`
      #
      #   **SQL Server**
      #
      #   Default: `1433`
      #
      #   Valid Values: `1150-65535` except for `1434`, `3389`, `47001`,
      #   `49152`, and `49152` through `49156`.
      #
      #   **Amazon Aurora**
      #
      #   Default: `3306`
      #
      #   Valid Values: `1150-65535`
      #
      #   Type: Integer
      # @option options [Boolean] :multi_az
      #   Specifies if the DB instance is a Multi-AZ deployment. You cannot set
      #   the AvailabilityZone parameter if the MultiAZ parameter is set to
      #   true.
      # @option options [String] :engine_version
      #   The version number of the database engine to use.
      #
      #   The following are the database engines and major and minor versions
      #   that are available with Amazon RDS. Not every database engine is
      #   available for every AWS region.
      #
      #   **Amazon Aurora**
      #
      #   * **Version 5.6 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-south-1, ap-southeast-2, eu-west-1, us-east-1,
      #     us-west-2):** ` 5.6.10a`
      #
      #   ^
      #
      #   **MariaDB**
      #
      #   * **Version 10.1 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
      #     eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
      #     us-west-2):** ` 10.1.14`
      #
      #   * **Version 10.0 (available in all AWS regions):** ` 10.0.17 |
      #     10.0.24`
      #
      #   **MySQL**
      #
      #   * **Version 5.7 (available in all AWS regions):** ` 5.7.10 | 5.7.11`
      #
      #   * **Version 5.6 (available in all AWS regions):** ` 5.6.27 | 5.6.29`
      #
      #   * **Version 5.6 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-southeast-1, ap-southeast-2, eu-central-1,
      #     eu-west-1, sa-east-1, us-east-1, us-gov-west-1, us-west-1,
      #     us-west-2):** ` 5.6.23`
      #
      #   * **Version 5.6 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 5.6.19a |
      #     5.6.19b | 5.6.21 | 5.6.21b | 5.6.22`
      #
      #   * **Version 5.5 (available in all AWS regions):** ` 5.5.46`
      #
      #   * **Version 5.5 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-southeast-1, ap-southeast-2, eu-central-1,
      #     eu-west-1, sa-east-1, us-east-1, us-gov-west-1, us-west-1,
      #     us-west-2):** ` 5.5.42`
      #
      #   * **Version 5.5 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 5.5.40b |
      #     5.5.41`
      #
      #   * **Version 5.5 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-west-1, sa-east-1, us-east-1,
      #     us-gov-west-1, us-west-1, us-west-2):** ` 5.5.40 | 5.5.40a`
      #
      #   **Oracle Database Enterprise Edition (oracle-ee)**
      #
      #   * **Version 12.1.0.2 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
      #     eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
      #     us-west-2):** ` 12.1.0.2.v5`
      #
      #   * **Version 12.1.0.2 (available in all AWS regions):** ` 12.1.0.2.v1 |
      #     12.1.0.2.v2 | 12.1.0.2.v3 | 12.1.0.2.v4`
      #
      #   * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-west-1, us-west-2):** ` 12.1.0.1.v6`
      #
      #   * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 12.1.0.1.v3 |
      #     12.1.0.1.v4 | 12.1.0.1.v5`
      #
      #   * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-gov-west-1, us-gov-west-1, us-west-1, us-west-2):** `
      #     12.1.0.1.v1 | 12.1.0.1.v2`
      #
      #   * **Version 11.2.0.4 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
      #     eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
      #     us-west-2):** ` 11.2.0.4.v6 | 11.2.0.4.v9`
      #
      #   * **Version 11.2.0.4 (available in all AWS regions):** ` 11.2.0.4.v1 |
      #     11.2.0.4.v3 | 11.2.0.4.v4 | 11.2.0.4.v5 | 11.2.0.4.v7 | 11.2.0.4.v8`
      #
      #   **Oracle Database Standard Edition Two (oracle-se2)**
      #
      #   * **Version 12.1.0.2 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
      #     eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
      #     us-west-2):** ` 12.1.0.2.v5`
      #
      #   * **Version 12.1.0.2 (available in all AWS regions):** ` 12.1.0.2.v2 |
      #     12.1.0.2.v3 | 12.1.0.2.v4`
      #
      #   **Oracle Database Standard Edition One (oracle-se1)**
      #
      #   * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-west-1, us-west-2):** ` 12.1.0.1.v6`
      #
      #   * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 12.1.0.1.v3 |
      #     12.1.0.1.v4 | 12.1.0.1.v5`
      #
      #   * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-gov-west-1, us-gov-west-1, us-west-1, us-west-2):** `
      #     12.1.0.1.v1 | 12.1.0.1.v2`
      #
      #   * **Version 11.2.0.4 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
      #     eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
      #     us-west-2):** ` 11.2.0.4.v6 | 11.2.0.4.v9`
      #
      #   * **Version 11.2.0.4 (available in all AWS regions):** ` 11.2.0.4.v1 |
      #     11.2.0.4.v3 | 11.2.0.4.v4 | 11.2.0.4.v5 | 11.2.0.4.v7 | 11.2.0.4.v8`
      #
      #   **Oracle Database Standard Edition (oracle-se)**
      #
      #   * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-west-1, us-west-2):** ` 12.1.0.1.v6`
      #
      #   * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 12.1.0.1.v3 |
      #     12.1.0.1.v4 | 12.1.0.1.v5`
      #
      #   * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-gov-west-1, us-gov-west-1, us-west-1, us-west-2):** `
      #     12.1.0.1.v1 | 12.1.0.1.v2`
      #
      #   * **Version 11.2.0.4 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
      #     eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
      #     us-west-2):** ` 11.2.0.4.v6 | 11.2.0.4.v9`
      #
      #   * **Version 11.2.0.4 (available in all AWS regions):** ` 11.2.0.4.v1 |
      #     11.2.0.4.v3 | 11.2.0.4.v4 | 11.2.0.4.v5 | 11.2.0.4.v7 | 11.2.0.4.v8`
      #
      #   **PostgreSQL**
      #
      #   * **Version 9.5 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
      #     eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
      #     us-west-2):** ` 9.5.2 | 9.5.4`
      #
      #   * **Version 9.4 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
      #     eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
      #     us-west-2):** ` 9.4.7 | 9.4.9`
      #
      #   * **Version 9.4 (available in all AWS regions):** ` 9.4.5`
      #
      #   * **Version 9.4 (available in these AWS regions: ap-northeast-1,
      #     ap-northeast-2, ap-southeast-1, ap-southeast-2, eu-central-1,
      #     eu-west-1, sa-east-1, us-east-1, us-gov-west-1, us-west-1,
      #     us-west-2):** ` 9.4.1 | 9.4.4`
      #
      #   * **Version 9.3 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 9.3.10 | 9.3.3
      #     | 9.3.5 | 9.3.6 | 9.3.9`
      #
      #   * **Version 9.3 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-west-1, sa-east-1, us-east-1,
      #     us-gov-west-1, us-west-1, us-west-2):** ` 9.3.1 | 9.3.2`
      #
      #   * **Version 9.3 (available in these AWS regions: ap-northeast-1,
      #     ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
      #     us-east-1, us-west-1, us-west-2):** ` 9.3.12 | 9.3.14`
      #
      #   **Microsoft SQL Server Enterprise Edition (sqlserver-ee)**
      #
      #   * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
      #     | 11.00.5058.0.v1 | 11.00.6020.0.v1`
      #
      #   * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
      #     | 10.50.6000.34.v1 | 10.50.6529.0.v1`
      #
      #   **Microsoft SQL Server Express Edition (sqlserver-ex)**
      #
      #   * **Version 12.00 (available in all AWS regions):** ` 12.00.4422.0.v1`
      #
      #   * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
      #     | 11.00.5058.0.v1 | 11.00.6020.0.v1`
      #
      #   * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
      #     | 10.50.6000.34.v1 | 10.50.6529.0.v1`
      #
      #   **Microsoft SQL Server Standard Edition (sqlserver-se)**
      #
      #   * **Version 12.00 (available in all AWS regions):** ` 12.00.4422.0.v1`
      #
      #   * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
      #     | 11.00.5058.0.v1 | 11.00.6020.0.v1`
      #
      #   * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
      #     | 10.50.6000.34.v1 | 10.50.6529.0.v1`
      #
      #   **Microsoft SQL Server Web Edition (sqlserver-web)**
      #
      #   * **Version 12.00 (available in all AWS regions):** ` 12.00.4422.0.v1`
      #
      #   * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
      #     | 11.00.5058.0.v1 | 11.00.6020.0.v1`
      #
      #   * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
      #     | 10.50.6000.34.v1 | 10.50.6529.0.v1`
      # @option options [Boolean] :auto_minor_version_upgrade
      #   Indicates that minor engine upgrades will be applied automatically to
      #   the DB instance during the maintenance window.
      #
      #   Default: `true`
      # @option options [String] :license_model
      #   License model information for this DB instance.
      #
      #   Valid values: `license-included` \| `bring-your-own-license` \|
      #   `general-public-license`
      # @option options [Integer] :iops
      #   The amount of Provisioned IOPS (input/output operations per second) to
      #   be initially allocated for the DB instance.
      #
      #   Constraints: Must be a multiple between 3 and 10 of the storage amount
      #   for the DB instance. Must also be an integer multiple of 1000. For
      #   example, if the size of your DB instance is 500 GB, then your `Iops`
      #   value can be 2000, 3000, 4000, or 5000.
      # @option options [String] :option_group_name
      #   Indicates that the DB instance should be associated with the specified
      #   option group.
      #
      #   Permanent options, such as the TDE option for Oracle Advanced Security
      #   TDE, cannot be removed from an option group, and that option group
      #   cannot be removed from a DB instance once it is associated with a DB
      #   instance
      # @option options [String] :character_set_name
      #   For supported engines, indicates that the DB instance should be
      #   associated with the specified CharacterSet.
      # @option options [Boolean] :publicly_accessible
      #   Specifies the accessibility options for the DB instance. A value of
      #   true specifies an Internet-facing instance with a publicly resolvable
      #   DNS name, which resolves to a public IP address. A value of false
      #   specifies an internal instance with a DNS name that resolves to a
      #   private IP address.
      #
      #   Default: The default behavior varies depending on whether a VPC has
      #   been requested or not. The following list shows the default behavior
      #   in each case.
      #
      #   * **Default VPC:** true
      #
      #   * **VPC:** false
      #
      #   If no DB subnet group has been specified as part of the request and
      #   the PubliclyAccessible value has not been set, the DB instance will be
      #   publicly accessible. If a specific DB subnet group has been specified
      #   as part of the request and the PubliclyAccessible value has not been
      #   set, the DB instance will be private.
      # @option options [Array<Types::Tag>] :tags
      #   A list of tags.
      # @option options [String] :db_cluster_identifier
      #   The identifier of the DB cluster that the instance will belong to.
      #
      #   For information on creating a DB cluster, see CreateDBCluster.
      #
      #   Type: String
      # @option options [String] :storage_type
      #   Specifies the storage type to be associated with the DB instance.
      #
      #   Valid values: `standard | gp2 | io1`
      #
      #   If you specify `io1`, you must also include a value for the `Iops`
      #   parameter.
      #
      #   Default: `io1` if the `Iops` parameter is specified; otherwise
      #   `standard`
      # @option options [String] :tde_credential_arn
      #   The ARN from the Key Store with which to associate the instance for
      #   TDE encryption.
      # @option options [String] :tde_credential_password
      #   The password for the given ARN from the Key Store in order to access
      #   the device.
      # @option options [Boolean] :storage_encrypted
      #   Specifies whether the DB instance is encrypted.
      #
      #   Default: false
      # @option options [String] :kms_key_id
      #   The KMS key identifier for an encrypted DB instance.
      #
      #   The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
      #   encryption key. If you are creating a DB instance with the same AWS
      #   account that owns the KMS encryption key used to encrypt the new DB
      #   instance, then you can use the KMS key alias instead of the ARN for
      #   the KM encryption key.
      #
      #   If the `StorageEncrypted` parameter is true, and you do not specify a
      #   value for the `KmsKeyId` parameter, then Amazon RDS will use your
      #   default encryption key. AWS KMS creates the default encryption key for
      #   your AWS account. Your AWS account has a different default encryption
      #   key for each AWS region.
      # @option options [String] :domain
      #   Specify the Active Directory Domain to create the instance in.
      # @option options [Boolean] :copy_tags_to_snapshot
      #   True to copy all tags from the DB instance to snapshots of the DB
      #   instance; otherwise false. The default is false.
      # @option options [Integer] :monitoring_interval
      #   The interval, in seconds, between points when Enhanced Monitoring
      #   metrics are collected for the DB instance. To disable collecting
      #   Enhanced Monitoring metrics, specify 0. The default is 0.
      #
      #   If `MonitoringRoleArn` is specified, then you must also set
      #   `MonitoringInterval` to a value other than 0.
      #
      #   Valid Values: `0, 1, 5, 10, 15, 30, 60`
      # @option options [String] :monitoring_role_arn
      #   The ARN for the IAM role that permits RDS to send enhanced monitoring
      #   metrics to CloudWatch Logs. For example,
      #   `arn:aws:iam:123456789012:role/emaccess`. For information on creating
      #   a monitoring role, go to [To create an IAM role for Amazon RDS
      #   Enhanced Monitoring][1].
      #
      #   If `MonitoringInterval` is set to a value other than 0, then you must
      #   supply a `MonitoringRoleArn` value.
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
      # @option options [String] :domain_iam_role_name
      #   Specify the name of the IAM role to be used when making API calls to
      #   the Directory Service.
      # @option options [Integer] :promotion_tier
      #   A value that specifies the order in which an Aurora Replica is
      #   promoted to the primary instance after a failure of the existing
      #   primary instance. For more information, see [ Fault Tolerance for an
      #   Aurora DB Cluster][1].
      #
      #   Default: 1
      #
      #   Valid Values: 0 - 15
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Aurora.Managing.html#Aurora.Managing.FaultTolerance
      # @option options [String] :timezone
      #   The time zone of the DB instance. The time zone parameter is currently
      #   supported only by [Microsoft SQL Server][1].
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.TimeZone
      # @return [DBInstance]
      def create(options = {})
        options = options.merge(db_instance_identifier: @id)
        resp = @client.create_db_instance(options)
        DBInstance.new(
          id: resp.data.db_instance.db_instance_identifier,
          data: resp.data.db_instance,
          client: @client
        )
      end

      # @example Request syntax with placeholder values
      #
      #   dbinstance = db_instance.create_read_replica({
      #     db_instance_identifier: "String", # required
      #     db_instance_class: "String",
      #     availability_zone: "String",
      #     port: 1,
      #     auto_minor_version_upgrade: false,
      #     iops: 1,
      #     option_group_name: "String",
      #     publicly_accessible: false,
      #     tags: [
      #       {
      #         key: "String",
      #         value: "String",
      #       },
      #     ],
      #     db_subnet_group_name: "String",
      #     storage_type: "String",
      #     copy_tags_to_snapshot: false,
      #     monitoring_interval: 1,
      #     monitoring_role_arn: "String",
      #   })
      # @param [Hash] options ({})
      # @option options [required, String] :db_instance_identifier
      #   The DB instance identifier of the Read Replica. This identifier is the
      #   unique key that identifies a DB instance. This parameter is stored as
      #   a lowercase string.
      # @option options [String] :db_instance_class
      #   The compute and memory capacity of the Read Replica.
      #
      #   Valid Values: `db.m1.small | db.m1.medium | db.m1.large | db.m1.xlarge
      #   | db.m2.xlarge |db.m2.2xlarge | db.m2.4xlarge | db.m3.medium |
      #   db.m3.large | db.m3.xlarge | db.m3.2xlarge | db.m4.large |
      #   db.m4.xlarge | db.m4.2xlarge | db.m4.4xlarge | db.m4.10xlarge |
      #   db.r3.large | db.r3.xlarge | db.r3.2xlarge | db.r3.4xlarge |
      #   db.r3.8xlarge | db.t2.micro | db.t2.small | db.t2.medium |
      #   db.t2.large`
      #
      #   Default: Inherits from the source DB instance.
      # @option options [String] :availability_zone
      #   The Amazon EC2 Availability Zone that the Read Replica will be created
      #   in.
      #
      #   Default: A random, system-chosen Availability Zone in the endpoint's
      #   region.
      #
      #   Example: `us-east-1d`
      # @option options [Integer] :port
      #   The port number that the DB instance uses for connections.
      #
      #   Default: Inherits from the source DB instance
      #
      #   Valid Values: `1150-65535`
      # @option options [Boolean] :auto_minor_version_upgrade
      #   Indicates that minor engine upgrades will be applied automatically to
      #   the Read Replica during the maintenance window.
      #
      #   Default: Inherits from the source DB instance
      # @option options [Integer] :iops
      #   The amount of Provisioned IOPS (input/output operations per second) to
      #   be initially allocated for the DB instance.
      # @option options [String] :option_group_name
      #   The option group the DB instance will be associated with. If omitted,
      #   the default option group for the engine specified will be used.
      # @option options [Boolean] :publicly_accessible
      #   Specifies the accessibility options for the DB instance. A value of
      #   true specifies an Internet-facing instance with a publicly resolvable
      #   DNS name, which resolves to a public IP address. A value of false
      #   specifies an internal instance with a DNS name that resolves to a
      #   private IP address.
      #
      #   Default: The default behavior varies depending on whether a VPC has
      #   been requested or not. The following list shows the default behavior
      #   in each case.
      #
      #   * **Default VPC:**true
      #
      #   * **VPC:**false
      #
      #   If no DB subnet group has been specified as part of the request and
      #   the PubliclyAccessible value has not been set, the DB instance will be
      #   publicly accessible. If a specific DB subnet group has been specified
      #   as part of the request and the PubliclyAccessible value has not been
      #   set, the DB instance will be private.
      # @option options [Array<Types::Tag>] :tags
      #   A list of tags.
      # @option options [String] :db_subnet_group_name
      #   Specifies a DB subnet group for the DB instance. The new DB instance
      #   will be created in the VPC associated with the DB subnet group. If no
      #   DB subnet group is specified, then the new DB instance is not created
      #   in a VPC.
      #
      #   Constraints:
      #
      #   * Can only be specified if the source DB instance identifier specifies
      #     a DB instance in another region.
      #
      #   * The specified DB subnet group must be in the same region in which
      #     the operation is running.
      #
      #   * All Read Replicas in one region that are created from the same
      #     source DB instance must either:&gt;
      #
      #     * Specify DB subnet groups from the same VPC. All these Read
      #       Replicas will be created in the same VPC.
      #
      #     * Not specify a DB subnet group. All these Read Replicas will be
      #       created outside of any VPC.
      #
      #   Constraints: Must contain no more than 255 alphanumeric characters,
      #   periods, underscores, spaces, or hyphens. Must not be default.
      #
      #   Example: `mySubnetgroup`
      # @option options [String] :storage_type
      #   Specifies the storage type to be associated with the Read Replica.
      #
      #   Valid values: `standard | gp2 | io1`
      #
      #   If you specify `io1`, you must also include a value for the `Iops`
      #   parameter.
      #
      #   Default: `io1` if the `Iops` parameter is specified; otherwise
      #   `standard`
      # @option options [Boolean] :copy_tags_to_snapshot
      #   True to copy all tags from the Read Replica to snapshots of the Read
      #   Replica; otherwise false. The default is false.
      # @option options [Integer] :monitoring_interval
      #   The interval, in seconds, between points when Enhanced Monitoring
      #   metrics are collected for the Read Replica. To disable collecting
      #   Enhanced Monitoring metrics, specify 0. The default is 0.
      #
      #   If `MonitoringRoleArn` is specified, then you must also set
      #   `MonitoringInterval` to a value other than 0.
      #
      #   Valid Values: `0, 1, 5, 10, 15, 30, 60`
      # @option options [String] :monitoring_role_arn
      #   The ARN for the IAM role that permits RDS to send enhanced monitoring
      #   metrics to CloudWatch Logs. For example,
      #   `arn:aws:iam:123456789012:role/emaccess`. For information on creating
      #   a monitoring role, go to [To create an IAM role for Amazon RDS
      #   Enhanced Monitoring][1].
      #
      #   If `MonitoringInterval` is set to a value other than 0, then you must
      #   supply a `MonitoringRoleArn` value.
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
      # @return [DBInstance]
      def create_read_replica(options = {})
        options = options.merge(source_db_instance_identifier: @id)
        resp = @client.create_db_instance_read_replica(options)
        DBInstance.new(
          id: resp.data.db_instance.db_instance_identifier,
          data: resp.data.db_instance,
          client: @client
        )
      end

      # @example Request syntax with placeholder values
      #
      #   dbsnapshot = db_instance.create_snapshot({
      #     db_snapshot_identifier: "String", # required
      #     tags: [
      #       {
      #         key: "String",
      #         value: "String",
      #       },
      #     ],
      #   })
      # @param [Hash] options ({})
      # @option options [required, String] :db_snapshot_identifier
      #   The identifier for the DB snapshot.
      #
      #   Constraints:
      #
      #   * Cannot be null, empty, or blank
      #
      #   * Must contain from 1 to 255 alphanumeric characters or hyphens
      #
      #   * First character must be a letter
      #
      #   * Cannot end with a hyphen or contain two consecutive hyphens
      #
      #   Example: `my-snapshot-id`
      # @option options [Array<Types::Tag>] :tags
      #   A list of tags.
      # @return [DBSnapshot]
      def create_snapshot(options = {})
        options = options.merge(db_instance_identifier: @id)
        resp = @client.create_db_snapshot(options)
        DBSnapshot.new(
          instance_id: resp.data.db_snapshot.db_instance_identifier,
          snapshot_id: resp.data.db_snapshot.db_snapshot_identifier,
          data: resp.data.db_snapshot,
          client: @client
        )
      end

      # @example Request syntax with placeholder values
      #
      #   dbinstance = db_instance.delete({
      #     skip_final_snapshot: false,
      #     final_db_snapshot_identifier: "String",
      #   })
      # @param [Hash] options ({})
      # @option options [Boolean] :skip_final_snapshot
      #   Determines whether a final DB snapshot is created before the DB
      #   instance is deleted. If `true` is specified, no DBSnapshot is created.
      #   If `false` is specified, a DB snapshot is created before the DB
      #   instance is deleted.
      #
      #   Note that when a DB instance is in a failure state and has a status of
      #   'failed', 'incompatible-restore', or 'incompatible-network', it
      #   can only be deleted when the SkipFinalSnapshot parameter is set to
      #   "true".
      #
      #   Specify `true` when deleting a Read Replica.
      #
      #   <note markdown="1"> The FinalDBSnapshotIdentifier parameter must be specified if
      #   SkipFinalSnapshot is `false`.
      #
      #    </note>
      #
      #   Default: `false`
      # @option options [String] :final_db_snapshot_identifier
      #   The DBSnapshotIdentifier of the new DBSnapshot created when
      #   SkipFinalSnapshot is set to `false`.
      #
      #   <note markdown="1"> Specifying this parameter and also setting the SkipFinalShapshot
      #   parameter to true results in an error.
      #
      #    </note>
      #
      #   Constraints:
      #
      #   * Must be 1 to 255 alphanumeric characters
      #
      #   * First character must be a letter
      #
      #   * Cannot end with a hyphen or contain two consecutive hyphens
      #
      #   * Cannot be specified when deleting a Read Replica.
      # @return [DBInstance]
      def delete(options = {})
        options = options.merge(db_instance_identifier: @id)
        resp = @client.delete_db_instance(options)
        DBInstance.new(
          id: resp.data.db_instance.db_instance_identifier,
          data: resp.data.db_instance,
          client: @client
        )
      end

      # @example Request syntax with placeholder values
      #
      #   dbinstance = db_instance.modify({
      #     allocated_storage: 1,
      #     db_instance_class: "String",
      #     db_subnet_group_name: "String",
      #     db_security_groups: ["String"],
      #     vpc_security_group_ids: ["String"],
      #     apply_immediately: false,
      #     master_user_password: "String",
      #     db_parameter_group_name: "String",
      #     backup_retention_period: 1,
      #     preferred_backup_window: "String",
      #     preferred_maintenance_window: "String",
      #     multi_az: false,
      #     engine_version: "String",
      #     allow_major_version_upgrade: false,
      #     auto_minor_version_upgrade: false,
      #     license_model: "String",
      #     iops: 1,
      #     option_group_name: "String",
      #     new_db_instance_identifier: "String",
      #     storage_type: "String",
      #     tde_credential_arn: "String",
      #     tde_credential_password: "String",
      #     ca_certificate_identifier: "String",
      #     domain: "String",
      #     copy_tags_to_snapshot: false,
      #     monitoring_interval: 1,
      #     db_port_number: 1,
      #     publicly_accessible: false,
      #     monitoring_role_arn: "String",
      #     domain_iam_role_name: "String",
      #     promotion_tier: 1,
      #   })
      # @param [Hash] options ({})
      # @option options [Integer] :allocated_storage
      #   The new storage capacity of the RDS instance. Changing this setting
      #   does not result in an outage and the change is applied during the next
      #   maintenance window unless `ApplyImmediately` is set to `true` for this
      #   request.
      #
      #   **MySQL**
      #
      #   Default: Uses existing setting
      #
      #   Valid Values: 5-6144
      #
      #   Constraints: Value supplied must be at least 10% greater than the
      #   current value. Values that are not at least 10% greater than the
      #   existing value are rounded up so that they are 10% greater than the
      #   current value.
      #
      #   Type: Integer
      #
      #   **MariaDB**
      #
      #   Default: Uses existing setting
      #
      #   Valid Values: 5-6144
      #
      #   Constraints: Value supplied must be at least 10% greater than the
      #   current value. Values that are not at least 10% greater than the
      #   existing value are rounded up so that they are 10% greater than the
      #   current value.
      #
      #   Type: Integer
      #
      #   **PostgreSQL**
      #
      #   Default: Uses existing setting
      #
      #   Valid Values: 5-6144
      #
      #   Constraints: Value supplied must be at least 10% greater than the
      #   current value. Values that are not at least 10% greater than the
      #   existing value are rounded up so that they are 10% greater than the
      #   current value.
      #
      #   Type: Integer
      #
      #   **Oracle**
      #
      #   Default: Uses existing setting
      #
      #   Valid Values: 10-6144
      #
      #   Constraints: Value supplied must be at least 10% greater than the
      #   current value. Values that are not at least 10% greater than the
      #   existing value are rounded up so that they are 10% greater than the
      #   current value.
      #
      #   **SQL Server**
      #
      #   Cannot be modified.
      #
      #   If you choose to migrate your DB instance from using standard storage
      #   to using Provisioned IOPS, or from using Provisioned IOPS to using
      #   standard storage, the process can take time. The duration of the
      #   migration depends on several factors such as database load, storage
      #   size, storage type (standard or Provisioned IOPS), amount of IOPS
      #   provisioned (if any), and the number of prior scale storage
      #   operations. Typical migration times are under 24 hours, but the
      #   process can take up to several days in some cases. During the
      #   migration, the DB instance will be available for use, but might
      #   experience performance degradation. While the migration takes place,
      #   nightly backups for the instance will be suspended. No other Amazon
      #   RDS operations can take place for the instance, including modifying
      #   the instance, rebooting the instance, deleting the instance, creating
      #   a Read Replica for the instance, and creating a DB snapshot of the
      #   instance.
      # @option options [String] :db_instance_class
      #   The new compute and memory capacity of the DB instance. To determine
      #   the instance classes that are available for a particular DB engine,
      #   use the DescribeOrderableDBInstanceOptions action.
      #
      #   Passing a value for this setting causes an outage during the change
      #   and is applied during the next maintenance window, unless
      #   `ApplyImmediately` is specified as `true` for this request.
      #
      #   Default: Uses existing setting
      #
      #   Valid Values: `db.t1.micro | db.m1.small | db.m1.medium | db.m1.large
      #   | db.m1.xlarge | db.m2.xlarge | db.m2.2xlarge | db.m2.4xlarge |
      #   db.m3.medium | db.m3.large | db.m3.xlarge | db.m3.2xlarge |
      #   db.m4.large | db.m4.xlarge | db.m4.2xlarge | db.m4.4xlarge |
      #   db.m4.10xlarge | db.r3.large | db.r3.xlarge | db.r3.2xlarge |
      #   db.r3.4xlarge | db.r3.8xlarge | db.t2.micro | db.t2.small |
      #   db.t2.medium | db.t2.large`
      # @option options [String] :db_subnet_group_name
      #   The new DB subnet group for the DB instance. You can use this
      #   parameter to move your DB instance to a different VPC. If your DB
      #   instance is not in a VPC, you can also use this parameter to move your
      #   DB instance into a VPC. For more information, see [Updating the VPC
      #   for a DB Instance][1].
      #
      #   Changing the subnet group causes an outage during the change. The
      #   change is applied during the next maintenance window, unless you
      #   specify `true` for the `ApplyImmediately` parameter.
      #
      #   Constraints: Must contain no more than 255 alphanumeric characters,
      #   periods, underscores, spaces, or hyphens.
      #
      #   Example: `mySubnetGroup`
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.Non-VPC2VPC
      # @option options [Array<String>] :db_security_groups
      #   A list of DB security groups to authorize on this DB instance.
      #   Changing this setting does not result in an outage and the change is
      #   asynchronously applied as soon as possible.
      #
      #   Constraints:
      #
      #   * Must be 1 to 255 alphanumeric characters
      #
      #   * First character must be a letter
      #
      #   * Cannot end with a hyphen or contain two consecutive hyphens
      # @option options [Array<String>] :vpc_security_group_ids
      #   A list of EC2 VPC security groups to authorize on this DB instance.
      #   This change is asynchronously applied as soon as possible.
      #
      #   Constraints:
      #
      #   * Must be 1 to 255 alphanumeric characters
      #
      #   * First character must be a letter
      #
      #   * Cannot end with a hyphen or contain two consecutive hyphens
      # @option options [Boolean] :apply_immediately
      #   Specifies whether the modifications in this request and any pending
      #   modifications are asynchronously applied as soon as possible,
      #   regardless of the `PreferredMaintenanceWindow` setting for the DB
      #   instance.
      #
      #   If this parameter is set to `false`, changes to the DB instance are
      #   applied during the next maintenance window. Some parameter changes can
      #   cause an outage and will be applied on the next call to
      #   RebootDBInstance, or the next failure reboot. Review the table of
      #   parameters in [Modifying a DB Instance and Using the Apply Immediately
      #   Parameter][1] to see the impact that setting `ApplyImmediately` to
      #   `true` or `false` has for each modified parameter and to determine
      #   when the changes will be applied.
      #
      #   Default: `false`
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html
      # @option options [String] :master_user_password
      #   The new password for the DB instance master user. Can be any printable
      #   ASCII character except "/", """, or "@".
      #
      #   Changing this parameter does not result in an outage and the change is
      #   asynchronously applied as soon as possible. Between the time of the
      #   request and the completion of the request, the `MasterUserPassword`
      #   element exists in the `PendingModifiedValues` element of the operation
      #   response.
      #
      #   Default: Uses existing setting
      #
      #   Constraints: Must be 8 to 41 alphanumeric characters (MySQL, MariaDB,
      #   and Amazon Aurora), 8 to 30 alphanumeric characters (Oracle), or 8 to
      #   128 alphanumeric characters (SQL Server).
      #
      #   <note markdown="1"> Amazon RDS API actions never return the password, so this action
      #   provides a way to regain access to a primary instance user if the
      #   password is lost. This includes restoring privileges that might have
      #   been accidentally revoked.
      #
      #    </note>
      # @option options [String] :db_parameter_group_name
      #   The name of the DB parameter group to apply to the DB instance.
      #   Changing this setting does not result in an outage. The parameter
      #   group name itself is changed immediately, but the actual parameter
      #   changes are not applied until you reboot the instance without
      #   failover. The db instance will NOT be rebooted automatically and the
      #   parameter changes will NOT be applied during the next maintenance
      #   window.
      #
      #   Default: Uses existing setting
      #
      #   Constraints: The DB parameter group must be in the same DB parameter
      #   group family as this DB instance.
      # @option options [Integer] :backup_retention_period
      #   The number of days to retain automated backups. Setting this parameter
      #   to a positive number enables backups. Setting this parameter to 0
      #   disables automated backups.
      #
      #   Changing this parameter can result in an outage if you change from 0
      #   to a non-zero value or from a non-zero value to 0. These changes are
      #   applied during the next maintenance window unless the
      #   `ApplyImmediately` parameter is set to `true` for this request. If you
      #   change the parameter from one non-zero value to another non-zero
      #   value, the change is asynchronously applied as soon as possible.
      #
      #   Default: Uses existing setting
      #
      #   Constraints:
      #
      #   * Must be a value from 0 to 35
      #
      #   * Can be specified for a MySQL Read Replica only if the source is
      #     running MySQL 5.6
      #
      #   * Can be specified for a PostgreSQL Read Replica only if the source is
      #     running PostgreSQL 9.3.5
      #
      #   * Cannot be set to 0 if the DB instance is a source to Read Replicas
      # @option options [String] :preferred_backup_window
      #   The daily time range during which automated backups are created if
      #   automated backups are enabled, as determined by the
      #   `BackupRetentionPeriod` parameter. Changing this parameter does not
      #   result in an outage and the change is asynchronously applied as soon
      #   as possible.
      #
      #   Constraints:
      #
      #   * Must be in the format hh24:mi-hh24:mi
      #
      #   * Times should be in Universal Time Coordinated (UTC)
      #
      #   * Must not conflict with the preferred maintenance window
      #
      #   * Must be at least 30 minutes
      # @option options [String] :preferred_maintenance_window
      #   The weekly time range (in UTC) during which system maintenance can
      #   occur, which might result in an outage. Changing this parameter does
      #   not result in an outage, except in the following situation, and the
      #   change is asynchronously applied as soon as possible. If there are
      #   pending actions that cause a reboot, and the maintenance window is
      #   changed to include the current time, then changing this parameter will
      #   cause a reboot of the DB instance. If moving this window to the
      #   current time, there must be at least 30 minutes between the current
      #   time and end of the window to ensure pending changes are applied.
      #
      #   Default: Uses existing setting
      #
      #   Format: ddd:hh24:mi-ddd:hh24:mi
      #
      #   Valid Days: Mon \| Tue \| Wed \| Thu \| Fri \| Sat \| Sun
      #
      #   Constraints: Must be at least 30 minutes
      # @option options [Boolean] :multi_az
      #   Specifies if the DB instance is a Multi-AZ deployment. Changing this
      #   parameter does not result in an outage and the change is applied
      #   during the next maintenance window unless the `ApplyImmediately`
      #   parameter is set to `true` for this request.
      #
      #   Constraints: Cannot be specified if the DB instance is a Read Replica.
      # @option options [String] :engine_version
      #   The version number of the database engine to upgrade to. Changing this
      #   parameter results in an outage and the change is applied during the
      #   next maintenance window unless the `ApplyImmediately` parameter is set
      #   to `true` for this request.
      #
      #   For major version upgrades, if a non-default DB parameter group is
      #   currently in use, a new DB parameter group in the DB parameter group
      #   family for the new engine version must be specified. The new DB
      #   parameter group can be the default for that DB parameter group family.
      #
      #   For a list of valid engine versions, see CreateDBInstance.
      # @option options [Boolean] :allow_major_version_upgrade
      #   Indicates that major version upgrades are allowed. Changing this
      #   parameter does not result in an outage and the change is
      #   asynchronously applied as soon as possible.
      #
      #   Constraints: This parameter must be set to true when specifying a
      #   value for the EngineVersion parameter that is a different major
      #   version than the DB instance's current version.
      # @option options [Boolean] :auto_minor_version_upgrade
      #   Indicates that minor version upgrades will be applied automatically to
      #   the DB instance during the maintenance window. Changing this parameter
      #   does not result in an outage except in the following case and the
      #   change is asynchronously applied as soon as possible. An outage will
      #   result if this parameter is set to `true` during the maintenance
      #   window, and a newer minor version is available, and RDS has enabled
      #   auto patching for that engine version.
      # @option options [String] :license_model
      #   The license model for the DB instance.
      #
      #   Valid values: `license-included` \| `bring-your-own-license` \|
      #   `general-public-license`
      # @option options [Integer] :iops
      #   The new Provisioned IOPS (I/O operations per second) value for the RDS
      #   instance. Changing this setting does not result in an outage and the
      #   change is applied during the next maintenance window unless the
      #   `ApplyImmediately` parameter is set to `true` for this request.
      #
      #   Default: Uses existing setting
      #
      #   Constraints: Value supplied must be at least 10% greater than the
      #   current value. Values that are not at least 10% greater than the
      #   existing value are rounded up so that they are 10% greater than the
      #   current value. If you are migrating from Provisioned IOPS to standard
      #   storage, set this value to 0. The DB instance will require a reboot
      #   for the change in storage type to take effect.
      #
      #   **SQL Server**
      #
      #   Setting the IOPS value for the SQL Server database engine is not
      #   supported.
      #
      #   Type: Integer
      #
      #   If you choose to migrate your DB instance from using standard storage
      #   to using Provisioned IOPS, or from using Provisioned IOPS to using
      #   standard storage, the process can take time. The duration of the
      #   migration depends on several factors such as database load, storage
      #   size, storage type (standard or Provisioned IOPS), amount of IOPS
      #   provisioned (if any), and the number of prior scale storage
      #   operations. Typical migration times are under 24 hours, but the
      #   process can take up to several days in some cases. During the
      #   migration, the DB instance will be available for use, but might
      #   experience performance degradation. While the migration takes place,
      #   nightly backups for the instance will be suspended. No other Amazon
      #   RDS operations can take place for the instance, including modifying
      #   the instance, rebooting the instance, deleting the instance, creating
      #   a Read Replica for the instance, and creating a DB snapshot of the
      #   instance.
      # @option options [String] :option_group_name
      #   Indicates that the DB instance should be associated with the specified
      #   option group. Changing this parameter does not result in an outage
      #   except in the following case and the change is applied during the next
      #   maintenance window unless the `ApplyImmediately` parameter is set to
      #   `true` for this request. If the parameter change results in an option
      #   group that enables OEM, this change can cause a brief (sub-second)
      #   period during which new connections are rejected but existing
      #   connections are not interrupted.
      #
      #   Permanent options, such as the TDE option for Oracle Advanced Security
      #   TDE, cannot be removed from an option group, and that option group
      #   cannot be removed from a DB instance once it is associated with a DB
      #   instance
      # @option options [String] :new_db_instance_identifier
      #   The new DB instance identifier for the DB instance when renaming a DB
      #   instance. When you change the DB instance identifier, an instance
      #   reboot will occur immediately if you set `Apply Immediately` to true,
      #   or will occur during the next maintenance window if `Apply
      #   Immediately` to false. This value is stored as a lowercase string.
      #
      #   Constraints:
      #
      #   * Must contain from 1 to 63 alphanumeric characters or hyphens
      #
      #   * First character must be a letter
      #
      #   * Cannot end with a hyphen or contain two consecutive hyphens
      # @option options [String] :storage_type
      #   Specifies the storage type to be associated with the DB instance.
      #
      #   Valid values: `standard | gp2 | io1`
      #
      #   If you specify `io1`, you must also include a value for the `Iops`
      #   parameter.
      #
      #   Default: `io1` if the `Iops` parameter is specified; otherwise
      #   `standard`
      # @option options [String] :tde_credential_arn
      #   The ARN from the Key Store with which to associate the instance for
      #   TDE encryption.
      # @option options [String] :tde_credential_password
      #   The password for the given ARN from the Key Store in order to access
      #   the device.
      # @option options [String] :ca_certificate_identifier
      #   Indicates the certificate that needs to be associated with the
      #   instance.
      # @option options [String] :domain
      #   The Active Directory Domain to move the instance to. Specify `none` to
      #   remove the instance from its current domain. The domain must be
      #   created prior to this operation. Currently only a Microsoft SQL Server
      #   instance can be created in a Active Directory Domain.
      # @option options [Boolean] :copy_tags_to_snapshot
      #   True to copy all tags from the DB instance to snapshots of the DB
      #   instance; otherwise false. The default is false.
      # @option options [Integer] :monitoring_interval
      #   The interval, in seconds, between points when Enhanced Monitoring
      #   metrics are collected for the DB instance. To disable collecting
      #   Enhanced Monitoring metrics, specify 0. The default is 0.
      #
      #   If `MonitoringRoleArn` is specified, then you must also set
      #   `MonitoringInterval` to a value other than 0.
      #
      #   Valid Values: `0, 1, 5, 10, 15, 30, 60`
      # @option options [Integer] :db_port_number
      #   The port number on which the database accepts connections.
      #
      #   The value of the `DBPortNumber` parameter must not match any of the
      #   port values specified for options in the option group for the DB
      #   instance.
      #
      #   Your database will restart when you change the `DBPortNumber` value
      #   regardless of the value of the `ApplyImmediately` parameter.
      #
      #   **MySQL**
      #
      #   Default: `3306`
      #
      #   Valid Values: `1150-65535`
      #
      #   **MariaDB**
      #
      #   Default: `3306`
      #
      #   Valid Values: `1150-65535`
      #
      #   **PostgreSQL**
      #
      #   Default: `5432`
      #
      #   Valid Values: `1150-65535`
      #
      #   Type: Integer
      #
      #   **Oracle**
      #
      #   Default: `1521`
      #
      #   Valid Values: `1150-65535`
      #
      #   **SQL Server**
      #
      #   Default: `1433`
      #
      #   Valid Values: `1150-65535` except for `1434`, `3389`, `47001`,
      #   `49152`, and `49152` through `49156`.
      #
      #   **Amazon Aurora**
      #
      #   Default: `3306`
      #
      #   Valid Values: `1150-65535`
      # @option options [Boolean] :publicly_accessible
      #   Boolean value that indicates if the DB instance has a publicly
      #   resolvable DNS name. Set to `True` to make the DB instance
      #   Internet-facing with a publicly resolvable DNS name, which resolves to
      #   a public IP address. Set to `False` to make the DB instance internal
      #   with a DNS name that resolves to a private IP address.
      #
      #   `PubliclyAccessible` only applies to DB instances in a VPC. The DB
      #   instance must be part of a public subnet and `PubliclyAccessible` must
      #   be true in order for it to be publicly accessible.
      #
      #   Changes to the `PubliclyAccessible` parameter are applied immediately
      #   regardless of the value of the `ApplyImmediately` parameter.
      #
      #   Default: false
      # @option options [String] :monitoring_role_arn
      #   The ARN for the IAM role that permits RDS to send enhanced monitoring
      #   metrics to CloudWatch Logs. For example,
      #   `arn:aws:iam:123456789012:role/emaccess`. For information on creating
      #   a monitoring role, go to [To create an IAM role for Amazon RDS
      #   Enhanced Monitoring][1].
      #
      #   If `MonitoringInterval` is set to a value other than 0, then you must
      #   supply a `MonitoringRoleArn` value.
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
      # @option options [String] :domain_iam_role_name
      #   The name of the IAM role to use when making API calls to the Directory
      #   Service.
      # @option options [Integer] :promotion_tier
      #   A value that specifies the order in which an Aurora Replica is
      #   promoted to the primary instance after a failure of the existing
      #   primary instance. For more information, see [ Fault Tolerance for an
      #   Aurora DB Cluster][1].
      #
      #   Default: 1
      #
      #   Valid Values: 0 - 15
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Aurora.Managing.html#Aurora.Managing.FaultTolerance
      # @return [DBInstance]
      def modify(options = {})
        options = options.merge(db_instance_identifier: @id)
        resp = @client.modify_db_instance(options)
        DBInstance.new(
          id: resp.data.db_instance.db_instance_identifier,
          data: resp.data.db_instance,
          client: @client
        )
      end

      # @example Request syntax with placeholder values
      #
      #   dbinstance = db_instance.promote({
      #     backup_retention_period: 1,
      #     preferred_backup_window: "String",
      #   })
      # @param [Hash] options ({})
      # @option options [Integer] :backup_retention_period
      #   The number of days to retain automated backups. Setting this parameter
      #   to a positive number enables backups. Setting this parameter to 0
      #   disables automated backups.
      #
      #   Default: 1
      #
      #   Constraints:
      #
      #   * Must be a value from 0 to 8
      #
      #   ^
      # @option options [String] :preferred_backup_window
      #   The daily time range during which automated backups are created if
      #   automated backups are enabled, using the `BackupRetentionPeriod`
      #   parameter.
      #
      #   Default: A 30-minute window selected at random from an 8-hour block of
      #   time per region. To see the time blocks available, see [ Adjusting the
      #   Preferred Maintenance Window][1] in the *Amazon RDS User Guide.*
      #
      #   Constraints:
      #
      #   * Must be in the format `hh24:mi-hh24:mi`.
      #
      #   * Times should be in Universal Coordinated Time (UTC).
      #
      #   * Must not conflict with the preferred maintenance window.
      #
      #   * Must be at least 30 minutes.
      #
      #
      #
      #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/AdjustingTheMaintenanceWindow.html
      # @return [DBInstance]
      def promote(options = {})
        options = options.merge(db_instance_identifier: @id)
        resp = @client.promote_read_replica(options)
        DBInstance.new(
          id: resp.data.db_instance.db_instance_identifier,
          data: resp.data.db_instance,
          client: @client
        )
      end

      # @example Request syntax with placeholder values
      #
      #   dbinstance = db_instance.reboot({
      #     force_failover: false,
      #   })
      # @param [Hash] options ({})
      # @option options [Boolean] :force_failover
      #   When `true`, the reboot will be conducted through a MultiAZ failover.
      #
      #   Constraint: You cannot specify `true` if the instance is not
      #   configured for MultiAZ.
      # @return [DBInstance]
      def reboot(options = {})
        options = options.merge(db_instance_identifier: @id)
        resp = @client.reboot_db_instance(options)
        DBInstance.new(
          id: resp.data.db_instance.db_instance_identifier,
          data: resp.data.db_instance,
          client: @client
        )
      end

      # @example Request syntax with placeholder values
      #
      #   dbinstance = db_instance.restore({
      #     target_db_instance_identifier: "String", # required
      #     restore_time: Time.now,
      #     use_latest_restorable_time: false,
      #     db_instance_class: "String",
      #     port: 1,
      #     availability_zone: "String",
      #     db_subnet_group_name: "String",
      #     multi_az: false,
      #     publicly_accessible: false,
      #     auto_minor_version_upgrade: false,
      #     license_model: "String",
      #     db_name: "String",
      #     engine: "String",
      #     iops: 1,
      #     option_group_name: "String",
      #     copy_tags_to_snapshot: false,
      #     tags: [
      #       {
      #         key: "String",
      #         value: "String",
      #       },
      #     ],
      #     storage_type: "String",
      #     tde_credential_arn: "String",
      #     tde_credential_password: "String",
      #     domain: "String",
      #     domain_iam_role_name: "String",
      #   })
      # @param [Hash] options ({})
      # @option options [required, String] :target_db_instance_identifier
      #   The name of the new database instance to be created.
      #
      #   Constraints:
      #
      #   * Must contain from 1 to 63 alphanumeric characters or hyphens
      #
      #   * First character must be a letter
      #
      #   * Cannot end with a hyphen or contain two consecutive hyphens
      # @option options [Time,DateTime,Date,Integer,String] :restore_time
      #   The date and time to restore from.
      #
      #   Valid Values: Value must be a time in Universal Coordinated Time (UTC)
      #   format
      #
      #   Constraints:
      #
      #   * Must be before the latest restorable time for the DB instance
      #
      #   * Cannot be specified if UseLatestRestorableTime parameter is true
      #
      #   Example: `2009-09-07T23:45:00Z`
      # @option options [Boolean] :use_latest_restorable_time
      #   Specifies whether (`true`) or not (`false`) the DB instance is
      #   restored from the latest backup time.
      #
      #   Default: `false`
      #
      #   Constraints: Cannot be specified if RestoreTime parameter is provided.
      # @option options [String] :db_instance_class
      #   The compute and memory capacity of the Amazon RDS DB instance.
      #
      #   Valid Values: `db.t1.micro | db.m1.small | db.m1.medium | db.m1.large
      #   | db.m1.xlarge | db.m2.2xlarge | db.m2.4xlarge | db.m3.medium |
      #   db.m3.large | db.m3.xlarge | db.m3.2xlarge | db.m4.large |
      #   db.m4.xlarge | db.m4.2xlarge | db.m4.4xlarge | db.m4.10xlarge |
      #   db.r3.large | db.r3.xlarge | db.r3.2xlarge | db.r3.4xlarge |
      #   db.r3.8xlarge | db.t2.micro | db.t2.small | db.t2.medium |
      #   db.t2.large`
      #
      #   Default: The same DBInstanceClass as the original DB instance.
      # @option options [Integer] :port
      #   The port number on which the database accepts connections.
      #
      #   Constraints: Value must be `1150-65535`
      #
      #   Default: The same port as the original DB instance.
      # @option options [String] :availability_zone
      #   The EC2 Availability Zone that the database instance will be created
      #   in.
      #
      #   Default: A random, system-chosen Availability Zone.
      #
      #   Constraint: You cannot specify the AvailabilityZone parameter if the
      #   MultiAZ parameter is set to true.
      #
      #   Example: `us-east-1a`
      # @option options [String] :db_subnet_group_name
      #   The DB subnet group name to use for the new instance.
      #
      #   Constraints: Must contain no more than 255 alphanumeric characters,
      #   periods, underscores, spaces, or hyphens. Must not be default.
      #
      #   Example: `mySubnetgroup`
      # @option options [Boolean] :multi_az
      #   Specifies if the DB instance is a Multi-AZ deployment.
      #
      #   Constraint: You cannot specify the AvailabilityZone parameter if the
      #   MultiAZ parameter is set to `true`.
      # @option options [Boolean] :publicly_accessible
      #   Specifies the accessibility options for the DB instance. A value of
      #   true specifies an Internet-facing instance with a publicly resolvable
      #   DNS name, which resolves to a public IP address. A value of false
      #   specifies an internal instance with a DNS name that resolves to a
      #   private IP address.
      #
      #   Default: The default behavior varies depending on whether a VPC has
      #   been requested or not. The following list shows the default behavior
      #   in each case.
      #
      #   * **Default VPC:**true
      #
      #   * **VPC:**false
      #
      #   If no DB subnet group has been specified as part of the request and
      #   the PubliclyAccessible value has not been set, the DB instance will be
      #   publicly accessible. If a specific DB subnet group has been specified
      #   as part of the request and the PubliclyAccessible value has not been
      #   set, the DB instance will be private.
      # @option options [Boolean] :auto_minor_version_upgrade
      #   Indicates that minor version upgrades will be applied automatically to
      #   the DB instance during the maintenance window.
      # @option options [String] :license_model
      #   License model information for the restored DB instance.
      #
      #   Default: Same as source.
      #
      #   Valid values: `license-included` \| `bring-your-own-license` \|
      #   `general-public-license`
      # @option options [String] :db_name
      #   The database name for the restored DB instance.
      #
      #   <note markdown="1"> This parameter is not used for the MySQL or MariaDB engines.
      #
      #    </note>
      # @option options [String] :engine
      #   The database engine to use for the new instance.
      #
      #   Default: The same as source
      #
      #   Constraint: Must be compatible with the engine of the source
      #
      #   Valid Values: `MySQL` \| `mariadb` \| `oracle-se1` \| `oracle-se` \|
      #   `oracle-ee` \| `sqlserver-ee` \| `sqlserver-se` \| `sqlserver-ex` \|
      #   `sqlserver-web` \| `postgres` \| `aurora`
      # @option options [Integer] :iops
      #   The amount of Provisioned IOPS (input/output operations per second) to
      #   be initially allocated for the DB instance.
      #
      #   Constraints: Must be an integer greater than 1000.
      #
      #   **SQL Server**
      #
      #   Setting the IOPS value for the SQL Server database engine is not
      #   supported.
      # @option options [String] :option_group_name
      #   The name of the option group to be used for the restored DB instance.
      #
      #   Permanent options, such as the TDE option for Oracle Advanced Security
      #   TDE, cannot be removed from an option group, and that option group
      #   cannot be removed from a DB instance once it is associated with a DB
      #   instance
      # @option options [Boolean] :copy_tags_to_snapshot
      #   True to copy all tags from the restored DB instance to snapshots of
      #   the DB instance; otherwise false. The default is false.
      # @option options [Array<Types::Tag>] :tags
      #   A list of tags.
      # @option options [String] :storage_type
      #   Specifies the storage type to be associated with the DB instance.
      #
      #   Valid values: `standard | gp2 | io1`
      #
      #   If you specify `io1`, you must also include a value for the `Iops`
      #   parameter.
      #
      #   Default: `io1` if the `Iops` parameter is specified; otherwise
      #   `standard`
      # @option options [String] :tde_credential_arn
      #   The ARN from the Key Store with which to associate the instance for
      #   TDE encryption.
      # @option options [String] :tde_credential_password
      #   The password for the given ARN from the Key Store in order to access
      #   the device.
      # @option options [String] :domain
      #   Specify the Active Directory Domain to restore the instance in.
      # @option options [String] :domain_iam_role_name
      #   Specify the name of the IAM role to be used when making API calls to
      #   the Directory Service.
      # @return [DBInstance]
      def restore(options = {})
        options = options.merge(source_db_instance_identifier: @id)
        resp = @client.restore_db_instance_to_point_in_time(options)
        DBInstance.new(
          id: resp.data.db_instance.db_instance_identifier,
          data: resp.data.db_instance,
          client: @client
        )
      end

      # @example Request syntax with placeholder values
      #
      #   eventsubscription = db_instance.subscribe_to({
      #     subscription_name: "String", # required
      #   })
      # @param [Hash] options ({})
      # @option options [required, String] :subscription_name
      #   The name of the RDS event notification subscription you want to add a
      #   source identifier to.
      # @return [EventSubscription]
      def subscribe_to(options = {})
        options = options.merge(source_identifier: @id)
        resp = @client.add_source_identifier_to_subscription(options)
        EventSubscription.new(
          name: resp.data.event_subscription.cust_subscription_id,
          data: resp.data.event_subscription,
          client: @client
        )
      end

      # @example Request syntax with placeholder values
      #
      #   eventsubscription = db_instance.unsubscribe_from({
      #     subscription_name: "String", # required
      #   })
      # @param [Hash] options ({})
      # @option options [required, String] :subscription_name
      #   The name of the RDS event notification subscription you want to remove
      #   a source identifier from.
      # @return [EventSubscription]
      def unsubscribe_from(options = {})
        options = options.merge(source_identifier: @id)
        resp = @client.remove_source_identifier_from_subscription(options)
        EventSubscription.new(
          name: resp.data.event_subscription.cust_subscription_id,
          data: resp.data.event_subscription,
          client: @client
        )
      end

      # @!group Associations

      # @return [Certificate, nil]
      def certificate
        if data.ca_certificate_identifier
          Certificate.new(
            id: data.ca_certificate_identifier,
            client: @client
          )
        else
          nil
        end
      end

      # @return [DBCluster, nil]
      def cluster
        if data.db_cluster_identifier
          DBCluster.new(
            id: data.db_cluster_identifier,
            client: @client
          )
        else
          nil
        end
      end

      # @example Request syntax with placeholder values
      #
      #   events = db_instance.events({
      #     start_time: Time.now,
      #     end_time: Time.now,
      #     duration: 1,
      #     event_categories: ["String"],
      #     filters: [
      #       {
      #         name: "String", # required
      #         values: ["String"], # required
      #       },
      #     ],
      #   })
      # @param [Hash] options ({})
      # @option options [Time,DateTime,Date,Integer,String] :start_time
      #   The beginning of the time interval to retrieve events for, specified
      #   in ISO 8601 format. For more information about ISO 8601, go to the
      #   [ISO8601 Wikipedia page.][1]
      #
      #   Example: 2009-07-08T18:00Z
      #
      #
      #
      #   [1]: http://en.wikipedia.org/wiki/ISO_8601
      # @option options [Time,DateTime,Date,Integer,String] :end_time
      #   The end of the time interval for which to retrieve events, specified
      #   in ISO 8601 format. For more information about ISO 8601, go to the
      #   [ISO8601 Wikipedia page.][1]
      #
      #   Example: 2009-07-08T18:00Z
      #
      #
      #
      #   [1]: http://en.wikipedia.org/wiki/ISO_8601
      # @option options [Integer] :duration
      #   The number of minutes to retrieve events for.
      #
      #   Default: 60
      # @option options [Array<String>] :event_categories
      #   A list of event categories that trigger notifications for a event
      #   notification subscription.
      # @option options [Array<Types::Filter>] :filters
      #   This parameter is not currently supported.
      # @return [Event::Collection]
      def events(options = {})
        batches = Enumerator.new do |y|
          options = options.merge(
            source_type: "db-instance",
            source_identifier: @id
          )
          resp = @client.describe_events(options)
          resp.each_page do |page|
            batch = []
            page.data.events.each do |e|
              batch << Event.new(
                source_id: e.source_identifier,
                date: e.date,
                data: e,
                client: @client
              )
            end
            y.yield(batch)
          end
        end
        Event::Collection.new(batches)
      end

      # @example Request syntax with placeholder values
      #
      #   logfiles = db_instance.log_files({
      #     filename_contains: "String",
      #     file_last_written: 1,
      #     file_size: 1,
      #     filters: [
      #       {
      #         name: "String", # required
      #         values: ["String"], # required
      #       },
      #     ],
      #   })
      # @param [Hash] options ({})
      # @option options [String] :filename_contains
      #   Filters the available log files for log file names that contain the
      #   specified string.
      # @option options [Integer] :file_last_written
      #   Filters the available log files for files written since the specified
      #   date, in POSIX timestamp format with milliseconds.
      # @option options [Integer] :file_size
      #   Filters the available log files for files larger than the specified
      #   size.
      # @option options [Array<Types::Filter>] :filters
      #   This parameter is not currently supported.
      # @return [DBLogFile::Collection]
      def log_files(options = {})
        batches = Enumerator.new do |y|
          options = options.merge(db_instance_identifier: @id)
          resp = @client.describe_db_log_files(options)
          resp.each_page do |page|
            batch = []
            page.data.describe_db_log_files.each do |d|
              batch << DBLogFile.new(
                instance_id: @id,
                name: d.log_file_name,
                data: d,
                client: @client
              )
            end
            y.yield(batch)
          end
        end
        DBLogFile::Collection.new(batches)
      end

      # @return [OptionGroup::Collection]
      def option_groups
        batch = []
        data.option_group_memberships.each do |o|
          batch << OptionGroup.new(
            name: o.option_group_name,
            client: @client
          )
        end
        OptionGroup::Collection.new([batch], size: batch.size)
      end

      # @return [DBParameterGroup::Collection]
      def parameter_groups
        batch = []
        data.db_parameter_groups.each do |d|
          batch << DBParameterGroup.new(
            name: d.db_parameter_group_name,
            client: @client
          )
        end
        DBParameterGroup::Collection.new([batch], size: batch.size)
      end

      # @example Request syntax with placeholder values
      #
      #   pendingmaintenanceactions = db_instance.pending_maintenance_actions({
      #     resource_identifier: "String",
      #     filters: [
      #       {
      #         name: "String", # required
      #         values: ["String"], # required
      #       },
      #     ],
      #     marker: "String",
      #     max_records: 1,
      #   })
      # @param [Hash] options ({})
      # @option options [String] :resource_identifier
      #   The ARN of a resource to return pending maintenance actions for.
      # @option options [Array<Types::Filter>] :filters
      #   A filter that specifies one or more resources to return pending
      #   maintenance actions for.
      #
      #   Supported filters:
      #
      #   * `db-instance-id` - Accepts DB instance identifiers and DB instance
      #     Amazon Resource Names (ARNs). The results list will only include
      #     pending maintenance actions for the DB instances identified by these
      #     ARNs.
      #
      #   ^
      # @option options [String] :marker
      #   An optional pagination token provided by a previous
      #   `DescribePendingMaintenanceActions` request. If this parameter is
      #   specified, the response includes only records beyond the marker, up to
      #   a number of records specified by `MaxRecords`.
      # @option options [Integer] :max_records
      #   The maximum number of records to include in the response. If more
      #   records exist than the specified `MaxRecords` value, a pagination
      #   token called a marker is included in the response so that the
      #   remaining results can be retrieved.
      #
      #   Default: 100
      #
      #   Constraints: Minimum 20, maximum 100.
      # @return [PendingMaintenanceAction::Collection]
      def pending_maintenance_actions(options = {})
        batches = Enumerator.new do |y|
          batch = []
          options = Aws::Util.deep_merge(options, filters: [{
            name: "db-instance-id",
            values: [@id]
          }])
          resp = @client.describe_pending_maintenance_actions(options)
          resp.data.pending_maintenance_actions_0.pending_maintenance_action_details.each do |p|
            batch << PendingMaintenanceAction.new(
              target_arn: resp.data.pending_maintenance_actions[0].resource_identifier,
              name: p.action,
              data: p,
              client: @client
            )
          end
          y.yield(batch)
        end
        PendingMaintenanceAction::Collection.new(batches)
      end

      # @return [DBInstance::Collection]
      def read_replicas
        batch = []
        data.read_replica_db_instance_identifiers.each do |r|
          batch << DBInstance.new(
            id: r,
            client: @client
          )
        end
        DBInstance::Collection.new([batch], size: batch.size)
      end

      # @return [DBSecurityGroup::Collection]
      def security_groups
        batch = []
        data.db_security_groups.each do |d|
          batch << DBSecurityGroup.new(
            name: d.db_security_group_name,
            client: @client
          )
        end
        DBSecurityGroup::Collection.new([batch], size: batch.size)
      end

      # @example Request syntax with placeholder values
      #
      #   snapshots = db_instance.snapshots({
      #     db_snapshot_identifier: "String",
      #     snapshot_type: "String",
      #     filters: [
      #       {
      #         name: "String", # required
      #         values: ["String"], # required
      #       },
      #     ],
      #     include_shared: false,
      #     include_public: false,
      #   })
      # @param [Hash] options ({})
      # @option options [String] :db_snapshot_identifier
      #   A specific DB snapshot identifier to describe. This parameter cannot
      #   be used in conjunction with `DBInstanceIdentifier`. This value is
      #   stored as a lowercase string.
      #
      #   Constraints:
      #
      #   * Must be 1 to 255 alphanumeric characters.
      #
      #   * First character must be a letter.
      #
      #   * Cannot end with a hyphen or contain two consecutive hyphens.
      #
      #   * If this identifier is for an automated snapshot, the `SnapshotType`
      #     parameter must also be specified.
      # @option options [String] :snapshot_type
      #   The type of snapshots to be returned. You can specify one of the
      #   following values:
      #
      #   * `automated` - Return all DB snapshots that have been automatically
      #     taken by Amazon RDS for my AWS account.
      #
      #   * `manual` - Return all DB snapshots that have been taken by my AWS
      #     account.
      #
      #   * `shared` - Return all manual DB snapshots that have been shared to
      #     my AWS account.
      #
      #   * `public` - Return all DB snapshots that have been marked as public.
      #
      #   If you don't specify a `SnapshotType` value, then both automated and
      #   manual snapshots are returned. Shared and public DB snapshots are not
      #   included in the returned results by default. You can include shared
      #   snapshots with these results by setting the `IncludeShared` parameter
      #   to `true`. You can include public snapshots with these results by
      #   setting the `IncludePublic` parameter to `true`.
      #
      #   The `IncludeShared` and `IncludePublic` parameters don't apply for
      #   `SnapshotType` values of `manual` or `automated`. The `IncludePublic`
      #   parameter doesn't apply when `SnapshotType` is set to `shared`. The
      #   `IncludeShared` parameter doesn't apply when `SnapshotType` is set to
      #   `public`.
      # @option options [Array<Types::Filter>] :filters
      #   This parameter is not currently supported.
      # @option options [Boolean] :include_shared
      #   Set this value to `true` to include shared manual DB snapshots from
      #   other AWS accounts that this AWS account has been given permission to
      #   copy or restore, otherwise set this value to `false`. The default is
      #   `false`.
      #
      #   You can give an AWS account permission to restore a manual DB snapshot
      #   from another AWS account by using the ModifyDBSnapshotAttribute API
      #   action.
      # @option options [Boolean] :include_public
      #   Set this value to `true` to include manual DB snapshots that are
      #   public and can be copied or restored by any AWS account, otherwise set
      #   this value to `false`. The default is `false`.
      #
      #   You can share a manual DB snapshot as public by using the
      #   ModifyDBSnapshotAttribute API.
      # @return [DBSnapshot::Collection]
      def snapshots(options = {})
        batches = Enumerator.new do |y|
          options = options.merge(db_instance_identifier: @id)
          resp = @client.describe_db_snapshots(options)
          resp.each_page do |page|
            batch = []
            page.data.db_snapshots.each do |d|
              batch << DBSnapshot.new(
                instance_id: options[:db_instance_identifier],
                snapshot_id: d.db_snapshot_identifier,
                data: d,
                client: @client
              )
            end
            y.yield(batch)
          end
        end
        DBSnapshot::Collection.new(batches)
      end

      # @return [DBInstance, nil]
      def source
        if data.read_replica_source_db_instance_identifier
          DBInstance.new(
            id: data.read_replica_source_db_instance_identifier,
            client: @client
          )
        else
          nil
        end
      end

      # @return [DBSubnetGroup, nil]
      def subnet_group
        if data.db_subnet_group.db_subnet_group_name
          DBSubnetGroup.new(
            name: data.db_subnet_group.db_subnet_group_name,
            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