Menu
Amazon Relational Database Service
API Reference (API Version 2014-10-31)

DescribeDBEngineVersions

Returns a list of the available DB engines.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

DBParameterGroupFamily

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

Constraints:

  • If supplied, must match an existing DBParameterGroupFamily.

Type: String

Required: No

DefaultOnly

Indicates that only the default version of the specified engine or engine and major version combination is returned.

Type: Boolean

Required: No

Engine

The database engine to return.

Type: String

Required: No

EngineVersion

The database engine version to return.

Example: 5.1.49

Type: String

Required: No

Filters.Filter.N

Not currently supported.

Type: Array of Filter objects

Required: No

ListSupportedCharacterSets

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

Type: Boolean

Required: No

ListSupportedTimezones

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

Type: Boolean

Required: No

Marker

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.

Type: String

Required: No

MaxRecords

The maximum number of records to include in the response. If more than the MaxRecords value is available, a pagination token called a marker is included in the response so that the following results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

Type: Integer

Required: No

Response Elements

The following elements are returned by the service.

DBEngineVersions.DBEngineVersion.N

A list of DBEngineVersion elements.

Type: Array of DBEngineVersion objects

Marker

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.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

Example

Sample Request


https://rds.us-west-2.amazonaws.com/
   ?Action=DescribeDBEngineVersions
   &MaxRecords=100 
   &SignatureMethod=HmacSHA256 
   &SignatureVersion=4
   &Version=2014-09-01
   &X-Amz-Algorithm=AWS4-HMAC-SHA256
   &X-Amz-Credential=AKIADQKE4SARGYLE/20140421/us-west-2/rds/aws4_request
   &X-Amz-Date=20140421T194732Z
   &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
   &X-Amz-Signature=4772d17a4c43bcd209ff42a0778dd23e73f8434253effd7ac53b89ade3dad45f

Sample Response


<DescribeDBEngineVersionsResponse xmlns="http://rds.amazonaws.com/doc/2014-09-01/">
  <DescribeDBEngineVersionsResult>
    <DBEngineVersions>
      <DBEngineVersion>
        <Engine>mysql</Engine>
        <DBParameterGroupFamily>mysql5.1</DBParameterGroupFamily>
        <DBEngineDescription>MySQL Community Edition</DBEngineDescription>
        <EngineVersion>5.1.57</EngineVersion>
        <DBEngineVersionDescription>MySQL 5.1.57</DBEngineVersionDescription>
      </DBEngineVersion>
      <DBEngineVersion>
        <Engine>mysql</Engine>
        <DBParameterGroupFamily>mysql5.1</DBParameterGroupFamily>
        <DBEngineDescription>MySQL Community Edition</DBEngineDescription>
        <EngineVersion>5.1.61</EngineVersion>
        <DBEngineVersionDescription>MySQL 5.1.61</DBEngineVersionDescription>
      </DBEngineVersion>
      <DBEngineVersion>
        <Engine>mysql</Engine>
        <DBParameterGroupFamily>mysql5.1</DBParameterGroupFamily>
        <DBEngineDescription>MySQL Community Edition</DBEngineDescription>
        <EngineVersion>5.1.62</EngineVersion>
        <DBEngineVersionDescription>MySQL 5.1.62</DBEngineVersionDescription>
      </DBEngineVersion>
  </DescribeDBEngineVersionsResult>
  <ResponseMetadata>
    <RequestId>b74d2635-b98c-11d3-fbc7-5c0aad74da7c</RequestId>
  </ResponseMetadata>
</DescribeDBEngineVersionsResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: