aws.neptune.getEngineVersion
Explore with Pulumi AI
Information about a Neptune engine version.
Note: If AWS returns multiple matching engine versions, this data source will produce a
multiple Neptune engine versions
error. To avoid this, provide additional criteria to narrow the results or use thelatest
argument to select a single version. See the Argument Reference for details.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const test = aws.neptune.getEngineVersion({
preferredVersions: [
"1.4.5.0",
"1.4.4.0",
"1.4.3.0",
],
});
import pulumi
import pulumi_aws as aws
test = aws.neptune.get_engine_version(preferred_versions=[
"1.4.5.0",
"1.4.4.0",
"1.4.3.0",
])
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/neptune"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := neptune.GetEngineVersion(ctx, &neptune.GetEngineVersionArgs{
PreferredVersions: []string{
"1.4.5.0",
"1.4.4.0",
"1.4.3.0",
},
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var test = Aws.Neptune.GetEngineVersion.Invoke(new()
{
PreferredVersions = new[]
{
"1.4.5.0",
"1.4.4.0",
"1.4.3.0",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.neptune.NeptuneFunctions;
import com.pulumi.aws.neptune.inputs.GetEngineVersionArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var test = NeptuneFunctions.getEngineVersion(GetEngineVersionArgs.builder()
.preferredVersions(
"1.4.5.0",
"1.4.4.0",
"1.4.3.0")
.build());
}
}
variables:
test:
fn::invoke:
function: aws:neptune:getEngineVersion
arguments:
preferredVersions:
- 1.4.5.0
- 1.4.4.0
- 1.4.3.0
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(default_only: Optional[bool] = None,
engine: Optional[str] = None,
has_major_target: Optional[bool] = None,
has_minor_target: Optional[bool] = None,
latest: Optional[bool] = None,
parameter_group_family: Optional[str] = None,
preferred_major_targets: Optional[Sequence[str]] = None,
preferred_upgrade_targets: Optional[Sequence[str]] = None,
preferred_versions: Optional[Sequence[str]] = None,
version: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetEngineVersionResult
def get_engine_version_output(default_only: Optional[pulumi.Input[bool]] = None,
engine: Optional[pulumi.Input[str]] = None,
has_major_target: Optional[pulumi.Input[bool]] = None,
has_minor_target: Optional[pulumi.Input[bool]] = None,
latest: Optional[pulumi.Input[bool]] = None,
parameter_group_family: Optional[pulumi.Input[str]] = None,
preferred_major_targets: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
preferred_upgrade_targets: Optional[pulumi.Input[Sequence[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)
public static Output<GetEngineVersionResult> getEngineVersion(GetEngineVersionArgs args, InvokeOptions options)
fn::invoke:
function: aws:neptune/getEngineVersion:getEngineVersion
arguments:
# arguments dictionary
The following arguments are supported:
- Default
Only bool - Whether to return only default engine versions that match all other criteria. AWS may define multiple default versions for a given engine, so using
default_only
alone does not guarantee that only one version will be returned. To ensure a single version is selected, consider combining this withlatest
. Note that default versions are defined by AWS and may not reflect the most recent engine version available. - Engine string
- DB engine. Must be
neptune
. Default isneptune
. - Has
Major boolTarget - Whether to filter for engine versions that have a major target.
- Has
Minor boolTarget - Whether to filter for engine versions that have a minor target.
- Latest bool
- Whether to return only the latest engine version that matches all other criteria. This differs from
default_only
: AWS may define multiple defaults, and the latest version is not always marked as the default. As a result,default_only
may still return multiple versions, whilelatest
selects a single version. The two options can be used together. Note: This argument uses a best-effort approach. Because AWS does not consistently provide version dates or standardized identifiers, the result may not always reflect the true latest version. - Parameter
Group stringFamily - Name of a specific DB parameter group family. An example parameter group family is
neptune1.4
. For some versions, if this is provided, AWS returns no results. - Preferred
Major List<string>Targets - Ordered list of preferred major engine versions.
- Preferred
Upgrade List<string>Targets - Ordered list of preferred upgrade engine versions.
- Preferred
Versions 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
andpreferred_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,
1.0.1.0
,1.0.2.2
, and1.0.3.0
. If both theversion
andpreferred_versions
arguments are not configured, the data source will return the default version for the engine.
- Default
Only bool - Whether to return only default engine versions that match all other criteria. AWS may define multiple default versions for a given engine, so using
default_only
alone does not guarantee that only one version will be returned. To ensure a single version is selected, consider combining this withlatest
. Note that default versions are defined by AWS and may not reflect the most recent engine version available. - Engine string
- DB engine. Must be
neptune
. Default isneptune
. - Has
Major boolTarget - Whether to filter for engine versions that have a major target.
- Has
Minor boolTarget - Whether to filter for engine versions that have a minor target.
- Latest bool
- Whether to return only the latest engine version that matches all other criteria. This differs from
default_only
: AWS may define multiple defaults, and the latest version is not always marked as the default. As a result,default_only
may still return multiple versions, whilelatest
selects a single version. The two options can be used together. Note: This argument uses a best-effort approach. Because AWS does not consistently provide version dates or standardized identifiers, the result may not always reflect the true latest version. - Parameter
Group stringFamily - Name of a specific DB parameter group family. An example parameter group family is
neptune1.4
. For some versions, if this is provided, AWS returns no results. - Preferred
Major []stringTargets - Ordered list of preferred major engine versions.
- Preferred
Upgrade []stringTargets - Ordered list of preferred upgrade engine versions.
- Preferred
Versions []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
andpreferred_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,
1.0.1.0
,1.0.2.2
, and1.0.3.0
. If both theversion
andpreferred_versions
arguments are not configured, the data source will return the default version for the engine.
- default
Only Boolean - Whether to return only default engine versions that match all other criteria. AWS may define multiple default versions for a given engine, so using
default_only
alone does not guarantee that only one version will be returned. To ensure a single version is selected, consider combining this withlatest
. Note that default versions are defined by AWS and may not reflect the most recent engine version available. - engine String
- DB engine. Must be
neptune
. Default isneptune
. - has
Major BooleanTarget - Whether to filter for engine versions that have a major target.
- has
Minor BooleanTarget - Whether to filter for engine versions that have a minor target.
- latest Boolean
- Whether to return only the latest engine version that matches all other criteria. This differs from
default_only
: AWS may define multiple defaults, and the latest version is not always marked as the default. As a result,default_only
may still return multiple versions, whilelatest
selects a single version. The two options can be used together. Note: This argument uses a best-effort approach. Because AWS does not consistently provide version dates or standardized identifiers, the result may not always reflect the true latest version. - parameter
Group StringFamily - Name of a specific DB parameter group family. An example parameter group family is
neptune1.4
. For some versions, if this is provided, AWS returns no results. - preferred
Major List<String>Targets - Ordered list of preferred major engine versions.
- preferred
Upgrade List<String>Targets - Ordered list of preferred upgrade engine versions.
- preferred
Versions 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
andpreferred_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,
1.0.1.0
,1.0.2.2
, and1.0.3.0
. If both theversion
andpreferred_versions
arguments are not configured, the data source will return the default version for the engine.
- default
Only boolean - Whether to return only default engine versions that match all other criteria. AWS may define multiple default versions for a given engine, so using
default_only
alone does not guarantee that only one version will be returned. To ensure a single version is selected, consider combining this withlatest
. Note that default versions are defined by AWS and may not reflect the most recent engine version available. - engine string
- DB engine. Must be
neptune
. Default isneptune
. - has
Major booleanTarget - Whether to filter for engine versions that have a major target.
- has
Minor booleanTarget - Whether to filter for engine versions that have a minor target.
- latest boolean
- Whether to return only the latest engine version that matches all other criteria. This differs from
default_only
: AWS may define multiple defaults, and the latest version is not always marked as the default. As a result,default_only
may still return multiple versions, whilelatest
selects a single version. The two options can be used together. Note: This argument uses a best-effort approach. Because AWS does not consistently provide version dates or standardized identifiers, the result may not always reflect the true latest version. - parameter
Group stringFamily - Name of a specific DB parameter group family. An example parameter group family is
neptune1.4
. For some versions, if this is provided, AWS returns no results. - preferred
Major string[]Targets - Ordered list of preferred major engine versions.
- preferred
Upgrade string[]Targets - Ordered list of preferred upgrade engine versions.
- preferred
Versions 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
andpreferred_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,
1.0.1.0
,1.0.2.2
, and1.0.3.0
. If both theversion
andpreferred_versions
arguments are not configured, the data source will return the default version for the engine.
- default_
only bool - Whether to return only default engine versions that match all other criteria. AWS may define multiple default versions for a given engine, so using
default_only
alone does not guarantee that only one version will be returned. To ensure a single version is selected, consider combining this withlatest
. Note that default versions are defined by AWS and may not reflect the most recent engine version available. - engine str
- DB engine. Must be
neptune
. Default isneptune
. - has_
major_ booltarget - Whether to filter for engine versions that have a major target.
- has_
minor_ booltarget - Whether to filter for engine versions that have a minor target.
- latest bool
- Whether to return only the latest engine version that matches all other criteria. This differs from
default_only
: AWS may define multiple defaults, and the latest version is not always marked as the default. As a result,default_only
may still return multiple versions, whilelatest
selects a single version. The two options can be used together. Note: This argument uses a best-effort approach. Because AWS does not consistently provide version dates or standardized identifiers, the result may not always reflect the true latest version. - parameter_
group_ strfamily - Name of a specific DB parameter group family. An example parameter group family is
neptune1.4
. For some versions, if this is provided, AWS returns no results. - preferred_
major_ Sequence[str]targets - Ordered list of preferred major engine versions.
- preferred_
upgrade_ Sequence[str]targets - Ordered list of preferred upgrade engine versions.
- 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
andpreferred_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,
1.0.1.0
,1.0.2.2
, and1.0.3.0
. If both theversion
andpreferred_versions
arguments are not configured, the data source will return the default version for the engine.
- default
Only Boolean - Whether to return only default engine versions that match all other criteria. AWS may define multiple default versions for a given engine, so using
default_only
alone does not guarantee that only one version will be returned. To ensure a single version is selected, consider combining this withlatest
. Note that default versions are defined by AWS and may not reflect the most recent engine version available. - engine String
- DB engine. Must be
neptune
. Default isneptune
. - has
Major BooleanTarget - Whether to filter for engine versions that have a major target.
- has
Minor BooleanTarget - Whether to filter for engine versions that have a minor target.
- latest Boolean
- Whether to return only the latest engine version that matches all other criteria. This differs from
default_only
: AWS may define multiple defaults, and the latest version is not always marked as the default. As a result,default_only
may still return multiple versions, whilelatest
selects a single version. The two options can be used together. Note: This argument uses a best-effort approach. Because AWS does not consistently provide version dates or standardized identifiers, the result may not always reflect the true latest version. - parameter
Group StringFamily - Name of a specific DB parameter group family. An example parameter group family is
neptune1.4
. For some versions, if this is provided, AWS returns no results. - preferred
Major List<String>Targets - Ordered list of preferred major engine versions.
- preferred
Upgrade List<String>Targets - Ordered list of preferred upgrade engine versions.
- preferred
Versions 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
andpreferred_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,
1.0.1.0
,1.0.2.2
, and1.0.3.0
. If both theversion
andpreferred_versions
arguments are not configured, the data source will return the default version for the engine.
getEngineVersion Result
The following output properties are available:
- Default
Character stringSet - Default character set for the engine version.
- Engine
Description string - Description of the database engine.
- Exportable
Log List<string>Types - 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.
- Parameter
Group stringFamily - Supported
Character List<string>Sets - Set of character sets supported by this engine version.
- Supported
Timezones List<string> - Set of time zones supported by this engine.
- Supports
Global boolDatabases - Whether the engine version supports global databases.
- Supports
Log boolExports To Cloudwatch - Whether the engine version supports exporting the log types specified by
exportable_log_types
to CloudWatch Logs. - Supports
Read boolReplica - Whether the database engine version supports read replicas.
- Valid
Major List<string>Targets - Set of valid major engine versions that this version can be upgraded to.
- Valid
Minor List<string>Targets - Set of valid minor engine versions that this version can be upgraded to.
- Valid
Upgrade List<string>Targets - Set of engine versions that this database engine version can be upgraded to.
- Version string
- Version
Actual string - Actual engine version returned by the API.
- Version
Description string - Description of the database engine version.
- Default
Only bool - Engine string
- Has
Major boolTarget - Has
Minor boolTarget - Latest bool
- Preferred
Major List<string>Targets - Preferred
Upgrade List<string>Targets - Preferred
Versions List<string>
- Default
Character stringSet - Default character set for the engine version.
- Engine
Description string - Description of the database engine.
- Exportable
Log []stringTypes - 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.
- Parameter
Group stringFamily - Supported
Character []stringSets - Set of character sets supported by this engine version.
- Supported
Timezones []string - Set of time zones supported by this engine.
- Supports
Global boolDatabases - Whether the engine version supports global databases.
- Supports
Log boolExports To Cloudwatch - Whether the engine version supports exporting the log types specified by
exportable_log_types
to CloudWatch Logs. - Supports
Read boolReplica - Whether the database engine version supports read replicas.
- Valid
Major []stringTargets - Set of valid major engine versions that this version can be upgraded to.
- Valid
Minor []stringTargets - Set of valid minor engine versions that this version can be upgraded to.
- Valid
Upgrade []stringTargets - Set of engine versions that this database engine version can be upgraded to.
- Version string
- Version
Actual string - Actual engine version returned by the API.
- Version
Description string - Description of the database engine version.
- Default
Only bool - Engine string
- Has
Major boolTarget - Has
Minor boolTarget - Latest bool
- Preferred
Major []stringTargets - Preferred
Upgrade []stringTargets - Preferred
Versions []string
- default
Character StringSet - Default character set for the engine version.
- engine
Description String - Description of the database engine.
- exportable
Log List<String>Types - 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.
- parameter
Group StringFamily - supported
Character List<String>Sets - Set of character sets supported by this engine version.
- supported
Timezones List<String> - Set of time zones supported by this engine.
- supports
Global BooleanDatabases - Whether the engine version supports global databases.
- supports
Log BooleanExports To Cloudwatch - Whether the engine version supports exporting the log types specified by
exportable_log_types
to CloudWatch Logs. - supports
Read BooleanReplica - Whether the database engine version supports read replicas.
- valid
Major List<String>Targets - Set of valid major engine versions that this version can be upgraded to.
- valid
Minor List<String>Targets - Set of valid minor engine versions that this version can be upgraded to.
- valid
Upgrade List<String>Targets - Set of engine versions that this database engine version can be upgraded to.
- version String
- version
Actual String - Actual engine version returned by the API.
- version
Description String - Description of the database engine version.
- default
Only Boolean - engine String
- has
Major BooleanTarget - has
Minor BooleanTarget - latest Boolean
- preferred
Major List<String>Targets - preferred
Upgrade List<String>Targets - preferred
Versions List<String>
- default
Character stringSet - Default character set for the engine version.
- engine
Description string - Description of the database engine.
- exportable
Log string[]Types - 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.
- parameter
Group stringFamily - supported
Character string[]Sets - Set of character sets supported by this engine version.
- supported
Timezones string[] - Set of time zones supported by this engine.
- supports
Global booleanDatabases - Whether the engine version supports global databases.
- supports
Log booleanExports To Cloudwatch - Whether the engine version supports exporting the log types specified by
exportable_log_types
to CloudWatch Logs. - supports
Read booleanReplica - Whether the database engine version supports read replicas.
- valid
Major string[]Targets - Set of valid major engine versions that this version can be upgraded to.
- valid
Minor string[]Targets - Set of valid minor engine versions that this version can be upgraded to.
- valid
Upgrade string[]Targets - Set of engine versions that this database engine version can be upgraded to.
- version string
- version
Actual string - Actual engine version returned by the API.
- version
Description string - Description of the database engine version.
- default
Only boolean - engine string
- has
Major booleanTarget - has
Minor booleanTarget - latest boolean
- preferred
Major string[]Targets - preferred
Upgrade string[]Targets - preferred
Versions string[]
- default_
character_ strset - Default character set for the engine version.
- engine_
description str - Description of the database engine.
- exportable_
log_ Sequence[str]types - 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_ strfamily - supported_
character_ Sequence[str]sets - Set of character sets supported by this engine version.
- supported_
timezones Sequence[str] - Set of time zones supported by this engine.
- supports_
global_ booldatabases - Whether the engine version supports global databases.
- supports_
log_ boolexports_ to_ cloudwatch - Whether the engine version supports exporting the log types specified by
exportable_log_types
to CloudWatch Logs. - supports_
read_ boolreplica - Whether the database engine version supports read replicas.
- valid_
major_ Sequence[str]targets - Set of valid major engine versions that this version can be upgraded to.
- valid_
minor_ Sequence[str]targets - Set of valid minor engine versions that this version can be upgraded to.
- valid_
upgrade_ Sequence[str]targets - Set of engine versions that this database engine version can be upgraded to.
- version str
- version_
actual str - Actual engine version returned by the API.
- version_
description str - Description of the database engine version.
- default_
only bool - engine str
- has_
major_ booltarget - has_
minor_ booltarget - latest bool
- preferred_
major_ Sequence[str]targets - preferred_
upgrade_ Sequence[str]targets - preferred_
versions Sequence[str]
- default
Character StringSet - Default character set for the engine version.
- engine
Description String - Description of the database engine.
- exportable
Log List<String>Types - 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.
- parameter
Group StringFamily - supported
Character List<String>Sets - Set of character sets supported by this engine version.
- supported
Timezones List<String> - Set of time zones supported by this engine.
- supports
Global BooleanDatabases - Whether the engine version supports global databases.
- supports
Log BooleanExports To Cloudwatch - Whether the engine version supports exporting the log types specified by
exportable_log_types
to CloudWatch Logs. - supports
Read BooleanReplica - Whether the database engine version supports read replicas.
- valid
Major List<String>Targets - Set of valid major engine versions that this version can be upgraded to.
- valid
Minor List<String>Targets - Set of valid minor engine versions that this version can be upgraded to.
- valid
Upgrade List<String>Targets - Set of engine versions that this database engine version can be upgraded to.
- version String
- version
Actual String - Actual engine version returned by the API.
- version
Description String - Description of the database engine version.
- default
Only Boolean - engine String
- has
Major BooleanTarget - has
Minor BooleanTarget - latest Boolean
- preferred
Major List<String>Targets - preferred
Upgrade List<String>Targets - preferred
Versions List<String>
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
aws
Terraform Provider.