AWS Classic

Pulumi Official
Package maintained by Pulumi
v5.10.0 published on Monday, Jul 11, 2022 by Pulumi

getEngineVersion

Information about an RDS engine version.

Example Usage

using Pulumi;
using Aws = Pulumi.Aws;

class MyStack : Stack
{
    public MyStack()
    {
        var test = Output.Create(Aws.Rds.GetEngineVersion.InvokeAsync(new Aws.Rds.GetEngineVersionArgs
        {
            Engine = "mysql",
            PreferredVersions = 
            {
                "5.7.42",
                "5.7.19",
                "5.7.17",
            },
        }));
    }

}
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/rds"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := rds.GetEngineVersion(ctx, &rds.GetEngineVersionArgs{
			Engine: "mysql",
			PreferredVersions: []string{
				"5.7.42",
				"5.7.19",
				"5.7.17",
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import java.util.*;
import java.io.*;
import java.nio.*;
import com.pulumi.*;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var test = Output.of(RdsFunctions.getEngineVersion(GetEngineVersionArgs.builder()
            .engine("mysql")
            .preferredVersions(            
                "5.7.42",
                "5.7.19",
                "5.7.17")
            .build()));

    }
}
import pulumi
import pulumi_aws as aws

test = aws.rds.get_engine_version(engine="mysql",
    preferred_versions=[
        "5.7.42",
        "5.7.19",
        "5.7.17",
    ])
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const test = pulumi.output(aws.rds.getEngineVersion({
    engine: "mysql",
    preferredVersions: [
        "5.7.42",
        "5.7.19",
        "5.7.17",
    ],
}));
variables:
  test:
    Fn::Invoke:
      Function: aws:rds:getEngineVersion
      Arguments:
        engine: mysql
        preferredVersions:
          - 5.7.42
          - 5.7.19
          - 5.7.17

Using getEngineVersion

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getEngineVersion(args: GetEngineVersionArgs, opts?: InvokeOptions): Promise<GetEngineVersionResult>
function getEngineVersionOutput(args: GetEngineVersionOutputArgs, opts?: InvokeOptions): Output<GetEngineVersionResult>
def get_engine_version(engine: Optional[str] = None,
                       parameter_group_family: Optional[str] = None,
                       preferred_versions: Optional[Sequence[str]] = None,
                       version: Optional[str] = None,
                       opts: Optional[InvokeOptions] = None) -> GetEngineVersionResult
def get_engine_version_output(engine: Optional[pulumi.Input[str]] = None,
                       parameter_group_family: Optional[pulumi.Input[str]] = None,
                       preferred_versions: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                       version: Optional[pulumi.Input[str]] = None,
                       opts: Optional[InvokeOptions] = None) -> Output[GetEngineVersionResult]
func GetEngineVersion(ctx *Context, args *GetEngineVersionArgs, opts ...InvokeOption) (*GetEngineVersionResult, error)
func GetEngineVersionOutput(ctx *Context, args *GetEngineVersionOutputArgs, opts ...InvokeOption) GetEngineVersionResultOutput

> Note: This function is named GetEngineVersion in the Go SDK.

public static class GetEngineVersion 
{
    public static Task<GetEngineVersionResult> InvokeAsync(GetEngineVersionArgs args, InvokeOptions? opts = null)
    public static Output<GetEngineVersionResult> Invoke(GetEngineVersionInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetEngineVersionResult> getEngineVersion(GetEngineVersionArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
Fn::Invoke:
  Function: aws:rds/getEngineVersion:getEngineVersion
  Arguments:
    # Arguments dictionary

The following arguments are supported:

Engine string

DB engine. Engine values include aurora, aurora-mysql, aurora-postgresql, docdb, mariadb, mysql, neptune, oracle-ee, oracle-se, oracle-se1, oracle-se2, postgres, sqlserver-ee, sqlserver-ex, sqlserver-se, and sqlserver-web.

ParameterGroupFamily string

The name of a specific DB parameter group family. Examples of parameter group families are mysql8.0, mariadb10.4, and postgres12.

PreferredVersions List<string>

Ordered list of preferred engine versions. The first match in this list will be returned. If no preferred matches are found and the original search returned more than one result, an error is returned. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

Version string

Version of the DB engine. For example, 5.7.22, 10.1.34, and 12.3. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

Engine string

DB engine. Engine values include aurora, aurora-mysql, aurora-postgresql, docdb, mariadb, mysql, neptune, oracle-ee, oracle-se, oracle-se1, oracle-se2, postgres, sqlserver-ee, sqlserver-ex, sqlserver-se, and sqlserver-web.

ParameterGroupFamily string

The name of a specific DB parameter group family. Examples of parameter group families are mysql8.0, mariadb10.4, and postgres12.

PreferredVersions []string

Ordered list of preferred engine versions. The first match in this list will be returned. If no preferred matches are found and the original search returned more than one result, an error is returned. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

Version string

Version of the DB engine. For example, 5.7.22, 10.1.34, and 12.3. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

engine String

DB engine. Engine values include aurora, aurora-mysql, aurora-postgresql, docdb, mariadb, mysql, neptune, oracle-ee, oracle-se, oracle-se1, oracle-se2, postgres, sqlserver-ee, sqlserver-ex, sqlserver-se, and sqlserver-web.

parameterGroupFamily String

The name of a specific DB parameter group family. Examples of parameter group families are mysql8.0, mariadb10.4, and postgres12.

preferredVersions List<String>

Ordered list of preferred engine versions. The first match in this list will be returned. If no preferred matches are found and the original search returned more than one result, an error is returned. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

version String

Version of the DB engine. For example, 5.7.22, 10.1.34, and 12.3. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

engine string

DB engine. Engine values include aurora, aurora-mysql, aurora-postgresql, docdb, mariadb, mysql, neptune, oracle-ee, oracle-se, oracle-se1, oracle-se2, postgres, sqlserver-ee, sqlserver-ex, sqlserver-se, and sqlserver-web.

parameterGroupFamily string

The name of a specific DB parameter group family. Examples of parameter group families are mysql8.0, mariadb10.4, and postgres12.

preferredVersions string[]

Ordered list of preferred engine versions. The first match in this list will be returned. If no preferred matches are found and the original search returned more than one result, an error is returned. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

version string

Version of the DB engine. For example, 5.7.22, 10.1.34, and 12.3. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

engine str

DB engine. Engine values include aurora, aurora-mysql, aurora-postgresql, docdb, mariadb, mysql, neptune, oracle-ee, oracle-se, oracle-se1, oracle-se2, postgres, sqlserver-ee, sqlserver-ex, sqlserver-se, and sqlserver-web.

parameter_group_family str

The name of a specific DB parameter group family. Examples of parameter group families are mysql8.0, mariadb10.4, and postgres12.

preferred_versions Sequence[str]

Ordered list of preferred engine versions. The first match in this list will be returned. If no preferred matches are found and the original search returned more than one result, an error is returned. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

version str

Version of the DB engine. For example, 5.7.22, 10.1.34, and 12.3. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

engine String

DB engine. Engine values include aurora, aurora-mysql, aurora-postgresql, docdb, mariadb, mysql, neptune, oracle-ee, oracle-se, oracle-se1, oracle-se2, postgres, sqlserver-ee, sqlserver-ex, sqlserver-se, and sqlserver-web.

parameterGroupFamily String

The name of a specific DB parameter group family. Examples of parameter group families are mysql8.0, mariadb10.4, and postgres12.

preferredVersions List<String>

Ordered list of preferred engine versions. The first match in this list will be returned. If no preferred matches are found and the original search returned more than one result, an error is returned. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

version String

Version of the DB engine. For example, 5.7.22, 10.1.34, and 12.3. If both the version and preferred_versions arguments are not configured, the data source will return the default version for the engine.

getEngineVersion Result

The following output properties are available:

DefaultCharacterSet string

The default character set for new instances of this engine version.

Engine string
EngineDescription string

The description of the database engine.

ExportableLogTypes List<string>

Set of log types that the database engine has available for export to CloudWatch Logs.

Id string

The provider-assigned unique ID for this managed resource.

ParameterGroupFamily string
Status string

The status of the DB engine version, either available or deprecated.

SupportedCharacterSets List<string>

Set of the character sets supported by this engine.

SupportedFeatureNames List<string>

Set of features supported by the DB engine.

SupportedModes List<string>

Set of the supported DB engine modes.

SupportedTimezones List<string>

Set of the time zones supported by this engine.

SupportsGlobalDatabases bool

Indicates whether you can use Aurora global databases with a specific DB engine version.

SupportsLogExportsToCloudwatch bool

Indicates whether the engine version supports exporting the log types specified by exportable_log_types to CloudWatch Logs.

SupportsParallelQuery bool

Indicates whether you can use Aurora parallel query with a specific DB engine version.

SupportsReadReplica bool

Indicates whether the database engine version supports read replicas.

ValidUpgradeTargets List<string>

Set of engine versions that this database engine version can be upgraded to.

Version string
VersionDescription string

The description of the database engine version.

PreferredVersions List<string>
DefaultCharacterSet string

The default character set for new instances of this engine version.

Engine string
EngineDescription string

The description of the database engine.

ExportableLogTypes []string

Set of log types that the database engine has available for export to CloudWatch Logs.

Id string

The provider-assigned unique ID for this managed resource.

ParameterGroupFamily string
Status string

The status of the DB engine version, either available or deprecated.

SupportedCharacterSets []string

Set of the character sets supported by this engine.

SupportedFeatureNames []string

Set of features supported by the DB engine.

SupportedModes []string

Set of the supported DB engine modes.

SupportedTimezones []string

Set of the time zones supported by this engine.

SupportsGlobalDatabases bool

Indicates whether you can use Aurora global databases with a specific DB engine version.

SupportsLogExportsToCloudwatch bool

Indicates whether the engine version supports exporting the log types specified by exportable_log_types to CloudWatch Logs.

SupportsParallelQuery bool

Indicates whether you can use Aurora parallel query with a specific DB engine version.

SupportsReadReplica bool

Indicates whether the database engine version supports read replicas.

ValidUpgradeTargets []string

Set of engine versions that this database engine version can be upgraded to.

Version string
VersionDescription string

The description of the database engine version.

PreferredVersions []string
defaultCharacterSet String

The default character set for new instances of this engine version.

engine String
engineDescription String

The description of the database engine.

exportableLogTypes List<String>

Set of log types that the database engine has available for export to CloudWatch Logs.

id String

The provider-assigned unique ID for this managed resource.

parameterGroupFamily String
status String

The status of the DB engine version, either available or deprecated.

supportedCharacterSets List<String>

Set of the character sets supported by this engine.

supportedFeatureNames List<String>

Set of features supported by the DB engine.

supportedModes List<String>

Set of the supported DB engine modes.

supportedTimezones List<String>

Set of the time zones supported by this engine.

supportsGlobalDatabases Boolean

Indicates whether you can use Aurora global databases with a specific DB engine version.

supportsLogExportsToCloudwatch Boolean

Indicates whether the engine version supports exporting the log types specified by exportable_log_types to CloudWatch Logs.

supportsParallelQuery Boolean

Indicates whether you can use Aurora parallel query with a specific DB engine version.

supportsReadReplica Boolean

Indicates whether the database engine version supports read replicas.

validUpgradeTargets List<String>

Set of engine versions that this database engine version can be upgraded to.

version String
versionDescription String

The description of the database engine version.

preferredVersions List<String>
defaultCharacterSet string

The default character set for new instances of this engine version.

engine string
engineDescription string

The description of the database engine.

exportableLogTypes string[]

Set of log types that the database engine has available for export to CloudWatch Logs.

id string

The provider-assigned unique ID for this managed resource.

parameterGroupFamily string
status string

The status of the DB engine version, either available or deprecated.

supportedCharacterSets string[]

Set of the character sets supported by this engine.

supportedFeatureNames string[]

Set of features supported by the DB engine.

supportedModes string[]

Set of the supported DB engine modes.

supportedTimezones string[]

Set of the time zones supported by this engine.

supportsGlobalDatabases boolean

Indicates whether you can use Aurora global databases with a specific DB engine version.

supportsLogExportsToCloudwatch boolean

Indicates whether the engine version supports exporting the log types specified by exportable_log_types to CloudWatch Logs.

supportsParallelQuery boolean

Indicates whether you can use Aurora parallel query with a specific DB engine version.

supportsReadReplica boolean

Indicates whether the database engine version supports read replicas.

validUpgradeTargets string[]

Set of engine versions that this database engine version can be upgraded to.

version string
versionDescription string

The description of the database engine version.

preferredVersions string[]
default_character_set str

The default character set for new instances of this engine version.

engine str
engine_description str

The description of the database engine.

exportable_log_types Sequence[str]

Set of log types that the database engine has available for export to CloudWatch Logs.

id str

The provider-assigned unique ID for this managed resource.

parameter_group_family str
status str

The status of the DB engine version, either available or deprecated.

supported_character_sets Sequence[str]

Set of the character sets supported by this engine.

supported_feature_names Sequence[str]

Set of features supported by the DB engine.

supported_modes Sequence[str]

Set of the supported DB engine modes.

supported_timezones Sequence[str]

Set of the time zones supported by this engine.

supports_global_databases bool

Indicates whether you can use Aurora global databases with a specific DB engine version.

supports_log_exports_to_cloudwatch bool

Indicates whether the engine version supports exporting the log types specified by exportable_log_types to CloudWatch Logs.

supports_parallel_query bool

Indicates whether you can use Aurora parallel query with a specific DB engine version.

supports_read_replica bool

Indicates whether the database engine version supports read replicas.

valid_upgrade_targets Sequence[str]

Set of engine versions that this database engine version can be upgraded to.

version str
version_description str

The description of the database engine version.

preferred_versions Sequence[str]
defaultCharacterSet String

The default character set for new instances of this engine version.

engine String
engineDescription String

The description of the database engine.

exportableLogTypes List<String>

Set of log types that the database engine has available for export to CloudWatch Logs.

id String

The provider-assigned unique ID for this managed resource.

parameterGroupFamily String
status String

The status of the DB engine version, either available or deprecated.

supportedCharacterSets List<String>

Set of the character sets supported by this engine.

supportedFeatureNames List<String>

Set of features supported by the DB engine.

supportedModes List<String>

Set of the supported DB engine modes.

supportedTimezones List<String>

Set of the time zones supported by this engine.

supportsGlobalDatabases Boolean

Indicates whether you can use Aurora global databases with a specific DB engine version.

supportsLogExportsToCloudwatch Boolean

Indicates whether the engine version supports exporting the log types specified by exportable_log_types to CloudWatch Logs.

supportsParallelQuery Boolean

Indicates whether you can use Aurora parallel query with a specific DB engine version.

supportsReadReplica Boolean

Indicates whether the database engine version supports read replicas.

validUpgradeTargets List<String>

Set of engine versions that this database engine version can be upgraded to.

version String
versionDescription String

The description of the database engine version.

preferredVersions List<String>

Package Details

Repository
https://github.com/pulumi/pulumi-aws
License
Apache-2.0
Notes

This Pulumi package is based on the aws Terraform Provider.