Method: Aws::RDS::DBEngine#versions

Defined in:

lib/aws-sdk-rds/db_engine.rb

#versions(options = {}) ⇒ DBEngineVersion::Collection

Examples:

Request syntax with placeholder values

versions = db_engine.versions({
  engine_version: "String",
  db_parameter_group_family: "String",
  filters: [
    {
      name: "String", # required
      values: ["String"], # required
    },
  ],
  default_only: false,
  list_supported_character_sets: false,
  list_supported_timezones: false,
  include_all: false,
})

Parameters:

• options (Hash) (defaults to: {}) —

  ({})

Options Hash (options):

• :engine_version (String) —

  A specific database engine version to return details for.

  Example: ‘5.1.49`

• :db_parameter_group_family (String) —

  The name of a specific DB parameter group family to return details for.

  Constraints:

  • If supplied, must match an existing DB parameter group family.

  ^

• :filters (Array<Types::Filter>) —

  A filter that specifies one or more DB engine versions to describe.

  Supported filters:

  • ‘db-parameter-group-family` - Accepts parameter groups family names. The results list only includes information about the DB engine versions for these parameter group families.

  • ‘engine` - Accepts engine names. The results list only includes information about the DB engine versions for these engines.

  • ‘engine-mode` - Accepts DB engine modes. The results list only includes information about the DB engine versions for these engine modes. Valid DB engine modes are the following:

    • ‘global`

    • ‘multimaster`

    • ‘parallelquery`

    • ‘provisioned`

    • ‘serverless`

  • ‘engine-version` - Accepts engine versions. The results list only includes information about the DB engine versions for these engine versions.

  • ‘status` - Accepts engine version statuses. The results list only includes information about the DB engine versions for these statuses. Valid statuses are the following:

    • ‘available`

    • ‘deprecated`

• :default_only (Boolean) —

  Specifies whether to return only the default version of the specified engine or the engine and major version combination.

• :list_supported_character_sets (Boolean) —

  Specifies whether to list the supported character sets for each engine version.

  If this parameter is enabled and the requested engine supports the ‘CharacterSetName` parameter for `CreateDBInstance`, the response includes a list of supported character sets for each engine version.

  For RDS Custom, the default is not to list supported character sets. If you enable this parameter, RDS Custom returns no results.

• :list_supported_timezones (Boolean) —

  Specifies whether to list the supported time zones for each engine version.

  If this parameter is enabled and the requested engine supports the ‘TimeZone` parameter for `CreateDBInstance`, the response includes a list of supported time zones for each engine version.

  For RDS Custom, the default is not to list supported time zones. If you enable this parameter, RDS Custom returns no results.

• :include_all (Boolean) —

  Specifies whether to also list the engine versions that aren’t available. The default is to list only available engine versions.

Returns:

• (DBEngineVersion::Collection)

# File 'lib/aws-sdk-rds/db_engine.rb', line 352

def versions(options = {})
  batches = Enumerator.new do |y|
    options = options.merge(engine: @name)
    resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
      @client.describe_db_engine_versions(options)
    end
    resp.each_page do |page|
      batch = []
      page.data.db_engine_versions.each do |d|
        batch << DBEngineVersion.new(
          engine_name: @name,
          version: d.engine_version,
          data: d,
          client: @client
        )
      end
      y.yield(batch)
    end
  end
  DBEngineVersion::Collection.new(batches)
end