pulumi-aws-kotlin/com.pulumi.aws.rds.kotlin/CustomDbEngineVersionArgs

CustomDbEngineVersionArgs

data class CustomDbEngineVersionArgs(val databaseInstallationFilesS3BucketName: Output<String>? = null, val databaseInstallationFilesS3Prefix: Output<String>? = null, val description: Output<String>? = null, val engine: Output<String>? = null, val engineVersion: Output<String>? = null, val filename: Output<String>? = null, val kmsKeyId: Output<String>? = null, val manifest: Output<String>? = null, val manifestHash: Output<String>? = null, val sourceImageId: Output<String>? = null, val status: Output<String>? = null, val tags: Output<Map<String, String>>? = null) : ConvertibleToJava<CustomDbEngineVersionArgs>

Provides an custom engine version (CEV) resource for Amazon RDS Custom. For additional information, see Working with CEVs for RDS Custom for Oracle and Working with CEVs for RDS Custom for SQL Server in the the RDS User Guide.

Example Usage

RDS Custom for Oracle Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.kms.Key;
import com.pulumi.aws.kms.KeyArgs;
import com.pulumi.aws.rds.CustomDbEngineVersion;
import com.pulumi.aws.rds.CustomDbEngineVersionArgs;
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) {
        var exampleKey = new Key("exampleKey", KeyArgs.builder()
            .description("KMS symmetric key for RDS Custom for Oracle")
            .build());
        var exampleCustomDbEngineVersion = new CustomDbEngineVersion("exampleCustomDbEngineVersion", CustomDbEngineVersionArgs.builder()
            .databaseInstallationFilesS3BucketName("DOC-EXAMPLE-BUCKET")
            .databaseInstallationFilesS3Prefix("1915_GI/")
            .engine("custom-oracle-ee-cdb")
            .engineVersion("19.cdb_cev1")
            .kmsKeyId(exampleKey.arn())
            .manifest("""
  {
	"databaseInstallationFileNames":["V982063-01.zip"]
  }
            """)
            .tags(Map.ofEntries(
                Map.entry("Name", "example"),
                Map.entry("Key", "value")
            ))
            .build());
    }
}
Content copied to clipboard

RDS Custom for Oracle External Manifest Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.kms.Key;
import com.pulumi.aws.kms.KeyArgs;
import com.pulumi.aws.rds.CustomDbEngineVersion;
import com.pulumi.aws.rds.CustomDbEngineVersionArgs;
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) {
        var exampleKey = new Key("exampleKey", KeyArgs.builder()
            .description("KMS symmetric key for RDS Custom for Oracle")
            .build());
        var exampleCustomDbEngineVersion = new CustomDbEngineVersion("exampleCustomDbEngineVersion", CustomDbEngineVersionArgs.builder()
            .databaseInstallationFilesS3BucketName("DOC-EXAMPLE-BUCKET")
            .databaseInstallationFilesS3Prefix("1915_GI/")
            .engine("custom-oracle-ee-cdb")
            .engineVersion("19.cdb_cev1")
            .kmsKeyId(exampleKey.arn())
            .filename("manifest_1915_GI.json")
            .manifestHash(computeFileBase64Sha256(manifest_1915_GI.json()))
            .tags(Map.ofEntries(
                Map.entry("Name", "example"),
                Map.entry("Key", "value")
            ))
            .build());
    }
}
Content copied to clipboard

RDS Custom for SQL Server Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.rds.CustomDbEngineVersion;
import com.pulumi.aws.rds.CustomDbEngineVersionArgs;
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) {
        var test = new CustomDbEngineVersion("test", CustomDbEngineVersionArgs.builder()
            .engine("custom-sqlserver-se")
            .engineVersion("15.00.4249.2.cev-1")
            .sourceImageId("ami-0aa12345678a12ab1")
            .build());
    }
}
Content copied to clipboard

RDS Custom for SQL Server Usage with AMI from another region

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.AmiCopy;
import com.pulumi.aws.ec2.AmiCopyArgs;
import com.pulumi.aws.rds.CustomDbEngineVersion;
import com.pulumi.aws.rds.CustomDbEngineVersionArgs;
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) {
        var example = new AmiCopy("example", AmiCopyArgs.builder()
            .description("A copy of ami-xxxxxxxx")
            .sourceAmiId("ami-xxxxxxxx")
            .sourceAmiRegion("us-east-1")
            .build());
        var test = new CustomDbEngineVersion("test", CustomDbEngineVersionArgs.builder()
            .engine("custom-sqlserver-se")
            .engineVersion("15.00.4249.2.cev-1")
            .sourceImageId(example.id())
            .build());
    }
}
Content copied to clipboard

Import

Using pulumi import, import custom engine versions for Amazon RDS custom using the engine and engine_version separated by a colon (:). For example:

$ pulumi import aws:rds/customDbEngineVersion:CustomDbEngineVersion example custom-oracle-ee-cdb:19.cdb_cev1
Content copied to clipboard

Constructors

Link copied to clipboard
fun CustomDbEngineVersionArgs(databaseInstallationFilesS3BucketName: Output<String>? = null, databaseInstallationFilesS3Prefix: Output<String>? = null, description: Output<String>? = null, engine: Output<String>? = null, engineVersion: Output<String>? = null, filename: Output<String>? = null, kmsKeyId: Output<String>? = null, manifest: Output<String>? = null, manifestHash: Output<String>? = null, sourceImageId: Output<String>? = null, status: Output<String>? = null, tags: Output<Map<String, String>>? = null)

Functions

Link copied to clipboard
open override fun toJava(): CustomDbEngineVersionArgs

Properties

Link copied to clipboard
val databaseInstallationFilesS3BucketName: Output<String>? = null

The name of the Amazon S3 bucket that contains the database installation files.

Link copied to clipboard
val databaseInstallationFilesS3Prefix: Output<String>? = null

The prefix for the Amazon S3 bucket that contains the database installation files.

Link copied to clipboard
val description: Output<String>? = null

The description of the CEV.

Link copied to clipboard
val engine: Output<String>? = null

The name of the database engine. Valid values are custom-oracle*, custom-sqlserver*.

Link copied to clipboard
val engineVersion: Output<String>? = null

The version of the database engine.

Link copied to clipboard
val filename: Output<String>? = null

The name of the manifest file within the local filesystem. Conflicts with manifest.

Link copied to clipboard
val kmsKeyId: Output<String>? = null

The ARN of the AWS KMS key that is used to encrypt the database installation files. Required for RDS Custom for Oracle.

Link copied to clipboard
val manifest: Output<String>? = null

The manifest file, in JSON format, that contains the list of database installation files. Conflicts with filename.

Link copied to clipboard
val manifestHash: Output<String>? = null

Used to trigger updates. Must be set to a base64-encoded SHA256 hash of the manifest source specified with filename. The usual way to set this is filebase64sha256("manifest.json") where "manifest.json" is the local filename of the manifest source.

Link copied to clipboard
val sourceImageId: Output<String>? = null

The ID of the AMI to create the CEV from. Required for RDS Custom for SQL Server. For RDS Custom for Oracle, you can specify an AMI ID that was used in a different Oracle CEV.

Link copied to clipboard
val status: Output<String>? = null

The status of the CEV. Valid values are available, inactive, inactive-except-restore.

Link copied to clipboard
val tags: Output<Map<String, String>>? = null

A mapping of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.