Class: AWS::RDS::Client

Inherits:
Core::QueryClient show all
Defined in:
lib/aws/rds/client.rb

Overview

Client class for Amazon Relational Database Service (RDS).

Instance Attribute Summary

Attributes inherited from Core::Client

#config, #http_read_timeout

Instance Method Summary collapse

Methods inherited from Core::Client

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

Constructor Details

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

Instance Method Details

#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<Hash>) 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: “^([\pL\pZ\pN_.:/=+\-]*)$”).

      • :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: “^([\pL\pZ\pN_.:/=+\-]*)$”).

Returns:



# File 'lib/aws/rds/client.rb', line 25

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

Calls the AuthorizeDBSecurityGroupIngress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :db_security_group_name - required - (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<Hash>)

      • :status - (String)

      • :ec2_security_group_name - (String)

      • :ec2_security_group_id - (String)

      • :ec2_security_group_owner_id - (String)

    • :ip_ranges - (Array<Hash>)

      • :status - (String)

      • :cidrip - (String)



# File 'lib/aws/rds/client.rb', line 46

#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

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)



# File 'lib/aws/rds/client.rb', line 77

#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<String>) A list of DB Security Groups to associate with this DB Instance.

    • :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 input/output operations per second to be initially allocated for the database instance. Constraints: Must be an integer Type: Integer

    • :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.

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<Hash>)

      • :db_security_group_name - (String)

      • :status - (String)

    • :db_parameter_groups - (Array<Hash>)

      • :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<Hash>)

        • :subnet_identifier - (String)

        • :subnet_availability_zone - (Hash)

          • :name - (String)

          • :provisioned_iops_capable - (Boolean)

        • :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)

    • :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<String>)

    • :license_model - (String)

    • :iops - (Integer)

    • :option_group_membership - (Hash)

      • :option_group_name - (String)

      • :status - (String)

    • :character_set_name - (String)



# File 'lib/aws/rds/client.rb', line 108

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

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<Hash>)

      • :db_security_group_name - (String)

      • :status - (String)

    • :db_parameter_groups - (Array<Hash>)

      • :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<Hash>)

        • :subnet_identifier - (String)

        • :subnet_availability_zone - (Hash)

          • :name - (String)

          • :provisioned_iops_capable - (Boolean)

        • :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)

    • :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<String>)

    • :license_model - (String)

    • :iops - (Integer)

    • :option_group_membership - (Hash)

      • :option_group_name - (String)

      • :status - (String)

    • :character_set_name - (String)



# File 'lib/aws/rds/client.rb', line 224

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

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)



# File 'lib/aws/rds/client.rb', line 312

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

    • :ec2_vpc_id - (String) The Id of VPC. Indicates which VPC this DB Security Group should belong to. Must be specified to create a DB Security Group for a VPC; may not be specified otherwise.

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<Hash>)

      • :status - (String)

      • :ec2_security_group_name - (String)

      • :ec2_security_group_id - (String)

      • :ec2_security_group_owner_id - (String)

    • :ip_ranges - (Array<Hash>)

      • :status - (String)

      • :cidrip - (String)



# File 'lib/aws/rds/client.rb', line 329

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

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)



# File 'lib/aws/rds/client.rb', line 355

#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<String>) 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<Hash>)

      • :subnet_identifier - (String)

      • :subnet_availability_zone - (Hash)

        • :name - (String)

        • :provisioned_iops_capable - (Boolean)

      • :subnet_status - (String)



# File 'lib/aws/rds/client.rb', line 382

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

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<Hash>)

      • :option_name - (String)

      • :option_description - (String)

      • :port - (Integer)

      • :db_security_group_memberships - (Array<Hash>)

        • :db_security_group_name - (String)

        • :status - (String)

    • :allows_vpc_and_non_vpc_instance_memberships - (Boolean)

    • :vpc_id - (String)



# File 'lib/aws/rds/client.rb', line 407

#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<Hash>)

      • :db_security_group_name - (String)

      • :status - (String)

    • :db_parameter_groups - (Array<Hash>)

      • :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<Hash>)

        • :subnet_identifier - (String)

        • :subnet_availability_zone - (Hash)

          • :name - (String)

          • :provisioned_iops_capable - (Boolean)

        • :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)

    • :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<String>)

    • :license_model - (String)

    • :iops - (Integer)

    • :option_group_membership - (Hash)

      • :option_group_name - (String)

      • :status - (String)

    • :character_set_name - (String)



# File 'lib/aws/rds/client.rb', line 439

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



# File 'lib/aws/rds/client.rb', line 507

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



# File 'lib/aws/rds/client.rb', line 515

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



# File 'lib/aws/rds/client.rb', line 522

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



# File 'lib/aws/rds/client.rb', line 546

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



# File 'lib/aws/rds/client.rb', line 556

#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

    • :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<Hash>)

      • :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<Hash>)

        • :character_set_name - (String)

        • :character_set_description - (String)



# File 'lib/aws/rds/client.rb', line 563

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

    • :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<Hash>)

      • :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<Hash>)

        • :db_security_group_name - (String)

        • :status - (String)

      • :db_parameter_groups - (Array<Hash>)

        • :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<Hash>)

          • :subnet_identifier - (String)

          • :subnet_availability_zone - (Hash)

            • :name - (String)

            • :provisioned_iops_capable - (Boolean)

          • :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)

      • :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<String>)

      • :license_model - (String)

      • :iops - (Integer)

      • :option_group_membership - (Hash)

        • :option_group_name - (String)

        • :status - (String)

      • :character_set_name - (String)



# File 'lib/aws/rds/client.rb', line 604

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

    • :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<Hash>)

      • :db_parameter_group_name - (String)

      • :db_parameter_group_family - (String)

      • :description - (String)



# File 'lib/aws/rds/client.rb', line 678

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

    • :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<Hash>)

      • :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)



# File 'lib/aws/rds/client.rb', line 700

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

    • :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<Hash>)

      • :owner_id - (String)

      • :db_security_group_name - (String)

      • :db_security_group_description - (String)

      • :vpc_id - (String)

      • :ec_2_security_groups - (Array<Hash>)

        • :status - (String)

        • :ec2_security_group_name - (String)

        • :ec2_security_group_id - (String)

        • :ec2_security_group_owner_id - (String)

      • :ip_ranges - (Array<Hash>)

        • :status - (String)

        • :cidrip - (String)



# File 'lib/aws/rds/client.rb', line 730

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

    • :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<Hash>)

      • :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)



# File 'lib/aws/rds/client.rb', line 761

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

    • :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<Hash>)

      • :db_subnet_group_name - (String)

      • :db_subnet_group_description - (String)

      • :vpc_id - (String)

      • :subnet_group_status - (String)

      • :subnets - (Array<Hash>)

        • :subnet_identifier - (String)

        • :subnet_availability_zone - (Hash)

          • :name - (String)

          • :provisioned_iops_capable - (Boolean)

        • :subnet_status - (String)



# File 'lib/aws/rds/client.rb', line 800

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

    • :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<Hash>)

      • :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)



# File 'lib/aws/rds/client.rb', line 830

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

    • :start_time - (String<ISO8601 datetime>) The beginning of the time interval to retrieve events for, specified in ISO 8601 format.

    • :end_time - (String<ISO8601 datetime>) 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.

    • :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<Hash>)

      • :source_identifier - (String)

      • :source_type - (String)

      • :message - (String)

      • :date - (Time)



# File 'lib/aws/rds/client.rb', line 860

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

    • :max_records - (Integer)

    • :marker - (String)

Returns:

  • (Core::Response)

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

    • :option_group_options - (Array<Hash>)

      • :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<String>)

    • :marker - (String)



# File 'lib/aws/rds/client.rb', line 893

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

    • :marker - (String)

    • :max_records - (Integer)

    • :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<Hash>)

      • :option_group_name - (String)

      • :option_group_description - (String)

      • :engine_name - (String)

      • :major_engine_version - (String)

      • :options - (Array<Hash>)

        • :option_name - (String)

        • :option_description - (String)

        • :port - (Integer)

        • :db_security_group_memberships - (Array<Hash>)

          • :db_security_group_name - (String)

          • :status - (String)

      • :allows_vpc_and_non_vpc_instance_memberships - (Boolean)

      • :vpc_id - (String)

    • :marker - (String)



# File 'lib/aws/rds/client.rb', line 917

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

    • :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<Hash>)

      • :engine - (String)

      • :engine_version - (String)

      • :db_instance_class - (String)

      • :license_model - (String)

      • :availability_zones - (Array<Hash>)

        • :name - (String)

        • :provisioned_iops_capable - (Boolean)

      • :multi_az_capable - (Boolean)

      • :read_replica_capable - (Boolean)

      • :vpc - (Boolean)

    • :marker - (String)



# File 'lib/aws/rds/client.rb', line 950

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

    • :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<Hash>)

      • :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<Hash>)

        • :recurring_charge_amount - (Numeric)

        • :recurring_charge_frequency - (String)



# File 'lib/aws/rds/client.rb', line 991

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

    • :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<Hash>)

      • :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<Hash>)

        • :recurring_charge_amount - (Numeric)

        • :recurring_charge_frequency - (String)



# File 'lib/aws/rds/client.rb', line 1045

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

Returns:

  • (Core::Response)

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

    • :tag_list - (Array<Hash>)

      • :key - (String)

      • :value - (String)



# File 'lib/aws/rds/client.rb', line 1093

#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<String>) A list of DB Security Groups to authorize on this DB Instance. This change is asynchronously applied as soon as possible.

    • :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 I/O operations per second 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. 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. Type: Integer

    • :option_group_name - (String) Indicates that the DB Instance should be associated with the specified option group.

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<Hash>)

      • :db_security_group_name - (String)

      • :status - (String)

    • :db_parameter_groups - (Array<Hash>)

      • :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<Hash>)

        • :subnet_identifier - (String)

        • :subnet_availability_zone - (Hash)

          • :name - (String)

          • :provisioned_iops_capable - (Boolean)

        • :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)

    • :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<String>)

    • :license_model - (String)

    • :iops - (Integer)

    • :option_group_membership - (Hash)

      • :option_group_name - (String)

      • :status - (String)

    • :character_set_name - (String)



# File 'lib/aws/rds/client.rb', line 1105

#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<Hash>) 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.

Returns:

  • (Core::Response)

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

    • :db_parameter_group_name - (String)



# File 'lib/aws/rds/client.rb', line 1235

#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<String>) 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<Hash>)

      • :subnet_identifier - (String)

      • :subnet_availability_zone - (Hash)

        • :name - (String)

        • :provisioned_iops_capable - (Boolean)

      • :subnet_status - (String)



# File 'lib/aws/rds/client.rb', line 1270

#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<Hash>) 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)

      • :port - (Integer)

      • :db_security_group_memberships - (Array<String>)

    • :options_to_remove - (Array<String>) 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<Hash>)

      • :option_name - (String)

      • :option_description - (String)

      • :port - (Integer)

      • :db_security_group_memberships - (Array<Hash>)

        • :db_security_group_name - (String)

        • :status - (String)

    • :allows_vpc_and_non_vpc_instance_memberships - (Boolean)

    • :vpc_id - (String)



# File 'lib/aws/rds/client.rb', line 1295

#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<Hash>)

      • :db_security_group_name - (String)

      • :status - (String)

    • :db_parameter_groups - (Array<Hash>)

      • :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<Hash>)

        • :subnet_identifier - (String)

        • :subnet_availability_zone - (Hash)

          • :name - (String)

          • :provisioned_iops_capable - (Boolean)

        • :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)

    • :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<String>)

    • :license_model - (String)

    • :iops - (Integer)

    • :option_group_membership - (Hash)

      • :option_group_name - (String)

      • :status - (String)

    • :character_set_name - (String)



# File 'lib/aws/rds/client.rb', line 1328

#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

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<Hash>)

      • :recurring_charge_amount - (Numeric)

      • :recurring_charge_frequency - (String)



# File 'lib/aws/rds/client.rb', line 1411

#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<Hash>)

      • :db_security_group_name - (String)

      • :status - (String)

    • :db_parameter_groups - (Array<Hash>)

      • :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<Hash>)

        • :subnet_identifier - (String)

        • :subnet_availability_zone - (Hash)

          • :name - (String)

          • :provisioned_iops_capable - (Boolean)

        • :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)

    • :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<String>)

    • :license_model - (String)

    • :iops - (Integer)

    • :option_group_membership - (Hash)

      • :option_group_name - (String)

      • :status - (String)

    • :character_set_name - (String)



# File 'lib/aws/rds/client.rb', line 1441

#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<String>) The tag key (name) of the tag to be removed.

Returns:



# File 'lib/aws/rds/client.rb', line 1506

#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<Hash>) 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.

Returns:

  • (Core::Response)

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

    • :db_parameter_group_name - (String)



# File 'lib/aws/rds/client.rb', line 1515

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

    • :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)

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<Hash>)

      • :db_security_group_name - (String)

      • :status - (String)

    • :db_parameter_groups - (Array<Hash>)

      • :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<Hash>)

        • :subnet_identifier - (String)

        • :subnet_availability_zone - (Hash)

          • :name - (String)

          • :provisioned_iops_capable - (Boolean)

        • :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)

    • :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<String>)

    • :license_model - (String)

    • :iops - (Integer)

    • :option_group_membership - (Hash)

      • :option_group_name - (String)

      • :status - (String)

    • :character_set_name - (String)



# File 'lib/aws/rds/client.rb', line 1553

#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<ISO8601 datetime>) 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 .

    • :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)

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<Hash>)

      • :db_security_group_name - (String)

      • :status - (String)

    • :db_parameter_groups - (Array<Hash>)

      • :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<Hash>)

        • :subnet_identifier - (String)

        • :subnet_availability_zone - (Hash)

          • :name - (String)

          • :provisioned_iops_capable - (Boolean)

        • :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)

    • :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<String>)

    • :license_model - (String)

    • :iops - (Integer)

    • :option_group_membership - (Hash)

      • :option_group_name - (String)

      • :status - (String)

    • :character_set_name - (String)



# File 'lib/aws/rds/client.rb', line 1644

#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<Hash>)

      • :status - (String)

      • :ec2_security_group_name - (String)

      • :ec2_security_group_id - (String)

      • :ec2_security_group_owner_id - (String)

    • :ip_ranges - (Array<Hash>)

      • :status - (String)

      • :cidrip - (String)



# File 'lib/aws/rds/client.rb', line 1739