RDS.Paginator.DescribeDBEngineVersions¶paginator = client.get_paginator('describe_db_engine_versions')
paginate(**kwargs)¶Creates an iterator that will paginate through responses from RDS.Client.describe_db_engine_versions().
See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate(
Engine='string',
EngineVersion='string',
DBParameterGroupFamily='string',
Filters=[
{
'Name': 'string',
'Values': [
'string',
]
},
],
DefaultOnly=True|False,
ListSupportedCharacterSets=True|False,
ListSupportedTimezones=True|False,
IncludeAll=True|False,
PaginationConfig={
'MaxItems': 123,
'PageSize': 123,
'StartingToken': 'string'
}
)
The database engine to return.
Valid Values:
aurora (for MySQL 5.6-compatible Aurora)aurora-mysql (for MySQL 5.7-compatible and MySQL 8.0-compatible Aurora)aurora-postgresqlmariadbmysqloracle-eeoracle-ee-cdboracle-se2oracle-se2-cdbpostgressqlserver-eesqlserver-sesqlserver-exsqlserver-webThe database engine version to return.
Example: 5.1.49
The name of a specific DB parameter group family to return details for.
Constraints:
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:globalmultimasterparallelqueryprovisionedserverlessengine-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:availabledeprecatedA filter name and value pair that is used to return a more specific list of results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as IDs. The filters supported by a describe operation are documented with the describe operation.
Note
Currently, wildcards are not supported in filters.
The following actions can be filtered:
DescribeDBClusterBacktracksDescribeDBClusterEndpointsDescribeDBClustersDescribeDBInstancesDescribePendingMaintenanceActionsThe name of the filter. Filter names are case-sensitive.
One or more filter values. Filter values are case-sensitive.
A value that indicates 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 set ListSupportedCharacterSets to true , RDS Custom returns no results.
A value that indicates 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 set ListSupportedTimezones to true , RDS Custom returns no results.
A dictionary that provides parameters to control pagination.
The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
The size of each page.
A token to specify where to start paginating. This is the NextToken from a previous response.
dict
Response Syntax
{
'DBEngineVersions': [
{
'Engine': 'string',
'EngineVersion': 'string',
'DBParameterGroupFamily': 'string',
'DBEngineDescription': 'string',
'DBEngineVersionDescription': 'string',
'DefaultCharacterSet': {
'CharacterSetName': 'string',
'CharacterSetDescription': 'string'
},
'Image': {
'ImageId': 'string',
'Status': 'string'
},
'DBEngineMediaType': 'string',
'SupportedCharacterSets': [
{
'CharacterSetName': 'string',
'CharacterSetDescription': 'string'
},
],
'SupportedNcharCharacterSets': [
{
'CharacterSetName': 'string',
'CharacterSetDescription': 'string'
},
],
'ValidUpgradeTarget': [
{
'Engine': 'string',
'EngineVersion': 'string',
'Description': 'string',
'AutoUpgrade': True|False,
'IsMajorVersionUpgrade': True|False,
'SupportedEngineModes': [
'string',
],
'SupportsParallelQuery': True|False,
'SupportsGlobalDatabases': True|False,
'SupportsBabelfish': True|False
},
],
'SupportedTimezones': [
{
'TimezoneName': 'string'
},
],
'ExportableLogTypes': [
'string',
],
'SupportsLogExportsToCloudwatchLogs': True|False,
'SupportsReadReplica': True|False,
'SupportedEngineModes': [
'string',
],
'SupportedFeatureNames': [
'string',
],
'Status': 'string',
'SupportsParallelQuery': True|False,
'SupportsGlobalDatabases': True|False,
'MajorEngineVersion': 'string',
'DatabaseInstallationFilesS3BucketName': 'string',
'DatabaseInstallationFilesS3Prefix': 'string',
'DBEngineVersionArn': 'string',
'KMSKeyId': 'string',
'CreateTime': datetime(2015, 1, 1),
'TagList': [
{
'Key': 'string',
'Value': 'string'
},
],
'SupportsBabelfish': True|False,
'CustomDBEngineVersionManifest': 'string',
'SupportsCertificateRotationWithoutRestart': True|False,
'SupportedCACertificateIdentifiers': [
'string',
]
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Contains the result of a successful invocation of the DescribeDBEngineVersions action.
DBEngineVersions (list) --
A list of DBEngineVersion elements.
(dict) --
This data type is used as a response element in the action DescribeDBEngineVersions .
Engine (string) --
The name of the database engine.
EngineVersion (string) --
The version number of the database engine.
DBParameterGroupFamily (string) --
The name of the DB parameter group family for the database engine.
DBEngineDescription (string) --
The description of the database engine.
DBEngineVersionDescription (string) --
The description of the database engine version.
DefaultCharacterSet (dict) --
The default character set for new instances of this engine version, if the CharacterSetName parameter of the CreateDBInstance API isn't specified.
CharacterSetName (string) --
The name of the character set.
CharacterSetDescription (string) --
The description of the character set.
Image (dict) --
The EC2 image
ImageId (string) --
A value that indicates the ID of the AMI.
Status (string) --
A value that indicates the status of a custom engine version (CEV).
DBEngineMediaType (string) --
A value that indicates the source media provider of the AMI based on the usage operation. Applicable for RDS Custom for SQL Server.
SupportedCharacterSets (list) --
A list of the character sets supported by this engine for the CharacterSetName parameter of the CreateDBInstance operation.
(dict) --
This data type is used as a response element in the action DescribeDBEngineVersions .
CharacterSetName (string) --
The name of the character set.
CharacterSetDescription (string) --
The description of the character set.
SupportedNcharCharacterSets (list) --
A list of the character sets supported by the Oracle DB engine for the NcharCharacterSetName parameter of the CreateDBInstance operation.
(dict) --
This data type is used as a response element in the action DescribeDBEngineVersions .
CharacterSetName (string) --
The name of the character set.
CharacterSetDescription (string) --
The description of the character set.
ValidUpgradeTarget (list) --
A list of engine versions that this database engine version can be upgraded to.
(dict) --
The version of the database engine that a DB instance can be upgraded to.
Engine (string) --
The name of the upgrade target database engine.
EngineVersion (string) --
The version number of the upgrade target database engine.
Description (string) --
The version of the database engine that a DB instance can be upgraded to.
AutoUpgrade (boolean) --
A value that indicates whether the target version is applied to any source DB instances that have AutoMinorVersionUpgrade set to true.
IsMajorVersionUpgrade (boolean) --
A value that indicates whether upgrading to the target version requires upgrading the major version of the database engine.
SupportedEngineModes (list) --
A list of the supported DB engine modes for the target engine version.
SupportsParallelQuery (boolean) --
A value that indicates whether you can use Aurora parallel query with the target engine version.
SupportsGlobalDatabases (boolean) --
A value that indicates whether you can use Aurora global databases with the target engine version.
SupportsBabelfish (boolean) --
A value that indicates whether you can use Babelfish for Aurora PostgreSQL with the target engine version.
SupportedTimezones (list) --
A list of the time zones supported by this engine for the Timezone parameter of the CreateDBInstance action.
(dict) --
A time zone associated with a DBInstance or a DBSnapshot . This data type is an element in the response to the DescribeDBInstances , the DescribeDBSnapshots , and the DescribeDBEngineVersions actions.
TimezoneName (string) --
The name of the time zone.
ExportableLogTypes (list) --
The types of logs that the database engine has available for export to CloudWatch Logs.
SupportsLogExportsToCloudwatchLogs (boolean) --
A value that indicates whether the engine version supports exporting the log types specified by ExportableLogTypes to CloudWatch Logs.
SupportsReadReplica (boolean) --
Indicates whether the database engine version supports read replicas.
SupportedEngineModes (list) --
A list of the supported DB engine modes.
SupportedFeatureNames (list) --
A list of features supported by the DB engine.
The supported features vary by DB engine and DB engine version.
To determine the supported features for a specific DB engine and DB engine version using the CLI, use the following command:
aws rds describe-db-engine-versions --engine <engine_name> --engine-version <engine_version>
For example, to determine the supported features for RDS for PostgreSQL version 13.3 using the CLI, use the following command:
aws rds describe-db-engine-versions --engine postgres --engine-version 13.3
The supported features are listed under SupportedFeatureNames in the output.
Status (string) --
The status of the DB engine version, either available or deprecated .
SupportsParallelQuery (boolean) --
A value that indicates whether you can use Aurora parallel query with a specific DB engine version.
SupportsGlobalDatabases (boolean) --
A value that indicates whether you can use Aurora global databases with a specific DB engine version.
MajorEngineVersion (string) --
The major engine version of the CEV.
DatabaseInstallationFilesS3BucketName (string) --
The name of the Amazon S3 bucket that contains your database installation files.
DatabaseInstallationFilesS3Prefix (string) --
The Amazon S3 directory that contains the database installation files. If not specified, then no prefix is assumed.
DBEngineVersionArn (string) --
The ARN of the custom engine version.
KMSKeyId (string) --
The Amazon Web Services KMS key identifier for an encrypted CEV. This parameter is required for RDS Custom, but optional for Amazon RDS.
CreateTime (datetime) --
The creation time of the DB engine version.
TagList (list) --
A list of tags. For more information, see Tagging Amazon RDS Resources in the Amazon RDS User Guide.
(dict) --
Metadata assigned to an Amazon RDS resource consisting of a key-value pair.
For more information, see Tagging Amazon RDS Resources in the Amazon RDS User Guide.
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 can't be prefixed with aws: or rds: . The string can 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 can't be prefixed with aws: or rds: . The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: "^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$").
SupportsBabelfish (boolean) --
A value that indicates whether the engine version supports Babelfish for Aurora PostgreSQL.
CustomDBEngineVersionManifest (string) --
JSON string that lists the installation files and parameters that RDS Custom uses to create a custom engine version (CEV). RDS Custom applies the patches in the order in which they're listed in the manifest. You can set the Oracle home, Oracle base, and UNIX/Linux user and group using the installation parameters. For more information, see JSON fields in the CEV manifest in the Amazon RDS User Guide .
SupportsCertificateRotationWithoutRestart (boolean) --
A value that indicates whether the engine version supports rotating the server certificate without rebooting the DB instance.
SupportedCACertificateIdentifiers (list) --
A list of the supported CA certificate identifiers.
For more information, see Using SSL/TLS to encrypt a connection to a DB instance in the Amazon RDS User Guide and Using SSL/TLS to encrypt a connection to a DB cluster in the Amazon Aurora User Guide .
NextToken (string) --
A token to resume pagination.