Resource: aws_rds_custom_db_engine_version

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

resource "aws_kms_key" "example" {
  description = "KMS symmetric key for RDS Custom for Oracle"
}

resource "aws_rds_custom_db_engine_version" "example" {
  database_installation_files_s3_bucket_name = "DOC-EXAMPLE-BUCKET"
  database_installation_files_s3_prefix      = "1915_GI/"
  engine                                     = "custom-oracle-ee-cdb"
  engine_version                             = "19.cdb_cev1"
  kms_key_id                                 = aws_kms_key.example.arn
  manifest                                   = <<JSON
  {
    "databaseInstallationFileNames":["V982063-01.zip"]
  }
  JSON

  tags = {
    Name = "example"
    Key  = "value"
  }
}
  {
    "databaseInstallationFileNames":["V982063-01.zip"]
  }
  JSON

  tags = {
    Name = "example"
    Key  = "value"
  }
}

RDS Custom for Oracle External Manifest Usage

resource "aws_kms_key" "example" {
  description = "KMS symmetric key for RDS Custom for Oracle"
}

resource "aws_rds_custom_db_engine_version" "example" {
  database_installation_files_s3_bucket_name = "DOC-EXAMPLE-BUCKET"
  database_installation_files_s3_prefix      = "1915_GI/"
  engine                                     = "custom-oracle-ee-cdb"
  engine_version                             = "19.cdb_cev1"
  kms_key_id                                 = aws_kms_key.example.arn
  filename                                   = "manifest_1915_GI.json"
  manifest_hash                              = filebase64sha256(manifest_1915_GI.json)

  tags = {
    Name = "example"
    Key  = "value"
  }
}

RDS Custom for SQL Server Usage

# CEV creation requires an AMI owned by the operator
resource "aws_rds_custom_db_engine_version" "test" {
  engine          = "custom-sqlserver-se"
  engine_version  = "15.00.4249.2.cev-1"
  source_image_id = "ami-0aa12345678a12ab1"
}

RDS Custom for SQL Server Usage with AMI from another region

resource "aws_ami_copy" "example" {
  name              = "sqlserver-se-2019-15.00.4249.2"
  description       = "A copy of ami-xxxxxxxx"
  source_ami_id     = "ami-xxxxxxxx"
  source_ami_region = "us-east-1"
}
# CEV creation requires an AMI owned by the operator
resource "aws_rds_custom_db_engine_version" "test" {
  engine          = "custom-sqlserver-se"
  engine_version  = "15.00.4249.2.cev-1"
  source_image_id = aws_ami_copy.example.id
}

Argument Reference

This resource supports the following arguments:

Attribute Reference

This resource exports the following attributes in addition to the arguments above:

Timeouts

Configuration options:

Import

In Terraform v1.5.0 and later, use an import block to import custom engine versions for Amazon RDS custom using the engine and engine_version separated by a colon (:). For example:

import {
  to = aws_rds_custom_db_engine_version.example
  id = "custom-oracle-ee-cdb:19.cdb_cev1"
}

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

% terraform import aws_rds_custom_db_engine_version.example custom-oracle-ee-cdb:19.cdb_cev1