You are viewing documentation for version 1 of the AWS SDK for Ruby. Version 2 documentation can be found here.

Class: AWS::RDS::Client

Inherits:

Core::QueryClient

• Object
• Core::Client
• Core::QueryClient
• AWS::RDS::Client

Defined in:

lib/aws/rds/client.rb

Overview

Client class for Amazon Relational Database Service (RDS).

Direct Known Subclasses

V20130515, V20130909, V20140901

Defined Under Namespace

Classes: V20130515, V20130909, V20140901

Constant Summary

API_VERSION =

'2014-09-01'

Instance Attribute Summary

Attributes inherited from Core::Client

#config

Instance Method Summary

• #add_source_identifier_to_subscription(options = {}) ⇒ Core::Response

  Calls the AddSourceIdentifierToSubscription API operation.

• #add_tags_to_resource(options = {}) ⇒ Core::Response

  Calls the AddTagsToResource API operation.

• #authorize_db_security_group_ingress(options = {}) ⇒ Core::Response

  Calls the AuthorizeDBSecurityGroupIngress API operation.

• #copy_db_parameter_group(options = {}) ⇒ Core::Response

  Calls the CopyDBParameterGroup API operation.

• #copy_db_snapshot(options = {}) ⇒ Core::Response

  Calls the CopyDBSnapshot API operation.

• #copy_option_group(options = {}) ⇒ Core::Response

  Calls the CopyOptionGroup API operation.

• #create_db_instance(options = {}) ⇒ Core::Response

  Calls the CreateDBInstance API operation.

• #create_db_instance_read_replica(options = {}) ⇒ Core::Response

  Calls the CreateDBInstanceReadReplica API operation.

• #create_db_parameter_group(options = {}) ⇒ Core::Response

  Calls the CreateDBParameterGroup API operation.

• #create_db_security_group(options = {}) ⇒ Core::Response

  Calls the CreateDBSecurityGroup API operation.

• #create_db_snapshot(options = {}) ⇒ Core::Response

  Calls the CreateDBSnapshot API operation.

• #create_db_subnet_group(options = {}) ⇒ Core::Response

  Calls the CreateDBSubnetGroup API operation.

• #create_event_subscription(options = {}) ⇒ Core::Response

  Calls the CreateEventSubscription API operation.

• #create_option_group(options = {}) ⇒ Core::Response

  Calls the CreateOptionGroup API operation.

• #delete_db_instance(options = {}) ⇒ Core::Response

  Calls the DeleteDBInstance API operation.

• #delete_db_parameter_group(options = {}) ⇒ Core::Response

  Calls the DeleteDBParameterGroup API operation.

• #delete_db_security_group(options = {}) ⇒ Core::Response

  Calls the DeleteDBSecurityGroup API operation.

• #delete_db_snapshot(options = {}) ⇒ Core::Response

  Calls the DeleteDBSnapshot API operation.

• #delete_db_subnet_group(options = {}) ⇒ Core::Response

  Calls the DeleteDBSubnetGroup API operation.

• #delete_event_subscription(options = {}) ⇒ Core::Response

  Calls the DeleteEventSubscription API operation.

• #delete_option_group(options = {}) ⇒ Core::Response

  Calls the DeleteOptionGroup API operation.

• #describe_db_engine_versions(options = {}) ⇒ Core::Response

  Calls the DescribeDBEngineVersions API operation.

• #describe_db_instances(options = {}) ⇒ Core::Response

  Calls the DescribeDBInstances API operation.

• #describe_db_log_files(options = {}) ⇒ Core::Response

  Calls the DescribeDBLogFiles API operation.

• #describe_db_parameter_groups(options = {}) ⇒ Core::Response

  Calls the DescribeDBParameterGroups API operation.

• #describe_db_parameters(options = {}) ⇒ Core::Response

  Calls the DescribeDBParameters API operation.

• #describe_db_security_groups(options = {}) ⇒ Core::Response

  Calls the DescribeDBSecurityGroups API operation.

• #describe_db_snapshots(options = {}) ⇒ Core::Response

  Calls the DescribeDBSnapshots API operation.

• #describe_db_subnet_groups(options = {}) ⇒ Core::Response

  Calls the DescribeDBSubnetGroups API operation.

• #describe_engine_default_parameters(options = {}) ⇒ Core::Response

  Calls the DescribeEngineDefaultParameters API operation.

• #describe_event_categories(options = {}) ⇒ Core::Response

  Calls the DescribeEventCategories API operation.

• #describe_event_subscriptions(options = {}) ⇒ Core::Response

  Calls the DescribeEventSubscriptions API operation.

• #describe_events(options = {}) ⇒ Core::Response

  Calls the DescribeEvents API operation.

• #describe_option_group_options(options = {}) ⇒ Core::Response

  Calls the DescribeOptionGroupOptions API operation.

• #describe_option_groups(options = {}) ⇒ Core::Response

  Calls the DescribeOptionGroups API operation.

• #describe_orderable_db_instance_options(options = {}) ⇒ Core::Response

  Calls the DescribeOrderableDBInstanceOptions API operation.

• #describe_reserved_db_instances(options = {}) ⇒ Core::Response

  Calls the DescribeReservedDBInstances API operation.

• #describe_reserved_db_instances_offerings(options = {}) ⇒ Core::Response

  Calls the DescribeReservedDBInstancesOfferings API operation.

• #download_db_log_file_portion(options = {}) ⇒ Core::Response

  Calls the DownloadDBLogFilePortion API operation.

• #list_tags_for_resource(options = {}) ⇒ Core::Response

  Calls the ListTagsForResource API operation.

• #modify_db_instance(options = {}) ⇒ Core::Response

  Calls the ModifyDBInstance API operation.

• #modify_db_parameter_group(options = {}) ⇒ Core::Response

  Calls the ModifyDBParameterGroup API operation.

• #modify_db_subnet_group(options = {}) ⇒ Core::Response

  Calls the ModifyDBSubnetGroup API operation.

• #modify_event_subscription(options = {}) ⇒ Core::Response

  Calls the ModifyEventSubscription API operation.

• #modify_option_group(options = {}) ⇒ Core::Response

  Calls the ModifyOptionGroup API operation.

• #promote_read_replica(options = {}) ⇒ Core::Response

  Calls the PromoteReadReplica API operation.

• #purchase_reserved_db_instances_offering(options = {}) ⇒ Core::Response

  Calls the PurchaseReservedDBInstancesOffering API operation.

• #reboot_db_instance(options = {}) ⇒ Core::Response

  Calls the RebootDBInstance API operation.

• #remove_source_identifier_from_subscription(options = {}) ⇒ Core::Response

  Calls the RemoveSourceIdentifierFromSubscription API operation.

• #remove_tags_from_resource(options = {}) ⇒ Core::Response

  Calls the RemoveTagsFromResource API operation.

• #reset_db_parameter_group(options = {}) ⇒ Core::Response

  Calls the ResetDBParameterGroup API operation.

• #restore_db_instance_from_db_snapshot(options = {}) ⇒ Core::Response

  Calls the RestoreDBInstanceFromDBSnapshot API operation.

• #restore_db_instance_to_point_in_time(options = {}) ⇒ Core::Response

  Calls the RestoreDBInstanceToPointInTime API operation.

• #revoke_db_security_group_ingress(options = {}) ⇒ Core::Response

  Calls the RevokeDBSecurityGroupIngress API operation.

Methods inherited from Core::Client

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

Constructor Details

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

Instance Method Details

#add_source_identifier_to_subscription(options = {}) ⇒ Core::Response

Calls the AddSourceIdentifierToSubscription API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :subscription_name - required - (String) The name of the RDS event notification subscription you want to add a source identifier to.
  • :source_identifier - required - (String) The identifier of the event source to be added. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens; it cannot end with a hyphen or contain two consecutive hyphens. Constraints: If the source type is a DB instance, then a DBInstanceIdentifier must be supplied. If the source type is a DB security group, a DBSecurityGroupName must be supplied. If the source type is a DB parameter group, a DBParameterGroupName must be supplied. If the source type is a DB Snapshot, a DBSnapshotIdentifier must be supplied.

Returns:

• (Core::Response) —

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

  • :customer_aws_id - (String)
  • :cust_subscription_id - (String)
  • :sns_topic_arn - (String)
  • :status - (String)
  • :subscription_creation_time - (String)
  • :source_type - (String)
  • :source_ids_list - (Array)
  • :event_categories_list - (Array)
  • :enabled - (Boolean)

#add_tags_to_resource(options = {}) ⇒ Core::Response

Calls the AddTagsToResource API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :resource_name - required - (String) The DB Instance the tags will be added to.
  • :tags - required - (Array<) The tags to be assigned to the DB Instance.
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response)

#authorize_db_security_group_ingress(options = {}) ⇒ Core::Response

Calls the AuthorizeDBSecurityGroupIngress API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_security_group_name - (String) The name of the DB Security Group to authorize.
  • :cidrip - (String) The IP range to authorize.
  • :ec2_security_group_name - (String) Name of the EC2 Security Group to authorize.
  • :ec2_security_group_id - (String) Id of the EC2 Security Group to authorize. For VPC DB Security Groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.
  • :ec2_security_group_owner_id - (String) AWS Account Number of the owner of the security group specified in the EC2SecurityGroupName parameter. The AWS Access Key ID is not an acceptable value.

Returns:

• (Core::Response) —

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

  • :owner_id - (String)
  • :db_security_group_name - (String)
  • :db_security_group_description - (String)
  • :vpc_id - (String)
  • :ec_2_security_groups - (Array)
    • :status - (String)
    • :ec2_security_group_name - (String)
    • :ec2_security_group_id - (String)
    • :ec2_security_group_owner_id - (String)
  • :ip_ranges - (Array)
    • :status - (String)
    • :cidrip - (String)

#copy_db_parameter_group(options = {}) ⇒ Core::Response

Calls the CopyDBParameterGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :source_db_parameter_group_identifier - required - (String) The identifier or ARN for the source DB Parameter Group. Constraints: Must specify a valid DB Parameter Group. If the source DB Parameter Group is in the same region as the copy, specify a valid DB Parameter Group identifier, or a valid ARN. If the source DB Parameter Group is in a different region than the copy, specify a valid DB parameter group ARN. Example: my-db-param-group Example: arn:aws:rds:us-west-2:123456789012:pg:special-parameters
  • :target_db_parameter_group_identifier - required - (String) The identifier for the copied DB Parameter Group. 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-db-parameter-group
  • :target_db_parameter_group_description - required - (String) The description for the copied DB Parameter Group.
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response) —

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

  • :db_parameter_group_name - (String)
  • :db_parameter_group_family - (String)
  • :description - (String)

#copy_db_snapshot(options = {}) ⇒ Core::Response

Calls the CopyDBSnapshot API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :source_db_snapshot_identifier - required - (String) The identifier for the source DB snapshot. Constraints: Must be the identifier for a valid automated snapshot in the "available" state. Example: rds:mydb-2012-01-15-00-01
  • :target_db_snapshot_identifier - required - (String) The identifier for the copied 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-db-snapshot
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response) —

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

  • :db_snapshot_identifier - (String)
  • :db_instance_identifier - (String)
  • :snapshot_create_time - (Time)
  • :engine - (String)
  • :allocated_storage - (Integer)
  • :status - (String)
  • :port - (Integer)
  • :availability_zone - (String)
  • :vpc_id - (String)
  • :instance_create_time - (Time)
  • :master_username - (String)
  • :engine_version - (String)
  • :license_model - (String)
  • :snapshot_type - (String)
  • :iops - (Integer)
  • :option_group_name - (String)
  • :percent_progress - (Integer)
  • :source_region - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#copy_option_group(options = {}) ⇒ Core::Response

Calls the CopyOptionGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :source_option_group_identifier - required - (String) The identifier or ARN for the source Option Group. Constraints: Must specify a valid Option Group. If the source Option Group is in the same region as the copy, specify a valid Option Group identifier, or a valid ARN. If the source Option Group is in a different region than the copy, specify a valid Option group ARN. Example: my-option-group Example: arn:aws:rds:us-west-2:123456789012:og:special-options
  • :target_option_group_identifier - required - (String) The identifier for the copied Option Group. 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-option-group
  • :target_option_group_description - required - (String) The description for the copied Option Group.
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response) —

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

  • :option_group_name - (String)
  • :option_group_description - (String)
  • :engine_name - (String)
  • :major_engine_version - (String)
  • :options - (Array)
    • :option_name - (String)
    • :option_description - (String)
    • :persistent - (Boolean)
    • :permanent - (Boolean)
    • :port - (Integer)
    • :option_settings - (Array)
      • :name - (String)
      • :value - (String)
      • :default_value - (String)
      • :description - (String)
      • :apply_type - (String)
      • :data_type - (String)
      • :allowed_values - (String)
      • :is_modifiable - (Boolean)
      • :is_collection - (Boolean)
    • :db_security_group_memberships - (Array)
      • :db_security_group_name - (String)
      • :status - (String)
    • :vpc_security_group_memberships - (Array)
      • :vpc_security_group_id - (String)
      • :status - (String)
  • :allows_vpc_and_non_vpc_instance_memberships - (Boolean)
  • :vpc_id - (String)

#create_db_instance(options = {}) ⇒ Core::Response

Calls the CreateDBInstance API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_name - (String) 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.
  • :db_instance_identifier - required - (String) The DB Instance identifier. This parameter is stored as a lowercase string.
  • :allocated_storage - required - (Integer) The amount of storage (in gigabytes) to be initially allocated for the database instance.
  • :db_instance_class - required - (String) The compute and memory capacity of the DB Instance.
  • :engine - required - (String) The name of the database engine to be used for this instance.
  • :master_username - required - (String) The name of master user for the client DB Instance.
  • :master_user_password - required - (String) The password for the master DB Instance user.
  • :db_security_groups - (Array<) A list of DB Security Groups to associate with this DB Instance.
  • :vpc_security_group_ids - (Array<) 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.
  • :availability_zone - (String) The EC2 Availability Zone that the database instance will be created in.
  • :db_subnet_group_name - (String) 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.
  • :preferred_maintenance_window - (String) The weekly time range (in UTC) during which system maintenance can occur.
  • :db_parameter_group_name - (String) The name of the database parameter group to associate with this DB instance. If this argument is omitted, the default DBParameterGroup for the specified engine will be used.
  • :backup_retention_period - (Integer) 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.
  • :preferred_backup_window - (String) The daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod.
  • :port - (Integer) The port number on which the database accepts connections.
  • :multi_az - (Boolean) Specifies if the DB Instance is a Multi-AZ deployment. You cannot set the AvailabilityZone parameter if the MultiAZ parameter is set to true .
  • :engine_version - (String) The version number of the database engine to use. Example: 5.1.42
  • :auto_minor_version_upgrade - (Boolean) Indicates that minor engine upgrades will be applied automatically to the DB Instance during the maintenance window. Default: true
  • :license_model - (String) License model information for this DB Instance. Valid values: license-included | bring-your-own-license | general-public-license
  • :iops - (Integer) 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.
  • :option_group_name - (String) Indicates that the DB Instance should be associated with the specified option group.
  • :character_set_name - (String) For supported engines, indicates that the DB Instance should be associated with the specified CharacterSet.
  • :publicly_accessible - (Boolean) 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.
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
  • :storage_type - (String) Specifies 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.
  • :tde_credential_arn - (String) The ARN from the Key Store with which to associate the instance for TDE encryption.
  • :tde_credential_password - (String) The password for the given ARN from the Key Store in order to access the device.

Returns:

• (Core::Response) —

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

  • :db_instance_identifier - (String)
  • :db_instance_class - (String)
  • :engine - (String)
  • :db_instance_status - (String)
  • :master_username - (String)
  • :db_name - (String)
  • :endpoint - (Hash)
    • :address - (String)
    • :port - (Integer)
  • :allocated_storage - (Integer)
  • :instance_create_time - (Time)
  • :preferred_backup_window - (String)
  • :backup_retention_period - (Integer)
  • :db_security_groups - (Array)
    • :db_security_group_name - (String)
    • :status - (String)
  • :vpc_security_groups - (Array)
    • :vpc_security_group_id - (String)
    • :status - (String)
  • :db_parameter_groups - (Array)
    • :db_parameter_group_name - (String)
    • :parameter_apply_status - (String)
  • :availability_zone - (String)
  • :db_subnet_group - (Hash)
    • :db_subnet_group_name - (String)
    • :db_subnet_group_description - (String)
    • :vpc_id - (String)
    • :subnet_group_status - (String)
    • :subnets - (Array)
      • :subnet_identifier - (String)
      • :subnet_availability_zone - (Hash)
        • :name - (String)
      • :subnet_status - (String)
  • :preferred_maintenance_window - (String)
  • :pending_modified_values - (Hash)
    • :db_instance_class - (String)
    • :allocated_storage - (Integer)
    • :master_user_password - (String)
    • :port - (Integer)
    • :backup_retention_period - (Integer)
    • :multi_az - (Boolean)
    • :engine_version - (String)
    • :iops - (Integer)
    • :db_instance_identifier - (String)
    • :storage_type - (String)
  • :latest_restorable_time - (Time)
  • :multi_az - (Boolean)
  • :engine_version - (String)
  • :auto_minor_version_upgrade - (Boolean)
  • :read_replica_source_db_instance_identifier - (String)
  • :read_replica_db_instance_identifiers - (Array)
  • :license_model - (String)
  • :iops - (Integer)
  • :option_group_memberships - (Array)
    • :option_group_name - (String)
    • :status - (String)
  • :character_set_name - (String)
  • :secondary_availability_zone - (String)
  • :publicly_accessible - (Boolean)
  • :status_infos - (Array)
    • :status_type - (String)
    • :normal - (Boolean)
    • :status - (String)
    • :message - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#create_db_instance_read_replica(options = {}) ⇒ Core::Response

Calls the CreateDBInstanceReadReplica API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_instance_identifier - required - (String) The DB Instance identifier of the Read Replica. This is the unique key that identifies a DB Instance. This parameter is stored as a lowercase string.
  • :source_db_instance_identifier - required - (String) The identifier of the DB Instance that will act as the source for the Read Replica. Each DB Instance can have up to five Read Replicas. Constraints: Must be the identifier of an existing DB Instance that is not already a Read Replica DB Instance.
  • :db_instance_class - (String) The compute and memory capacity of the Read Replica. Valid Values: db.m1.small | db.m1.large | db.m1.xlarge | db.m2.xlarge |db.m2.2xlarge | db.m2.4xlarge Default: Inherits from the source DB Instance.
  • :availability_zone - (String) 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
  • :port - (Integer) The port number that the DB Instance uses for connections. Default: Inherits from the source DB Instance Valid Values: 1150-65535
  • :auto_minor_version_upgrade - (Boolean) Indicates that minor engine upgrades will be applied automatically to the Read Replica during the maintenance window. Default: Inherits from the source DB Instance
  • :iops - (Integer) The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for the DB Instance.
  • :option_group_name - (String) The option group the DB instance will be associated with. If omitted, the default Option Group for the engine specified will be used.
  • :publicly_accessible - (Boolean) 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.
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
  • :db_subnet_group_name - (String) 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: 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.
  • :storage_type - (String) Specifies storage type to be associated with the DB Instance read replica. Valid values: standard | gp2 | io1 If you specify io1, you must also include a value for the Iops parameter.

Returns:

• (Core::Response) —

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

  • :db_instance_identifier - (String)
  • :db_instance_class - (String)
  • :engine - (String)
  • :db_instance_status - (String)
  • :master_username - (String)
  • :db_name - (String)
  • :endpoint - (Hash)
    • :address - (String)
    • :port - (Integer)
  • :allocated_storage - (Integer)
  • :instance_create_time - (Time)
  • :preferred_backup_window - (String)
  • :backup_retention_period - (Integer)
  • :db_security_groups - (Array)
    • :db_security_group_name - (String)
    • :status - (String)
  • :vpc_security_groups - (Array)
    • :vpc_security_group_id - (String)
    • :status - (String)
  • :db_parameter_groups - (Array)
    • :db_parameter_group_name - (String)
    • :parameter_apply_status - (String)
  • :availability_zone - (String)
  • :db_subnet_group - (Hash)
    • :db_subnet_group_name - (String)
    • :db_subnet_group_description - (String)
    • :vpc_id - (String)
    • :subnet_group_status - (String)
    • :subnets - (Array)
      • :subnet_identifier - (String)
      • :subnet_availability_zone - (Hash)
        • :name - (String)
      • :subnet_status - (String)
  • :preferred_maintenance_window - (String)
  • :pending_modified_values - (Hash)
    • :db_instance_class - (String)
    • :allocated_storage - (Integer)
    • :master_user_password - (String)
    • :port - (Integer)
    • :backup_retention_period - (Integer)
    • :multi_az - (Boolean)
    • :engine_version - (String)
    • :iops - (Integer)
    • :db_instance_identifier - (String)
    • :storage_type - (String)
  • :latest_restorable_time - (Time)
  • :multi_az - (Boolean)
  • :engine_version - (String)
  • :auto_minor_version_upgrade - (Boolean)
  • :read_replica_source_db_instance_identifier - (String)
  • :read_replica_db_instance_identifiers - (Array)
  • :license_model - (String)
  • :iops - (Integer)
  • :option_group_memberships - (Array)
    • :option_group_name - (String)
    • :status - (String)
  • :character_set_name - (String)
  • :secondary_availability_zone - (String)
  • :publicly_accessible - (Boolean)
  • :status_infos - (Array)
    • :status_type - (String)
    • :normal - (Boolean)
    • :status - (String)
    • :message - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#create_db_parameter_group(options = {}) ⇒ Core::Response

Calls the CreateDBParameterGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_parameter_group_name - required - (String) The name of the DB Parameter Group.
  • :db_parameter_group_family - required - (String) The name of the DB Parameter Group Family the DB Parameter Group can be used with.
  • :description - required - (String) The description for the DB Parameter Group.
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response) —

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

  • :db_parameter_group_name - (String)
  • :db_parameter_group_family - (String)
  • :description - (String)

#create_db_security_group(options = {}) ⇒ Core::Response

Calls the CreateDBSecurityGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_security_group_name - required - (String) The name for the DB Security Group. This value is stored as a lowercase string.
  • :db_security_group_description - required - (String) The description for the DB Security Group.
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response) —

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

  • :owner_id - (String)
  • :db_security_group_name - (String)
  • :db_security_group_description - (String)
  • :vpc_id - (String)
  • :ec_2_security_groups - (Array)
    • :status - (String)
    • :ec2_security_group_name - (String)
    • :ec2_security_group_id - (String)
    • :ec2_security_group_owner_id - (String)
  • :ip_ranges - (Array)
    • :status - (String)
    • :cidrip - (String)

#create_db_snapshot(options = {}) ⇒ Core::Response

Calls the CreateDBSnapshot API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_snapshot_identifier - required - (String) The identifier for the DB Snapshot.
  • :db_instance_identifier - required - (String) The DB Instance identifier. This is the unique key that identifies a DB Instance. This parameter isn't case sensitive.
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response) —

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

  • :db_snapshot_identifier - (String)
  • :db_instance_identifier - (String)
  • :snapshot_create_time - (Time)
  • :engine - (String)
  • :allocated_storage - (Integer)
  • :status - (String)
  • :port - (Integer)
  • :availability_zone - (String)
  • :vpc_id - (String)
  • :instance_create_time - (Time)
  • :master_username - (String)
  • :engine_version - (String)
  • :license_model - (String)
  • :snapshot_type - (String)
  • :iops - (Integer)
  • :option_group_name - (String)
  • :percent_progress - (Integer)
  • :source_region - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#create_db_subnet_group(options = {}) ⇒ Core::Response

Calls the CreateDBSubnetGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_subnet_group_name - required - (String) The name for the DB Subnet Group. This value is stored as a lowercase string. Constraints: Must contain no more than 255 alphanumeric characters or hyphens. Must not be "Default". Example: mySubnetgroup
  • :db_subnet_group_description - required - (String) The description for the DB Subnet Group.
  • :subnet_ids - required - (Array<) The EC2 Subnet IDs for the DB Subnet Group.
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response) —

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

  • :db_subnet_group_name - (String)
  • :db_subnet_group_description - (String)
  • :vpc_id - (String)
  • :subnet_group_status - (String)
  • :subnets - (Array)
    • :subnet_identifier - (String)
    • :subnet_availability_zone - (Hash)
      • :name - (String)
    • :subnet_status - (String)

#create_event_subscription(options = {}) ⇒ Core::Response

Calls the CreateEventSubscription API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :subscription_name - required - (String) The name of the subscription. Constraints: The name must be less than 255 characters.
  • :sns_topic_arn - required - (String) The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.
  • :source_type - (String) The type of source that will be generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. if this value is not specified, all events are returned. Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot
  • :event_categories - (Array<) A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType in the Events topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.
  • :source_ids - (Array<) The list of identifiers of the event sources for which events will be returned. If not specified, then all sources are included in the response. An identifier must begin with a letter and must contain only ASCII letters, digits, and hyphens; it cannot end with a hyphen or contain two consecutive hyphens. Constraints: If SourceIds are supplied, SourceType must also be provided. If the source type is a DB instance, then a DBInstanceIdentifier must be supplied. If the source type is a DB security group, a DBSecurityGroupName must be supplied. If the source type is a DB parameter group, a DBParameterGroupName must be supplied. If the source type is a DB Snapshot, a DBSnapshotIdentifier must be supplied.
  • :enabled - (Boolean) A Boolean value; set to true to activate the subscription, set to false to create the subscription but not active it.
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response) —

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

  • :customer_aws_id - (String)
  • :cust_subscription_id - (String)
  • :sns_topic_arn - (String)
  • :status - (String)
  • :subscription_creation_time - (String)
  • :source_type - (String)
  • :source_ids_list - (Array)
  • :event_categories_list - (Array)
  • :enabled - (Boolean)

#create_option_group(options = {}) ⇒ Core::Response

Calls the CreateOptionGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :option_group_name - required - (String) Specifies the name of the option group to be created. Constraints: Must be 1 to 255 alphanumeric characters or hyphens First character must be a letter Cannot end with a hyphen or contain two consecutive hyphens Example: myOptiongroup
  • :engine_name - required - (String) Specifies the name of the engine that this option group should be associated with.
  • :major_engine_version - required - (String) Specifies the major version of the engine that this option group should be associated with.
  • :option_group_description - required - (String) The description of the option group.
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response) —

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

  • :option_group_name - (String)
  • :option_group_description - (String)
  • :engine_name - (String)
  • :major_engine_version - (String)
  • :options - (Array)
    • :option_name - (String)
    • :option_description - (String)
    • :persistent - (Boolean)
    • :permanent - (Boolean)
    • :port - (Integer)
    • :option_settings - (Array)
      • :name - (String)
      • :value - (String)
      • :default_value - (String)
      • :description - (String)
      • :apply_type - (String)
      • :data_type - (String)
      • :allowed_values - (String)
      • :is_modifiable - (Boolean)
      • :is_collection - (Boolean)
    • :db_security_group_memberships - (Array)
      • :db_security_group_name - (String)
      • :status - (String)
    • :vpc_security_group_memberships - (Array)
      • :vpc_security_group_id - (String)
      • :status - (String)
  • :allows_vpc_and_non_vpc_instance_memberships - (Boolean)
  • :vpc_id - (String)

#delete_db_instance(options = {}) ⇒ Core::Response

Calls the DeleteDBInstance API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_instance_identifier - required - (String) The DB Instance identifier for the DB Instance to be deleted. This parameter isn't case sensitive.
  • :skip_final_snapshot - (Boolean)
  • :final_db_snapshot_identifier - (String) Determines whether a final DB Snapshot is created before the DB Instance is deleted. If true , no DBSnapshot is created. If false , a DB Snapshot is created before the DB Instance is deleted.

Returns:

• (Core::Response) —

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

  • :db_instance_identifier - (String)
  • :db_instance_class - (String)
  • :engine - (String)
  • :db_instance_status - (String)
  • :master_username - (String)
  • :db_name - (String)
  • :endpoint - (Hash)
    • :address - (String)
    • :port - (Integer)
  • :allocated_storage - (Integer)
  • :instance_create_time - (Time)
  • :preferred_backup_window - (String)
  • :backup_retention_period - (Integer)
  • :db_security_groups - (Array)
    • :db_security_group_name - (String)
    • :status - (String)
  • :vpc_security_groups - (Array)
    • :vpc_security_group_id - (String)
    • :status - (String)
  • :db_parameter_groups - (Array)
    • :db_parameter_group_name - (String)
    • :parameter_apply_status - (String)
  • :availability_zone - (String)
  • :db_subnet_group - (Hash)
    • :db_subnet_group_name - (String)
    • :db_subnet_group_description - (String)
    • :vpc_id - (String)
    • :subnet_group_status - (String)
    • :subnets - (Array)
      • :subnet_identifier - (String)
      • :subnet_availability_zone - (Hash)
        • :name - (String)
      • :subnet_status - (String)
  • :preferred_maintenance_window - (String)
  • :pending_modified_values - (Hash)
    • :db_instance_class - (String)
    • :allocated_storage - (Integer)
    • :master_user_password - (String)
    • :port - (Integer)
    • :backup_retention_period - (Integer)
    • :multi_az - (Boolean)
    • :engine_version - (String)
    • :iops - (Integer)
    • :db_instance_identifier - (String)
    • :storage_type - (String)
  • :latest_restorable_time - (Time)
  • :multi_az - (Boolean)
  • :engine_version - (String)
  • :auto_minor_version_upgrade - (Boolean)
  • :read_replica_source_db_instance_identifier - (String)
  • :read_replica_db_instance_identifiers - (Array)
  • :license_model - (String)
  • :iops - (Integer)
  • :option_group_memberships - (Array)
    • :option_group_name - (String)
    • :status - (String)
  • :character_set_name - (String)
  • :secondary_availability_zone - (String)
  • :publicly_accessible - (Boolean)
  • :status_infos - (Array)
    • :status_type - (String)
    • :normal - (Boolean)
    • :status - (String)
    • :message - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#delete_db_parameter_group(options = {}) ⇒ Core::Response

Calls the DeleteDBParameterGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_parameter_group_name - required - (String) The name of the DB Parameter Group. The specified database security group must not be associated with any DB instances.

Returns:

• (Core::Response)

#delete_db_security_group(options = {}) ⇒ Core::Response

Calls the DeleteDBSecurityGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_security_group_name - required - (String) The name of the database security group to delete.

Returns:

• (Core::Response)

#delete_db_snapshot(options = {}) ⇒ Core::Response

Calls the DeleteDBSnapshot API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_snapshot_identifier - required - (String) The DBSnapshot identifier.

Returns:

• (Core::Response) —

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

  • :db_snapshot_identifier - (String)
  • :db_instance_identifier - (String)
  • :snapshot_create_time - (Time)
  • :engine - (String)
  • :allocated_storage - (Integer)
  • :status - (String)
  • :port - (Integer)
  • :availability_zone - (String)
  • :vpc_id - (String)
  • :instance_create_time - (Time)
  • :master_username - (String)
  • :engine_version - (String)
  • :license_model - (String)
  • :snapshot_type - (String)
  • :iops - (Integer)
  • :option_group_name - (String)
  • :percent_progress - (Integer)
  • :source_region - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#delete_db_subnet_group(options = {}) ⇒ Core::Response

Calls the DeleteDBSubnetGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_subnet_group_name - required - (String) The name of the database subnet group to delete. You cannot delete the default subnet group. Constraints: Must be 1 to 255 alphanumeric characters First character must be a letter Cannot end with a hyphen or contain two consecutive hyphens

Returns:

• (Core::Response)

#delete_event_subscription(options = {}) ⇒ Core::Response

Calls the DeleteEventSubscription API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :subscription_name - required - (String) The name of the RDS event notification subscription you want to delete.

Returns:

• (Core::Response) —

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

  • :customer_aws_id - (String)
  • :cust_subscription_id - (String)
  • :sns_topic_arn - (String)
  • :status - (String)
  • :subscription_creation_time - (String)
  • :source_type - (String)
  • :source_ids_list - (Array)
  • :event_categories_list - (Array)
  • :enabled - (Boolean)

#delete_option_group(options = {}) ⇒ Core::Response

Calls the DeleteOptionGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :option_group_name - required - (String) The name of the option group to be deleted. You cannot delete default Option Groups.

Returns:

• (Core::Response)

#describe_db_engine_versions(options = {}) ⇒ Core::Response

Calls the DescribeDBEngineVersions API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :engine - (String) The database engine to return.
  • :engine_version - (String) The database engine version to return.
  • :db_parameter_group_family - (String) The name of a specific database parameter group family to return details for. Constraints: Must be 1 to 255 alphanumeric characters First character must be a letter Cannot end with a hyphen or contain two consecutive hyphens
  • :filters - (Array<) Not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more than the MaxRecords value is available, a marker is included in the response so that the following results can be retrieved. Default: 100 Constraints: minimum 20, maximum 100
  • :marker - (String) The marker provided in the previous request. If this parameter is specified, the response includes records beyond the marker only, up to MaxRecords.
  • :default_only - (Boolean) Indicates that only the default version of the specified engine or engine and major version combination is returned.
  • :list_supported_character_sets - (Boolean) If this parameter is specified, and if the requested engine supports the CharacterSetName parameter for CreateDBInstance, the response includes a list of supported character sets for each engine version.

Returns:

• (Core::Response) —

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

  • :marker - (String)
  • :db_engine_versions - (Array)
    • :engine - (String)
    • :engine_version - (String)
    • :db_parameter_group_family - (String)
    • :db_engine_description - (String)
    • :db_engine_version_description - (String)
    • :default_character_set - (Hash)
      • :character_set_name - (String)
      • :character_set_description - (String)
    • :supported_character_sets - (Array)
      • :character_set_name - (String)
      • :character_set_description - (String)

#describe_db_instances(options = {}) ⇒ Core::Response

Calls the DescribeDBInstances API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_instance_identifier - (String) The user-supplied instance identifier. If this parameter is specified, information from only the specific DB Instance is returned. This parameter isn't case sensitive.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results may be retrieved.
  • :marker - (String) An optional marker provided in the previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Returns:

• (Core::Response) —

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

  • :marker - (String)
  • :db_instances - (Array)
    • :db_instance_identifier - (String)
    • :db_instance_class - (String)
    • :engine - (String)
    • :db_instance_status - (String)
    • :master_username - (String)
    • :db_name - (String)
    • :endpoint - (Hash)
      • :address - (String)
      • :port - (Integer)
    • :allocated_storage - (Integer)
    • :instance_create_time - (Time)
    • :preferred_backup_window - (String)
    • :backup_retention_period - (Integer)
    • :db_security_groups - (Array)
      • :db_security_group_name - (String)
      • :status - (String)
    • :vpc_security_groups - (Array)
      • :vpc_security_group_id - (String)
      • :status - (String)
    • :db_parameter_groups - (Array)
      • :db_parameter_group_name - (String)
      • :parameter_apply_status - (String)
    • :availability_zone - (String)
    • :db_subnet_group - (Hash)
      • :db_subnet_group_name - (String)
      • :db_subnet_group_description - (String)
      • :vpc_id - (String)
      • :subnet_group_status - (String)
      • :subnets - (Array)
        • :subnet_identifier - (String)
        • :subnet_availability_zone - (Hash)
          • :name - (String)
        • :subnet_status - (String)
    • :preferred_maintenance_window - (String)
    • :pending_modified_values - (Hash)
      • :db_instance_class - (String)
      • :allocated_storage - (Integer)
      • :master_user_password - (String)
      • :port - (Integer)
      • :backup_retention_period - (Integer)
      • :multi_az - (Boolean)
      • :engine_version - (String)
      • :iops - (Integer)
      • :db_instance_identifier - (String)
      • :storage_type - (String)
    • :latest_restorable_time - (Time)
    • :multi_az - (Boolean)
    • :engine_version - (String)
    • :auto_minor_version_upgrade - (Boolean)
    • :read_replica_source_db_instance_identifier - (String)
    • :read_replica_db_instance_identifiers - (Array)
    • :license_model - (String)
    • :iops - (Integer)
    • :option_group_memberships - (Array)
      • :option_group_name - (String)
      • :status - (String)
    • :character_set_name - (String)
    • :secondary_availability_zone - (String)
    • :publicly_accessible - (Boolean)
    • :status_infos - (Array)
      • :status_type - (String)
      • :normal - (Boolean)
      • :status - (String)
      • :message - (String)
    • :storage_type - (String)
    • :tde_credential_arn - (String)

#describe_db_log_files(options = {}) ⇒ Core::Response

Calls the DescribeDBLogFiles API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_instance_identifier - required - (String) The customer-assigned name of the DB Instance that contains the log files you want to list. 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
  • :filename_contains - (String) Filters the available log files for log file names that contain the specified string.
  • :file_last_written - (Integer) Filters the available log files for files written since the specified date.
  • :file_size - (Integer) Filters the available log files for files larger than the specified size.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) 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.
  • :marker - (String) The pagination token provided in the previous request. If this parameter is specified the response includes only records beyond the marker, up to MaxRecords.

Returns:

• (Core::Response) —

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

  • :describe_db_log_files - (Array)
    • :log_file_name - (String)
    • :last_written - (Integer)
    • :size - (Integer)
  • :marker - (String)

#describe_db_parameter_groups(options = {}) ⇒ Core::Response

Calls the DescribeDBParameterGroups API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_parameter_group_name - (String) The name of a specific database parameter group to return details for.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results may be retrieved.
  • :marker - (String) An optional marker provided in the previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Returns:

• (Core::Response) —

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

  • :marker - (String)
  • :db_parameter_groups - (Array)
    • :db_parameter_group_name - (String)
    • :db_parameter_group_family - (String)
    • :description - (String)

#describe_db_parameters(options = {}) ⇒ Core::Response

Calls the DescribeDBParameters API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_parameter_group_name - required - (String) The name of a specific database parameter group to return details for.
  • :source - (String) The parameter types to return.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results may be retrieved.
  • :marker - (String) An optional marker provided in the previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Returns:

• (Core::Response) —

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

  • :parameters - (Array)
    • :parameter_name - (String)
    • :parameter_value - (String)
    • :description - (String)
    • :source - (String)
    • :apply_type - (String)
    • :data_type - (String)
    • :allowed_values - (String)
    • :is_modifiable - (Boolean)
    • :minimum_engine_version - (String)
    • :apply_method - (String)
  • :marker - (String)

#describe_db_security_groups(options = {}) ⇒ Core::Response

Calls the DescribeDBSecurityGroups API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_security_group_name - (String) The name of the DB Security Group to return details for.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results may be retrieved.
  • :marker - (String) An optional marker provided in the previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Returns:

• (Core::Response) —

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

  • :marker - (String)
  • :db_security_groups - (Array)
    • :owner_id - (String)
    • :db_security_group_name - (String)
    • :db_security_group_description - (String)
    • :vpc_id - (String)
    • :ec_2_security_groups - (Array)
      • :status - (String)
      • :ec2_security_group_name - (String)
      • :ec2_security_group_id - (String)
      • :ec2_security_group_owner_id - (String)
    • :ip_ranges - (Array)
      • :status - (String)
      • :cidrip - (String)

#describe_db_snapshots(options = {}) ⇒ Core::Response

Calls the DescribeDBSnapshots API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_instance_identifier - (String) The unique identifier for the Amazon RDS DB snapshot. This value is stored as a lowercase string.
  • :db_snapshot_identifier - (String) The DB Instance identifier. This parameter isn't case sensitive.
  • :snapshot_type - (String) An optional snapshot type for which snapshots will be returned. If not specified, the returned results will include snapshots of all types.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results may be retrieved.
  • :marker - (String) An optional marker provided in the previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Returns:

• (Core::Response) —

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

  • :marker - (String)
  • :db_snapshots - (Array)
    • :db_snapshot_identifier - (String)
    • :db_instance_identifier - (String)
    • :snapshot_create_time - (Time)
    • :engine - (String)
    • :allocated_storage - (Integer)
    • :status - (String)
    • :port - (Integer)
    • :availability_zone - (String)
    • :vpc_id - (String)
    • :instance_create_time - (Time)
    • :master_username - (String)
    • :engine_version - (String)
    • :license_model - (String)
    • :snapshot_type - (String)
    • :iops - (Integer)
    • :option_group_name - (String)
    • :percent_progress - (Integer)
    • :source_region - (String)
    • :storage_type - (String)
    • :tde_credential_arn - (String)

#describe_db_subnet_groups(options = {}) ⇒ Core::Response

Calls the DescribeDBSubnetGroups API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_subnet_group_name - (String) The name of the DB Subnet Group to return details for.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results may be retrieved. Default: 100 Constraints: minimum 20, maximum 100
  • :marker - (String) An optional marker provided in the previous DescribeDBSubnetGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Returns:

• (Core::Response) —

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

  • :marker - (String)
  • :db_subnet_groups - (Array)
    • :db_subnet_group_name - (String)
    • :db_subnet_group_description - (String)
    • :vpc_id - (String)
    • :subnet_group_status - (String)
    • :subnets - (Array)
      • :subnet_identifier - (String)
      • :subnet_availability_zone - (Hash)
        • :name - (String)
      • :subnet_status - (String)

#describe_engine_default_parameters(options = {}) ⇒ Core::Response

Calls the DescribeEngineDefaultParameters API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_parameter_group_family - required - (String) The name of the DB Parameter Group Family.
  • :filters - (Array<) Not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results may be retrieved.
  • :marker - (String) An optional marker provided in the previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Returns:

• (Core::Response) —

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

  • :db_parameter_group_family - (String)
  • :marker - (String)
  • :parameters - (Array)
    • :parameter_name - (String)
    • :parameter_value - (String)
    • :description - (String)
    • :source - (String)
    • :apply_type - (String)
    • :data_type - (String)
    • :allowed_values - (String)
    • :is_modifiable - (Boolean)
    • :minimum_engine_version - (String)
    • :apply_method - (String)

#describe_event_categories(options = {}) ⇒ Core::Response

Calls the DescribeEventCategories API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :source_type - (String) The type of source that will be generating the events. Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.

Returns:

• (Core::Response) —

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

  • :event_categories_map_list - (Array)
    • :source_type - (String)
    • :event_categories - (Array)

#describe_event_subscriptions(options = {}) ⇒ Core::Response

Calls the DescribeEventSubscriptions API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :subscription_name - (String) The name of the RDS event notification subscription you want to describe.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) 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
  • :marker - (String) An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

Returns:

• (Core::Response) —

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

  • :marker - (String)
  • :event_subscriptions_list - (Array)
    • :customer_aws_id - (String)
    • :cust_subscription_id - (String)
    • :sns_topic_arn - (String)
    • :status - (String)
    • :subscription_creation_time - (String)
    • :source_type - (String)
    • :source_ids_list - (Array)
    • :event_categories_list - (Array)
    • :enabled - (Boolean)

#describe_events(options = {}) ⇒ Core::Response

Calls the DescribeEvents API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :source_identifier - (String) The identifier of the event source for which events will be returned. If not specified, then all sources are included in the response.
  • :source_type - (String) The event source to retrieve events for. If no value is specified, all events are returned. Valid values include:
    • db-instance
    • db-parameter-group
    • db-security-group
    • db-snapshot
  • :start_time - (String<) The beginning of the time interval to retrieve events for, specified in ISO 8601 format.
  • :end_time - (String<) The end of the time interval for which to retrieve events, specified in ISO 8601 format.
  • :duration - (Integer) The number of minutes to retrieve events for.
  • :event_categories - (Array<) A list of event categories that trigger notifications for a event notification subscription.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results may be retrieved.
  • :marker - (String) An optional marker provided in the previous DescribeDBInstances request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Returns:

• (Core::Response) —

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

  • :marker - (String)
  • :events - (Array)
    • :source_identifier - (String)
    • :source_type - (String)
    • :message - (String)
    • :event_categories - (Array)
    • :date - (Time)

#describe_option_group_options(options = {}) ⇒ Core::Response

Calls the DescribeOptionGroupOptions API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :engine_name - required - (String) A required parameter. Options available for the given Engine name will be described.
  • :major_engine_version - (String) If specified, filters the results to include only options for the specified major engine version.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) 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
  • :marker - (String) An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Returns:

• (Core::Response) —

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

  • :option_group_options - (Array)
    • :name - (String)
    • :description - (String)
    • :engine_name - (String)
    • :major_engine_version - (String)
    • :minimum_required_minor_engine_version - (String)
    • :port_required - (Boolean)
    • :default_port - (Integer)
    • :options_depended_on - (Array)
    • :persistent - (Boolean)
    • :permanent - (Boolean)
    • :option_group_option_settings - (Array)
      • :setting_name - (String)
      • :setting_description - (String)
      • :default_value - (String)
      • :apply_type - (String)
      • :allowed_values - (String)
      • :is_modifiable - (Boolean)
  • :marker - (String)

#describe_option_groups(options = {}) ⇒ Core::Response

Calls the DescribeOptionGroups API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :option_group_name - (String) The name of the option group to describe. Cannot be supplied together with EngineName or MajorEngineVersion.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :marker - (String) An optional pagination token provided by a previous DescribeOptionGroups request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
  • :max_records - (Integer) 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
  • :engine_name - (String) Filters the list of option groups to only include groups associated with a specific database engine.
  • :major_engine_version - (String) Filters the list of option groups to only include groups associated with a specific database engine version. If specified, then EngineName must also be specified.

Returns:

• (Core::Response) —

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

  • :option_groups_list - (Array)
    • :option_group_name - (String)
    • :option_group_description - (String)
    • :engine_name - (String)
    • :major_engine_version - (String)
    • :options - (Array)
      • :option_name - (String)
      • :option_description - (String)
      • :persistent - (Boolean)
      • :permanent - (Boolean)
      • :port - (Integer)
      • :option_settings - (Array)
        • :name - (String)
        • :value - (String)
        • :default_value - (String)
        • :description - (String)
        • :apply_type - (String)
        • :data_type - (String)
        • :allowed_values - (String)
        • :is_modifiable - (Boolean)
        • :is_collection - (Boolean)
      • :db_security_group_memberships - (Array)
        • :db_security_group_name - (String)
        • :status - (String)
      • :vpc_security_group_memberships - (Array)
        • :vpc_security_group_id - (String)
        • :status - (String)
    • :allows_vpc_and_non_vpc_instance_memberships - (Boolean)
    • :vpc_id - (String)
  • :marker - (String)

#describe_orderable_db_instance_options(options = {}) ⇒ Core::Response

Calls the DescribeOrderableDBInstanceOptions API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :engine - required - (String) The name of the engine to retrieve DB Instance options for.
  • :engine_version - (String) The engine version filter value. Specify this parameter to show only the available offerings matching the specified engine version.
  • :db_instance_class - (String) The DB Instance class filter value. Specify this parameter to show only the available offerings matching the specified DB Instance class.
  • :license_model - (String) The license model filter value. Specify this parameter to show only the available offerings matching the specified license model.
  • :vpc - (Boolean) The VPC filter value. Specify this parameter to show only the available VPC or non-VPC offerings.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results may be retrieved. Default: 100 Constraints: minimum 20, maximum 100
  • :marker - (String) An optional marker provided in the previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

Returns:

• (Core::Response) —

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

  • :orderable_db_instance_options - (Array)
    • :engine - (String)
    • :engine_version - (String)
    • :db_instance_class - (String)
    • :license_model - (String)
    • :availability_zones - (Array)
      • :name - (String)
    • :multi_az_capable - (Boolean)
    • :read_replica_capable - (Boolean)
    • :vpc - (Boolean)
    • :storage_type - (String)
    • :supports_iops - (Boolean)
  • :marker - (String)

#describe_reserved_db_instances(options = {}) ⇒ Core::Response

Calls the DescribeReservedDBInstances API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :reserved_db_instance_id - (String) The reserved DB Instance identifier filter value. Specify this parameter to show only the reservation that matches the specified reservation ID.
  • :reserved_db_instances_offering_id - (String) The offering identifier filter value. Specify this parameter to show only purchased reservations matching the specified offering identifier.
  • :db_instance_class - (String) The DB Instance class filter value. Specify this parameter to show only those reservations matching the specified DB Instances class.
  • :duration - (String) The duration filter value, specified in years or seconds. Specify this parameter to show only reservations for this duration. Valid Values: 1 | 3 | 31536000 | 94608000
  • :product_description - (String) The product description filter value. Specify this parameter to show only those reservations matching the specified product description.
  • :offering_type - (String) The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type. Valid Values: "Light Utilization" | "Medium Utilization" | "Heavy Utilization"
  • :multi_az - (Boolean) The Multi-AZ filter value. Specify this parameter to show only those reservations matching the specified Multi-AZ parameter.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more than the MaxRecords value is available, a marker is included in the response so that the following results can be retrieved. Default: 100 Constraints: minimum 20, maximum 100
  • :marker - (String) The marker provided in the previous request. If this parameter is specified, the response includes records beyond the marker only, up to MaxRecords.

Returns:

• (Core::Response) —

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

  • :marker - (String)
  • :reserved_db_instances - (Array)
    • :reserved_db_instance_id - (String)
    • :reserved_db_instances_offering_id - (String)
    • :db_instance_class - (String)
    • :start_time - (Time)
    • :duration - (Integer)
    • :fixed_price - (Numeric)
    • :usage_price - (Numeric)
    • :currency_code - (String)
    • :db_instance_count - (Integer)
    • :product_description - (String)
    • :offering_type - (String)
    • :multi_az - (Boolean)
    • :state - (String)
    • :recurring_charges - (Array)
      • :recurring_charge_amount - (Numeric)
      • :recurring_charge_frequency - (String)

#describe_reserved_db_instances_offerings(options = {}) ⇒ Core::Response

Calls the DescribeReservedDBInstancesOfferings API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :reserved_db_instances_offering_id - (String) The offering identifier filter value. Specify this parameter to show only the available offering that matches the specified reservation identifier. Example: 438012d3-4052-4cc7-b2e3-8d3372e0e706
  • :db_instance_class - (String) The DB Instance class filter value. Specify this parameter to show only the available offerings matching the specified DB Instance class.
  • :duration - (String) Duration filter value, specified in years or seconds. Specify this parameter to show only reservations for this duration. Valid Values: 1 | 3 | 31536000 | 94608000
  • :product_description - (String) Product description filter value. Specify this parameter to show only the available offerings matching the specified product description.
  • :offering_type - (String) The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type. Valid Values: "Light Utilization" | "Medium Utilization" | "Heavy Utilization"
  • :multi_az - (Boolean) The Multi-AZ filter value. Specify this parameter to show only the available offerings matching the specified Multi-AZ parameter.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.
  • :max_records - (Integer) The maximum number of records to include in the response. If more than the MaxRecords value is available, a marker is included in the response so that the following results can be retrieved. Default: 100 Constraints: minimum 20, maximum 100
  • :marker - (String) The marker provided in the previous request. If this parameter is specified, the response includes records beyond the marker only, up to MaxRecords.

Returns:

• (Core::Response) —

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

  • :marker - (String)
  • :reserved_db_instances_offerings - (Array)
    • :reserved_db_instances_offering_id - (String)
    • :db_instance_class - (String)
    • :duration - (Integer)
    • :fixed_price - (Numeric)
    • :usage_price - (Numeric)
    • :currency_code - (String)
    • :product_description - (String)
    • :offering_type - (String)
    • :multi_az - (Boolean)
    • :recurring_charges - (Array)
      • :recurring_charge_amount - (Numeric)
      • :recurring_charge_frequency - (String)

#download_db_log_file_portion(options = {}) ⇒ Core::Response

Calls the DownloadDBLogFilePortion API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_instance_identifier - required - (String)
  • :log_file_name - required - (String)
  • :marker - (String) The pagination token provided in the previous request. If this parameter is specified the response includes only records beyond the marker, up to MaxRecords.
  • :number_of_lines - (Integer) The number of lines remaining to be downloaded.

Returns:

• (Core::Response) —

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

  • :log_file_data - (String)
  • :marker - (String)
  • :additional_data_pending - (Boolean)

#list_tags_for_resource(options = {}) ⇒ Core::Response

Calls the ListTagsForResource API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :resource_name - required - (String) The DB Instance with tags to be listed.
  • :filters - (Array<) This parameter is not currently supported.
    • :name - required - (String) This parameter is not currently supported.
    • :values - required - (Array<) This parameter is not currently supported.

Returns:

• (Core::Response) —

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

  • :tag_list - (Array)
    • :key - (String)
    • :value - (String)

#modify_db_instance(options = {}) ⇒ Core::Response

Calls the ModifyDBInstance API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_instance_identifier - required - (String) The DB Instance identifier. This value is stored as a lowercase string.
  • :allocated_storage - (Integer) The new storage capacity of the RDS instance. This change does not result in an outage and is applied during the next maintenance window unless the ApplyImmediately parameter is specified as true for this request.
  • :db_instance_class - (String) The new compute and memory capacity of the DB Instance. Passing a value for this parameter causes an outage during the change and is applied during the next maintenance window, unless the ApplyImmediately parameter is specified as true for this request.
  • :db_security_groups - (Array<) A list of DB Security Groups to authorize on this DB Instance. This change is asynchronously applied as soon as possible.
  • :vpc_security_group_ids - (Array<) 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
  • :apply_immediately - (Boolean) Specifies whether or not 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 passed as false , changes to the DB Instance are applied on the next call to RebootDBInstance, the next maintenance reboot, or the next failure reboot, whichever occurs first.
  • :master_user_password - (String) The new password for the DB Instance master user. This 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.
  • :db_parameter_group_name - (String) The name of the DB Parameter Group to apply to this DB Instance. This change is asynchronously applied as soon as possible for parameters when the ApplyImmediately parameter is specified as true for this request.
  • :backup_retention_period - (Integer) 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.
  • :preferred_backup_window - (String) The daily time range during which automated backups are created if automated backups are enabled, as determined by the BackupRetentionPeriod.
  • :preferred_maintenance_window - (String) The weekly time range (in UTC) during which system maintenance can occur, which may result in an outage. This change is made immediately. If moving this window to the current time, there must be at least 120 minutes between the current time and end of the window to ensure pending changes are applied.
  • :multi_az - (Boolean) Specifies if the DB Instance is a Multi-AZ deployment. Constraints: Cannot be specified if the DB Instance is a read replica.
  • :engine_version - (String) The version number of the database engine to upgrade to. For major version upgrades, if a nondefault 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. Example: 5.1.42
  • :allow_major_version_upgrade - (Boolean) Indicates that major version upgrades are allowed. 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.
  • :auto_minor_version_upgrade - (Boolean) Indicates that minor version upgrades will be applied automatically to the DB Instance during the maintenance window.
  • :iops - (Integer) The new Provisioned IOPS (I/O operations per second) value for the RDS instance. 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. 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.
  • :option_group_name - (String) Indicates that the DB Instance should be associated with the specified option group.
  • :new_db_instance_identifier - (String) The new DB Instance identifier for the DB Instance when renaming a DB Instance. 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
  • :storage_type - (String) Specifies 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.
  • :tde_credential_arn - (String) The ARN from the Key Store with which to associate the instance for TDE encryption.
  • :tde_credential_password - (String) The password for the given ARN from the Key Store in order to access the device.

Returns:

• (Core::Response) —

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

  • :db_instance_identifier - (String)
  • :db_instance_class - (String)
  • :engine - (String)
  • :db_instance_status - (String)
  • :master_username - (String)
  • :db_name - (String)
  • :endpoint - (Hash)
    • :address - (String)
    • :port - (Integer)
  • :allocated_storage - (Integer)
  • :instance_create_time - (Time)
  • :preferred_backup_window - (String)
  • :backup_retention_period - (Integer)
  • :db_security_groups - (Array)
    • :db_security_group_name - (String)
    • :status - (String)
  • :vpc_security_groups - (Array)
    • :vpc_security_group_id - (String)
    • :status - (String)
  • :db_parameter_groups - (Array)
    • :db_parameter_group_name - (String)
    • :parameter_apply_status - (String)
  • :availability_zone - (String)
  • :db_subnet_group - (Hash)
    • :db_subnet_group_name - (String)
    • :db_subnet_group_description - (String)
    • :vpc_id - (String)
    • :subnet_group_status - (String)
    • :subnets - (Array)
      • :subnet_identifier - (String)
      • :subnet_availability_zone - (Hash)
        • :name - (String)
      • :subnet_status - (String)
  • :preferred_maintenance_window - (String)
  • :pending_modified_values - (Hash)
    • :db_instance_class - (String)
    • :allocated_storage - (Integer)
    • :master_user_password - (String)
    • :port - (Integer)
    • :backup_retention_period - (Integer)
    • :multi_az - (Boolean)
    • :engine_version - (String)
    • :iops - (Integer)
    • :db_instance_identifier - (String)
    • :storage_type - (String)
  • :latest_restorable_time - (Time)
  • :multi_az - (Boolean)
  • :engine_version - (String)
  • :auto_minor_version_upgrade - (Boolean)
  • :read_replica_source_db_instance_identifier - (String)
  • :read_replica_db_instance_identifiers - (Array)
  • :license_model - (String)
  • :iops - (Integer)
  • :option_group_memberships - (Array)
    • :option_group_name - (String)
    • :status - (String)
  • :character_set_name - (String)
  • :secondary_availability_zone - (String)
  • :publicly_accessible - (Boolean)
  • :status_infos - (Array)
    • :status_type - (String)
    • :normal - (Boolean)
    • :status - (String)
    • :message - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#modify_db_parameter_group(options = {}) ⇒ Core::Response

Calls the ModifyDBParameterGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_parameter_group_name - required - (String) The name of the database parameter group.
  • :parameters - required - (Array<) An array of parameter names, values, and the apply method for the parameter update. At least one parameter name, value, and apply method must be supplied; subsequent arguments are optional. A maximum of 20 parameters may be modified in a single request.
    • :parameter_name - (String) Specifies the name of the parameter.
    • :parameter_value - (String) Specifies the value of the parameter.
    • :description - (String) Provides a description of the parameter.
    • :source - (String) Indicates the source of the parameter value.
    • :apply_type - (String) Specifies the engine specific parameters type.
    • :data_type - (String) Specifies the valid data type for the parameter.
    • :allowed_values - (String) Specifies the valid range of values for the parameter.
    • :is_modifiable - (Boolean) Indicates whether ( true ) or not ( false ) the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.
    • :minimum_engine_version - (String) The earliest engine version to which the parameter can apply.
    • :apply_method - (String) Indicates when to apply parameter updates. Valid values include:
      • immediate
      • pending-reboot

Returns:

• (Core::Response) —

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

  • :db_parameter_group_name - (String)

#modify_db_subnet_group(options = {}) ⇒ Core::Response

Calls the ModifyDBSubnetGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_subnet_group_name - required - (String) The name for the DB Subnet Group. This value is stored as a lowercase string. Constraints: Must contain no more than 255 alphanumeric characters or hyphens. Must not be "Default". Example: mySubnetgroup
  • :db_subnet_group_description - (String) The description for the DB Subnet Group.
  • :subnet_ids - required - (Array<) The EC2 Subnet IDs for the DB Subnet Group.

Returns:

• (Core::Response) —

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

  • :db_subnet_group_name - (String)
  • :db_subnet_group_description - (String)
  • :vpc_id - (String)
  • :subnet_group_status - (String)
  • :subnets - (Array)
    • :subnet_identifier - (String)
    • :subnet_availability_zone - (Hash)
      • :name - (String)
    • :subnet_status - (String)

#modify_event_subscription(options = {}) ⇒ Core::Response

Calls the ModifyEventSubscription API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :subscription_name - required - (String) The name of the RDS event notification subscription.
  • :sns_topic_arn - (String) The Amazon Resource Name (ARN) of the SNS topic created for event notification. The ARN is created by Amazon SNS when you create a topic and subscribe to it.
  • :source_type - (String) The type of source that will be generating the events. For example, if you want to be notified of events generated by a DB instance, you would set this parameter to db-instance. if this value is not specified, all events are returned. Valid values: db-instance | db-parameter-group | db-security-group | db-snapshot
  • :event_categories - (Array<) A list of event categories for a SourceType that you want to subscribe to. You can see a list of the categories for a given SourceType in the Events topic in the Amazon RDS User Guide or by using the DescribeEventCategories action.
  • :enabled - (Boolean) A Boolean value; set to true to activate the subscription.

Returns:

• (Core::Response) —

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

  • :customer_aws_id - (String)
  • :cust_subscription_id - (String)
  • :sns_topic_arn - (String)
  • :status - (String)
  • :subscription_creation_time - (String)
  • :source_type - (String)
  • :source_ids_list - (Array)
  • :event_categories_list - (Array)
  • :enabled - (Boolean)

#modify_option_group(options = {}) ⇒ Core::Response

Calls the ModifyOptionGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :option_group_name - required - (String) The name of the option group to be modified.
  • :options_to_include - (Array<) Options in this list are added to the Option Group or, if already present, the specified configuration is used to update the existing configuration.
    • :option_name - required - (String) The configuration of options to include in a group.
    • :port - (Integer) The optional port for the option.
    • :db_security_group_memberships - (Array<) A list of DBSecurityGroupMemebrship name strings used for this option.
    • :vpc_security_group_memberships - (Array<) A list of VpcSecurityGroupMemebrship name strings used for this option.
    • :option_settings - (Array<) The option settings to include in an option group.
      • :name - (String) The name of the option that has settings that you can set.
      • :value - (String) The current value of the option setting.
      • :default_value - (String) The default value of the option setting.
      • :description - (String) The description of the option setting.
      • :apply_type - (String) The DB engine specific parameter type.
      • :data_type - (String) The data type of the option setting.
      • :allowed_values - (String) The allowed values of the option setting.
      • :is_modifiable - (Boolean) A Boolean value that, when true , indicates the option setting can be modified from the default.
      • :is_collection - (Boolean) Indicates if the option setting is part of a collection.
  • :options_to_remove - (Array<) Options in this list are removed from the Option Group.
  • :apply_immediately - (Boolean) Indicates whether the changes should be applied immediately, or during the next maintenance window for each instance associated with the Option Group.

Returns:

• (Core::Response) —

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

  • :option_group_name - (String)
  • :option_group_description - (String)
  • :engine_name - (String)
  • :major_engine_version - (String)
  • :options - (Array)
    • :option_name - (String)
    • :option_description - (String)
    • :persistent - (Boolean)
    • :permanent - (Boolean)
    • :port - (Integer)
    • :option_settings - (Array)
      • :name - (String)
      • :value - (String)
      • :default_value - (String)
      • :description - (String)
      • :apply_type - (String)
      • :data_type - (String)
      • :allowed_values - (String)
      • :is_modifiable - (Boolean)
      • :is_collection - (Boolean)
    • :db_security_group_memberships - (Array)
      • :db_security_group_name - (String)
      • :status - (String)
    • :vpc_security_group_memberships - (Array)
      • :vpc_security_group_id - (String)
      • :status - (String)
  • :allows_vpc_and_non_vpc_instance_memberships - (Boolean)
  • :vpc_id - (String)

#promote_read_replica(options = {}) ⇒ Core::Response

Calls the PromoteReadReplica API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_instance_identifier - required - (String) The DB Instance identifier. This value is stored as a lowercase string. Constraints: Must be the identifier for an existing Read Replica DB Instance 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 Example: mydbinstance
  • :backup_retention_period - (Integer) 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
  • :preferred_backup_window - (String) 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. The following list shows the time blocks for each region from which the default backup windows are assigned. US-East (Northern Virginia) Region: 03:00-11:00 UTC US-West (Northern California) Region: 06:00-14:00 UTC EU (Ireland) Region: 22:00-06:00 UTC Asia Pacific (Singapore) Region: 14:00-22:00 UTC Asia Pacific (Tokyo) Region: 17:00-03:00 UTC Constraints: Must be in the format hh24:mi-hh24:mi. Times should be Universal Time Coordinated (UTC). Must not conflict with the preferred maintenance window. Must be at least 30 minutes.

Returns:

• (Core::Response) —

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

  • :db_instance_identifier - (String)
  • :db_instance_class - (String)
  • :engine - (String)
  • :db_instance_status - (String)
  • :master_username - (String)
  • :db_name - (String)
  • :endpoint - (Hash)
    • :address - (String)
    • :port - (Integer)
  • :allocated_storage - (Integer)
  • :instance_create_time - (Time)
  • :preferred_backup_window - (String)
  • :backup_retention_period - (Integer)
  • :db_security_groups - (Array)
    • :db_security_group_name - (String)
    • :status - (String)
  • :vpc_security_groups - (Array)
    • :vpc_security_group_id - (String)
    • :status - (String)
  • :db_parameter_groups - (Array)
    • :db_parameter_group_name - (String)
    • :parameter_apply_status - (String)
  • :availability_zone - (String)
  • :db_subnet_group - (Hash)
    • :db_subnet_group_name - (String)
    • :db_subnet_group_description - (String)
    • :vpc_id - (String)
    • :subnet_group_status - (String)
    • :subnets - (Array)
      • :subnet_identifier - (String)
      • :subnet_availability_zone - (Hash)
        • :name - (String)
      • :subnet_status - (String)
  • :preferred_maintenance_window - (String)
  • :pending_modified_values - (Hash)
    • :db_instance_class - (String)
    • :allocated_storage - (Integer)
    • :master_user_password - (String)
    • :port - (Integer)
    • :backup_retention_period - (Integer)
    • :multi_az - (Boolean)
    • :engine_version - (String)
    • :iops - (Integer)
    • :db_instance_identifier - (String)
    • :storage_type - (String)
  • :latest_restorable_time - (Time)
  • :multi_az - (Boolean)
  • :engine_version - (String)
  • :auto_minor_version_upgrade - (Boolean)
  • :read_replica_source_db_instance_identifier - (String)
  • :read_replica_db_instance_identifiers - (Array)
  • :license_model - (String)
  • :iops - (Integer)
  • :option_group_memberships - (Array)
    • :option_group_name - (String)
    • :status - (String)
  • :character_set_name - (String)
  • :secondary_availability_zone - (String)
  • :publicly_accessible - (Boolean)
  • :status_infos - (Array)
    • :status_type - (String)
    • :normal - (Boolean)
    • :status - (String)
    • :message - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#purchase_reserved_db_instances_offering(options = {}) ⇒ Core::Response

Calls the PurchaseReservedDBInstancesOffering API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :reserved_db_instances_offering_id - required - (String) The ID of the Reserved DB Instance offering to purchase. Example: 438012d3-4052-4cc7-b2e3-8d3372e0e706
  • :reserved_db_instance_id - (String) Customer-specified identifier to track this reservation. Example: myreservationID
  • :db_instance_count - (Integer) The number of instances to reserve. Default: 1
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").

Returns:

• (Core::Response) —

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

  • :reserved_db_instance_id - (String)
  • :reserved_db_instances_offering_id - (String)
  • :db_instance_class - (String)
  • :start_time - (Time)
  • :duration - (Integer)
  • :fixed_price - (Numeric)
  • :usage_price - (Numeric)
  • :currency_code - (String)
  • :db_instance_count - (Integer)
  • :product_description - (String)
  • :offering_type - (String)
  • :multi_az - (Boolean)
  • :state - (String)
  • :recurring_charges - (Array)
    • :recurring_charge_amount - (Numeric)
    • :recurring_charge_frequency - (String)

#reboot_db_instance(options = {}) ⇒ Core::Response

Calls the RebootDBInstance API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_instance_identifier - required - (String) The DB Instance identifier. This parameter is stored as a lowercase string.
  • :force_failover - (Boolean) When true , the reboot will be conducted through a MultiAZ failover. Constraint: You cannot specify true if the instance is not configured for MultiAZ.

Returns:

• (Core::Response) —

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

  • :db_instance_identifier - (String)
  • :db_instance_class - (String)
  • :engine - (String)
  • :db_instance_status - (String)
  • :master_username - (String)
  • :db_name - (String)
  • :endpoint - (Hash)
    • :address - (String)
    • :port - (Integer)
  • :allocated_storage - (Integer)
  • :instance_create_time - (Time)
  • :preferred_backup_window - (String)
  • :backup_retention_period - (Integer)
  • :db_security_groups - (Array)
    • :db_security_group_name - (String)
    • :status - (String)
  • :vpc_security_groups - (Array)
    • :vpc_security_group_id - (String)
    • :status - (String)
  • :db_parameter_groups - (Array)
    • :db_parameter_group_name - (String)
    • :parameter_apply_status - (String)
  • :availability_zone - (String)
  • :db_subnet_group - (Hash)
    • :db_subnet_group_name - (String)
    • :db_subnet_group_description - (String)
    • :vpc_id - (String)
    • :subnet_group_status - (String)
    • :subnets - (Array)
      • :subnet_identifier - (String)
      • :subnet_availability_zone - (Hash)
        • :name - (String)
      • :subnet_status - (String)
  • :preferred_maintenance_window - (String)
  • :pending_modified_values - (Hash)
    • :db_instance_class - (String)
    • :allocated_storage - (Integer)
    • :master_user_password - (String)
    • :port - (Integer)
    • :backup_retention_period - (Integer)
    • :multi_az - (Boolean)
    • :engine_version - (String)
    • :iops - (Integer)
    • :db_instance_identifier - (String)
    • :storage_type - (String)
  • :latest_restorable_time - (Time)
  • :multi_az - (Boolean)
  • :engine_version - (String)
  • :auto_minor_version_upgrade - (Boolean)
  • :read_replica_source_db_instance_identifier - (String)
  • :read_replica_db_instance_identifiers - (Array)
  • :license_model - (String)
  • :iops - (Integer)
  • :option_group_memberships - (Array)
    • :option_group_name - (String)
    • :status - (String)
  • :character_set_name - (String)
  • :secondary_availability_zone - (String)
  • :publicly_accessible - (Boolean)
  • :status_infos - (Array)
    • :status_type - (String)
    • :normal - (Boolean)
    • :status - (String)
    • :message - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#remove_source_identifier_from_subscription(options = {}) ⇒ Core::Response

Calls the RemoveSourceIdentifierFromSubscription API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :subscription_name - required - (String) The name of the RDS event notification subscription you want to remove a source identifier from.
  • :source_identifier - required - (String) The source identifier to be removed from the subscription, such as the DB instance identifier for a DB instance or the name of a security group.

Returns:

• (Core::Response) —

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

  • :customer_aws_id - (String)
  • :cust_subscription_id - (String)
  • :sns_topic_arn - (String)
  • :status - (String)
  • :subscription_creation_time - (String)
  • :source_type - (String)
  • :source_ids_list - (Array)
  • :event_categories_list - (Array)
  • :enabled - (Boolean)

#remove_tags_from_resource(options = {}) ⇒ Core::Response

Calls the RemoveTagsFromResource API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :resource_name - required - (String) The DB Instance the tags will be removed from.
  • :tag_keys - required - (Array<) The tag key (name) of the tag to be removed.

Returns:

• (Core::Response)

#reset_db_parameter_group(options = {}) ⇒ Core::Response

Calls the ResetDBParameterGroup API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_parameter_group_name - required - (String) The name of the DB Parameter Group.
  • :reset_all_parameters - (Boolean) Specifies whether ( true ) or not ( false ) to reset all parameters in the DB Parameter Group to default values.
  • :parameters - (Array<) An array of parameter names, values, and the apply method for the parameter update. At least one parameter name, value, and apply method must be supplied; subsequent arguments are optional. A maximum of 20 parameters may be modified in a single request.
    • :parameter_name - (String) Specifies the name of the parameter.
    • :parameter_value - (String) Specifies the value of the parameter.
    • :description - (String) Provides a description of the parameter.
    • :source - (String) Indicates the source of the parameter value.
    • :apply_type - (String) Specifies the engine specific parameters type.
    • :data_type - (String) Specifies the valid data type for the parameter.
    • :allowed_values - (String) Specifies the valid range of values for the parameter.
    • :is_modifiable - (Boolean) Indicates whether ( true ) or not ( false ) the parameter can be modified. Some parameters have security or operational implications that prevent them from being changed.
    • :minimum_engine_version - (String) The earliest engine version to which the parameter can apply.
    • :apply_method - (String) Indicates when to apply parameter updates. Valid values include:
      • immediate
      • pending-reboot

Returns:

• (Core::Response) —

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

  • :db_parameter_group_name - (String)

#restore_db_instance_from_db_snapshot(options = {}) ⇒ Core::Response

Calls the RestoreDBInstanceFromDBSnapshot API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_instance_identifier - required - (String) The identifier for the DB Snapshot to restore from.
  • :db_snapshot_identifier - required - (String) Name of the DB Instance to create from the DB Snapshot. This parameter isn't case sensitive.
  • :db_instance_class - (String) The compute and memory capacity of the Amazon RDS DB instance.
  • :port - (Integer) The port number on which the database accepts connections.
  • :availability_zone - (String) The EC2 Availability Zone that the database instance will be created in.
  • :db_subnet_group_name - (String) The DB Subnet Group name to use for the new instance.
  • :multi_az - (Boolean) 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 .
  • :publicly_accessible - (Boolean) 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.
  • :auto_minor_version_upgrade - (Boolean) Indicates that minor version upgrades will be applied automatically to the DB Instance during the maintenance window.
  • :license_model - (String) License model information for the restored DB Instance. Default: Same as source. Valid values: license-included | bring-your-own-license | general-public-license
  • :db_name - (String) The database name for the restored DB Instance. This parameter doesn't apply to the MySQL engine.
  • :engine - (String) The database engine to use for the new instance. Default: The same as source Constraint: Must be compatible with the engine of the source Example: oracle-ee
  • :iops - (Integer) 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.
  • :option_group_name - (String) 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
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
  • :storage_type - (String) Specifies 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.
  • :tde_credential_arn - (String) The ARN from the Key Store with which to associate the instance for TDE encryption.
  • :tde_credential_password - (String) The password for the given ARN from the Key Store in order to access the device.

Returns:

• (Core::Response) —

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

  • :db_instance_identifier - (String)
  • :db_instance_class - (String)
  • :engine - (String)
  • :db_instance_status - (String)
  • :master_username - (String)
  • :db_name - (String)
  • :endpoint - (Hash)
    • :address - (String)
    • :port - (Integer)
  • :allocated_storage - (Integer)
  • :instance_create_time - (Time)
  • :preferred_backup_window - (String)
  • :backup_retention_period - (Integer)
  • :db_security_groups - (Array)
    • :db_security_group_name - (String)
    • :status - (String)
  • :vpc_security_groups - (Array)
    • :vpc_security_group_id - (String)
    • :status - (String)
  • :db_parameter_groups - (Array)
    • :db_parameter_group_name - (String)
    • :parameter_apply_status - (String)
  • :availability_zone - (String)
  • :db_subnet_group - (Hash)
    • :db_subnet_group_name - (String)
    • :db_subnet_group_description - (String)
    • :vpc_id - (String)
    • :subnet_group_status - (String)
    • :subnets - (Array)
      • :subnet_identifier - (String)
      • :subnet_availability_zone - (Hash)
        • :name - (String)
      • :subnet_status - (String)
  • :preferred_maintenance_window - (String)
  • :pending_modified_values - (Hash)
    • :db_instance_class - (String)
    • :allocated_storage - (Integer)
    • :master_user_password - (String)
    • :port - (Integer)
    • :backup_retention_period - (Integer)
    • :multi_az - (Boolean)
    • :engine_version - (String)
    • :iops - (Integer)
    • :db_instance_identifier - (String)
    • :storage_type - (String)
  • :latest_restorable_time - (Time)
  • :multi_az - (Boolean)
  • :engine_version - (String)
  • :auto_minor_version_upgrade - (Boolean)
  • :read_replica_source_db_instance_identifier - (String)
  • :read_replica_db_instance_identifiers - (Array)
  • :license_model - (String)
  • :iops - (Integer)
  • :option_group_memberships - (Array)
    • :option_group_name - (String)
    • :status - (String)
  • :character_set_name - (String)
  • :secondary_availability_zone - (String)
  • :publicly_accessible - (Boolean)
  • :status_infos - (Array)
    • :status_type - (String)
    • :normal - (Boolean)
    • :status - (String)
    • :message - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#restore_db_instance_to_point_in_time(options = {}) ⇒ Core::Response

Calls the RestoreDBInstanceToPointInTime API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :source_db_instance_identifier - required - (String) The identifier of the source DB Instance from which to restore.
  • :target_db_instance_identifier - required - (String) The name of the new database instance to be created.
  • :restore_time - (String<) The date and time from to restore from.
  • :use_latest_restorable_time - (Boolean) Specifies whether ( true ) or not ( false ) the DB Instance is restored from the latest backup time.
  • :db_instance_class - (String) The compute and memory capacity of the Amazon RDS DB instance.
  • :port - (Integer) The port number on which the database accepts connections.
  • :availability_zone - (String) The EC2 Availability Zone that the database instance will be created in.
  • :db_subnet_group_name - (String) The DB subnet group name to use for the new instance.
  • :multi_az - (Boolean) 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 .
  • :publicly_accessible - (Boolean) 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.
  • :auto_minor_version_upgrade - (Boolean) Indicates that minor version upgrades will be applied automatically to the DB Instance during the maintenance window.
  • :license_model - (String) License model information for the restored DB Instance. Default: Same as source. Valid values: license-included | bring-your-own-license | general-public-license
  • :db_name - (String) The database name for the restored DB Instance. This parameter is not used for the MySQL engine.
  • :engine - (String) The database engine to use for the new instance. Default: The same as source Constraint: Must be compatible with the engine of the source Example: oracle-ee
  • :iops - (Integer) 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.
  • :option_group_name - (String) 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
  • :tags - (Array<)
    • :key - (String) A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
    • :value - (String) A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and cannot be prefixed with "aws:". The string may only contain only the set of Unicode letters, digits, white-space, '', '.', '/', '=', '+', '-' (Java regex: "^([\p{L}\\p{Z}\\p{N}.:/=+\-]*)$").
  • :storage_type - (String) Specifies 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.
  • :tde_credential_arn - (String) The ARN from the Key Store with which to associate the instance for TDE encryption.
  • :tde_credential_password - (String) The password for the given ARN from the Key Store in order to access the device.

Returns:

• (Core::Response) —

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

  • :db_instance_identifier - (String)
  • :db_instance_class - (String)
  • :engine - (String)
  • :db_instance_status - (String)
  • :master_username - (String)
  • :db_name - (String)
  • :endpoint - (Hash)
    • :address - (String)
    • :port - (Integer)
  • :allocated_storage - (Integer)
  • :instance_create_time - (Time)
  • :preferred_backup_window - (String)
  • :backup_retention_period - (Integer)
  • :db_security_groups - (Array)
    • :db_security_group_name - (String)
    • :status - (String)
  • :vpc_security_groups - (Array)
    • :vpc_security_group_id - (String)
    • :status - (String)
  • :db_parameter_groups - (Array)
    • :db_parameter_group_name - (String)
    • :parameter_apply_status - (String)
  • :availability_zone - (String)
  • :db_subnet_group - (Hash)
    • :db_subnet_group_name - (String)
    • :db_subnet_group_description - (String)
    • :vpc_id - (String)
    • :subnet_group_status - (String)
    • :subnets - (Array)
      • :subnet_identifier - (String)
      • :subnet_availability_zone - (Hash)
        • :name - (String)
      • :subnet_status - (String)
  • :preferred_maintenance_window - (String)
  • :pending_modified_values - (Hash)
    • :db_instance_class - (String)
    • :allocated_storage - (Integer)
    • :master_user_password - (String)
    • :port - (Integer)
    • :backup_retention_period - (Integer)
    • :multi_az - (Boolean)
    • :engine_version - (String)
    • :iops - (Integer)
    • :db_instance_identifier - (String)
    • :storage_type - (String)
  • :latest_restorable_time - (Time)
  • :multi_az - (Boolean)
  • :engine_version - (String)
  • :auto_minor_version_upgrade - (Boolean)
  • :read_replica_source_db_instance_identifier - (String)
  • :read_replica_db_instance_identifiers - (Array)
  • :license_model - (String)
  • :iops - (Integer)
  • :option_group_memberships - (Array)
    • :option_group_name - (String)
    • :status - (String)
  • :character_set_name - (String)
  • :secondary_availability_zone - (String)
  • :publicly_accessible - (Boolean)
  • :status_infos - (Array)
    • :status_type - (String)
    • :normal - (Boolean)
    • :status - (String)
    • :message - (String)
  • :storage_type - (String)
  • :tde_credential_arn - (String)

#revoke_db_security_group_ingress(options = {}) ⇒ Core::Response

Calls the RevokeDBSecurityGroupIngress API operation.

Parameters:

• options (Hash) (defaults to: {}) —
  • :db_security_group_name - required - (String) The name of the DB Security Group to revoke ingress from.
  • :cidrip - (String) The IP range to revoke access from.
  • :ec2_security_group_name - (String) The name of the EC2 Security Group to revoke access from.
  • :ec2_security_group_id - (String) The id of the EC2 Security Group to revoke access from. For VPC DB Security Groups, EC2SecurityGroupId must be provided. Otherwise, EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId must be provided.
  • :ec2_security_group_owner_id - (String) The AWS Account Number of the owner of the security group specified in the EC2SecurityGroupName parameter. The AWS Access Key ID is not an acceptable value.

Returns:

• (Core::Response) —

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

  • :owner_id - (String)
  • :db_security_group_name - (String)
  • :db_security_group_description - (String)
  • :vpc_id - (String)
  • :ec_2_security_groups - (Array)
    • :status - (String)
    • :ec2_security_group_name - (String)
    • :ec2_security_group_id - (String)
    • :ec2_security_group_owner_id - (String)
  • :ip_ranges - (Array)
    • :status - (String)
    • :cidrip - (String)