Skip to content

armgit / floci

Public Imported from GitHub
0

Light, fluffy, and always free - The AWS Local Emulator alternative

feat(rds): copy and reset parameter groups and copy option groups (#3781)

David0f4865e554f8
diff --git a/docs/services/rds.md b/docs/services/rds.md
index 1ba13ca52e..8ad7ea705a 100644
--- a/docs/services/rds.md
+++ b/docs/services/rds.md
@@ -32,13 +32,18 @@ RDS Data API (`rds-data`) is documented separately because it uses REST JSON rou
| `DescribeDBParameterGroups` | List parameter groups |
| `DeleteDBParameterGroup` | Delete a parameter group |
| `ModifyDBParameterGroup` | Update parameter group settings |
+| `CopyDBParameterGroup` | Copy a parameter group (by name or ARN) with its family and parameter overrides into a new group |
+| `ResetDBParameterGroup` | Reset named parameters, or all of them, to engine defaults |
| `DescribeDBParameters` | List parameters in a group |
| `CreateDBClusterParameterGroup` | Create an Aurora-compatible cluster parameter group |
| `DescribeDBClusterParameterGroups` | List cluster parameter groups |
| `DeleteDBClusterParameterGroup` | Delete a cluster parameter group |
| `ModifyDBClusterParameterGroup` | Update cluster parameter group settings |
+| `CopyDBClusterParameterGroup` | Copy a cluster parameter group into a new group; a managed `default.*` group cannot be copied, as on AWS |
+| `ResetDBClusterParameterGroup` | Reset named cluster parameters, or all of them, to engine defaults |
| `DescribeDBClusterParameters` | List parameters in a cluster group |
| `CreateOptionGroup` | Create an option group |
+| `CopyOptionGroup` | Copy an option group with its engine, major version and options into a new group |
| `DescribeOptionGroups` | List option groups, including the implicit `default:` groups |
| `ModifyOptionGroup` | Add, update, or remove options in an option group |
| `DeleteOptionGroup` | Delete an option group |
@@ -306,7 +311,7 @@ Known gaps, all deliberate:
| Behavior | Status |
|---|---|
-| `CopyOptionGroup`, `DescribeOptionGroupOptions` | Not implemented — separate actions, not part of option group CRUD |
+| `DescribeOptionGroupOptions` | Not implemented: the per-engine option catalog is not modeled |
| `OptionGroupQuotaExceededFault` (AWS caps an account at 20 groups) | Not enforced — capping a local emulator would only get in a test's way |
| `OptionSetting` metadata (`DataType`, `ApplyType`, `AllowedValues`, `DefaultValue`, `Description`) | Omitted — it would require the per-engine option catalog `DescribeOptionGroupOptions` serves |
| `MaxRecords` / `Marker` pagination | Every group is returned in one page, as with every other RDS list action |
diff --git a/src/main/java/io/github/hectorvent/floci/services/rds/RdsQueryHandler.java b/src/main/java/io/github/hectorvent/floci/services/rds/RdsQueryHandler.java
index 802b4e5976..8ee61ba762 100644
--- a/src/main/java/io/github/hectorvent/floci/services/rds/RdsQueryHandler.java
+++ b/src/main/java/io/github/hectorvent/floci/services/rds/RdsQueryHandler.java
@@ -31,6 +31,7 @@ import jakarta.ws.rs.core.MultivaluedMap;
import jakarta.ws.rs.core.Response;
import org.jboss.logging.Logger;
+import java.util.ArrayList;
import java.util.Collection;
import java.util.LinkedHashMap;
import java.util.List;
@@ -85,13 +86,18 @@ public class RdsQueryHandler {
case "DescribeDBParameterGroups" -> handleDescribeDbParameterGroups(params, region);
case "DeleteDBParameterGroup" -> handleDeleteDbParameterGroup(params, region);
case "ModifyDBParameterGroup" -> handleModifyDbParameterGroup(params, region);
+ case "CopyDBParameterGroup" -> handleCopyDbParameterGroup(params, region);
+ case "ResetDBParameterGroup" -> handleResetDbParameterGroup(params, region);
case "DescribeDBParameters" -> handleDescribeDbParameters(params, region);
case "CreateDBClusterParameterGroup" -> handleCreateDbClusterParameterGroup(params, region);
case "DescribeDBClusterParameterGroups" -> handleDescribeDbClusterParameterGroups(params, region);
case "DeleteDBClusterParameterGroup" -> handleDeleteDbClusterParameterGroup(params, region);
case "ModifyDBClusterParameterGroup" -> handleModifyDbClusterParameterGroup(params, region);
+ case "CopyDBClusterParameterGroup" -> handleCopyDbClusterParameterGroup(params, region);
+ case "ResetDBClusterParameterGroup" -> handleResetDbClusterParameterGroup(params, region);
case "DescribeDBClusterParameters" -> handleDescribeDbClusterParameters(params, region);
case "CreateOptionGroup" -> handleCreateOptionGroup(params, region);
+ case "CopyOptionGroup" -> handleCopyOptionGroup(params, region);
case "DescribeOptionGroups" -> handleDescribeOptionGroups(params, region);
case "ModifyOptionGroup" -> handleModifyOptionGroup(params, region);
case "DeleteOptionGroup" -> handleDeleteOptionGroup(params, region);
@@ -806,6 +812,64 @@ public class RdsQueryHandler {
return parameters;
}
+ private Response handleCopyDbParameterGroup(
+ MultivaluedMap<String, String> params, String region) {
+ String source = params.getFirst("SourceDBParameterGroupIdentifier");
+ String target = params.getFirst("TargetDBParameterGroupIdentifier");
+ String description = params.getFirst("TargetDBParameterGroupDescription");
+ Response missing = firstMissingParam(
+ "SourceDBParameterGroupIdentifier", source,
+ "TargetDBParameterGroupIdentifier", target,
+ "TargetDBParameterGroupDescription", description);
+ if (missing != null) {
+ return missing;
+ }
+ try {
+ DbParameterGroup group = service.copyDbParameterGroup(source, target, description, region);
+ Map<String, String> tags = parseTags(params);
+ if (!tags.isEmpty()) {
+ service.addTagsToResource(group.getDbParameterGroupArn(), tags, region);
+ }
+ return Response.ok(AwsQueryResponse.envelope("CopyDBParameterGroup", AwsNamespaces.RDS,
+ paramGroupXml(group))).build();
+ } catch (AwsException e) {
+ return AwsQueryResponse.error(e.getErrorCode(), e.getMessage(), AwsNamespaces.RDS, e.getHttpStatus());
+ }
+ }
+
+ private Response handleResetDbParameterGroup(
+ MultivaluedMap<String, String> params, String region) {
+ String name = params.getFirst("DBParameterGroupName");
+ if (name == null || name.isBlank()) {
+ return AwsQueryResponse.error("InvalidParameterValue", "DBParameterGroupName is required.", AwsNamespaces.RDS, 400);
+ }
+ try {
+ DbParameterGroup group = service.resetDbParameterGroup(name,
+ Boolean.parseBoolean(params.getFirst("ResetAllParameters")), parameterNames(params), region);
+ String result = new XmlBuilder()
+ .elem("DBParameterGroupName", group.getDbParameterGroupName())
+ .build();
+ return Response.ok(AwsQueryResponse.envelope("ResetDBParameterGroup", AwsNamespaces.RDS, result)).build();
+ } catch (AwsException e) {
+ return AwsQueryResponse.error(e.getErrorCode(), e.getMessage(), AwsNamespaces.RDS, e.getHttpStatus());
+ }
+ }
+
+ /** The parameter names of a modify or reset request, in either list encoding. */
+ private static List<String> parameterNames(MultivaluedMap<String, String> params) {
+ List<String> names = new ArrayList<>();
+ for (String prefix : List.of("Parameters.Parameter", "Parameters.member")) {
+ for (int n = 1; ; n++) {
+ String paramName = params.getFirst(prefix + "." + n + ".ParameterName");
+ if (paramName == null) {
+ break;
+ }
+ names.add(paramName);
+ }
+ }
+ return names;
+ }
+
private Response handleDescribeDbParameters(
MultivaluedMap<String, String> params, String region) {
String name = params.getFirst("DBParameterGroupName");
@@ -903,6 +967,49 @@ public class RdsQueryHandler {
}
}
+ private Response handleCopyDbClusterParameterGroup(
+ MultivaluedMap<String, String> params, String region) {
+ String source = params.getFirst("SourceDBClusterParameterGroupIdentifier");
+ String target = params.getFirst("TargetDBClusterParameterGroupIdentifier");
+ String description = params.getFirst("TargetDBClusterParameterGroupDescription");
+ Response missing = firstMissingParam(
+ "SourceDBClusterParameterGroupIdentifier", source,
+ "TargetDBClusterParameterGroupIdentifier", target,
+ "TargetDBClusterParameterGroupDescription", description);
+ if (missing != null) {
+ return missing;
+ }
+ try {
+ DbClusterParameterGroup group = service.copyDbClusterParameterGroup(source, target, description, region);
+ Map<String, String> tags = parseTags(params);
+ if (!tags.isEmpty()) {
+ service.addTagsToResource(group.getDbClusterParameterGroupArn(), tags, region);
+ }
+ return Response.ok(AwsQueryResponse.envelope("CopyDBClusterParameterGroup", AwsNamespaces.RDS,
+ clusterParamGroupXml(group))).build();
+ } catch (AwsException e) {
+ return AwsQueryResponse.error(e.getErrorCode(), e.getMessage(), AwsNamespaces.RDS, e.getHttpStatus());
+ }
+ }
+
+ private Response handleResetDbClusterParameterGroup(
+ MultivaluedMap<String, String> params, String region) {
+ String name = params.getFirst("DBClusterParameterGroupName");
+ if (name == null || name.isBlank()) {
+ return AwsQueryResponse.error("InvalidParameterValue", "DBClusterParameterGroupName is required.", AwsNamespaces.RDS, 400);
+ }
+ try {
+ DbClusterParameterGroup group = service.resetDbClusterParameterGroup(name,
+ Boolean.parseBoolean(params.getFirst("ResetAllParameters")), parameterNames(params), region);
+ String result = new XmlBuilder()
+ .elem("DBClusterParameterGroupName", group.getDbClusterParameterGroupName())
+ .build();
+ return Response.ok(AwsQueryResponse.envelope("ResetDBClusterParameterGroup", AwsNamespaces.RDS, result)).build();
+ } catch (AwsException e) {
+ return AwsQueryResponse.error(e.getErrorCode(), e.getMessage(), AwsNamespaces.RDS, e.getHttpStatus());
+ }
+ }
+
private Response handleDescribeDbClusterParameters(
MultivaluedMap<String, String> params, String region) {
String name = params.getFirst("DBClusterParameterGroupName");
@@ -948,6 +1055,23 @@ public class RdsQueryHandler {
"CreateOptionGroup", AwsNamespaces.RDS, optionGroupXml(group))).build();
}
+ private Response handleCopyOptionGroup(
+ MultivaluedMap<String, String> params, String region) {
+ String source = params.getFirst("SourceOptionGroupIdentifier");
+ String target = params.getFirst("TargetOptionGroupIdentifier");
+ String description = params.getFirst("TargetOptionGroupDescription");
+ Response missing = firstMissingParam(
+ "SourceOptionGroupIdentifier", source,
+ "TargetOptionGroupIdentifier", target,
+ "TargetOptionGroupDescription", description);
+ if (missing != null) {
+ return missing;
+ }
+ OptionGroup group = service.copyOptionGroup(source, target, description, parseTags(params), region);
+ return Response.ok(AwsQueryResponse.envelope(
+ "CopyOptionGroup", AwsNamespaces.RDS, optionGroupXml(group))).build();
+ }
+
private Response handleDescribeOptionGroups(
MultivaluedMap<String, String> params, String region) {
Collection<OptionGroup> result = service.listOptionGroups(
diff --git a/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java b/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java
index bf8ffb56f6..17eb0ea492 100644
--- a/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/rds/RdsService.java
@@ -3427,6 +3427,78 @@ public class RdsService implements Resettable, ResourceProvider {
return group;
}
+ /**
+ * CopyDBParameterGroup: a new group with the source's family and parameter overrides. The
+ * source may be named by identifier or ARN; the target must not exist yet. Both names must
+ * be valid identifiers, which is how AWS refuses to copy a {@code default.*} group: its name
+ * contains periods, and the reference says to create a custom group for the family instead.
+ */
+ public DbParameterGroup copyDbParameterGroup(
+ String sourceIdentifier, String targetName, String targetDescription, String region) {
+ String effectiveRegion = effectiveRegion(region);
+ String sourceName = groupNameFromIdentifier(sourceIdentifier);
+ requireParameterGroupIdentifier(sourceName);
+ requireParameterGroupIdentifier(targetName);
+ DbParameterGroup source = getDbParameterGroup(sourceName, effectiveRegion);
+ DbParameterGroup target = createDbParameterGroup(
+ targetName, source.getDbParameterGroupFamily(), targetDescription, effectiveRegion);
+ target.getParameters().putAll(source.getParameters());
+ putParameterGroupForRegion(targetName, effectiveRegion, target);
+ return target;
+ }
+
+ /**
+ * ResetDBParameterGroup: drops the overrides for the named parameters, or every override when
+ * {@code resetAllParameters} is set, so the group answers with engine defaults again.
+ */
+ public DbParameterGroup resetDbParameterGroup(
+ String name, boolean resetAllParameters, List<String> parameterNames, String region) {
+ String effectiveRegion = effectiveRegion(region);
+ DbParameterGroup group = getDbParameterGroup(name, effectiveRegion);
+ resetParameters(group.getParameters(), resetAllParameters, parameterNames);
+ putParameterGroupForRegion(name, effectiveRegion, group);
+ return group;
+ }
+
+ /**
+ * The identifier rule AWS applies to a copy's source and target parameter group names. A
+ * managed {@code default.*} group fails it on the period, which is the documented way a
+ * default group cannot be copied.
+ */
+ private static void requireParameterGroupIdentifier(String name) {
+ if (name == null || !name.matches("[A-Za-z](?:[A-Za-z0-9]|-(?!-))*") || name.endsWith("-")) {
+ throw new AwsException("InvalidParameterValue",
+ "The parameter DBParameterGroupName is not a valid identifier. Identifiers must begin with a "
+ + "letter; must contain only ASCII letters, digits, and hyphens; and must not end with "
+ + "a hyphen or contain two consecutive hyphens.", 400);
+ }
+ }
+
+ /**
+ * The group name behind an identifier that may be an ARN
+ * ({@code arn:aws:rds:region:account:pg:name}); names cannot contain a colon.
+ */
+ private static String groupNameFromIdentifier(String identifier) {
+ if (identifier != null && identifier.startsWith("arn:")) {
+ return identifier.substring(identifier.lastIndexOf(':') + 1);
+ }
+ return identifier;
+ }
+
+ private static void resetParameters(Map<String, String> overrides, boolean resetAllParameters,
+ List<String> parameterNames) {
+ boolean namesGiven = parameterNames != null && !parameterNames.isEmpty();
+ if (resetAllParameters && namesGiven) {
+ throw new AwsException("InvalidParameterCombination",
+ "You can't specify Parameters when ResetAllParameters is enabled.", 400);
+ }
+ if (namesGiven) {
+ parameterNames.forEach(overrides::remove);
+ } else {
+ overrides.clear();
+ }
+ }
+
public DbSubnetGroup getDbSubnetGroup(String name) {
return getDbSubnetGroup(name, regionResolver.getDefaultRegion());
}
@@ -3632,6 +3704,39 @@ public class RdsService implements Resettable, ResourceProvider {
return group;
}
+ /**
+ * CopyDBClusterParameterGroup: a new group with the source's family and parameter overrides.
+ * The source is a customer group named by identifier or ARN; a managed {@code default.*}
+ * group fails the identifier rule, as on AWS. The target must not exist yet.
+ */
+ public DbClusterParameterGroup copyDbClusterParameterGroup(
+ String sourceIdentifier, String targetName, String targetDescription, String region) {
+ String effectiveRegion = effectiveRegion(region);
+ String sourceName = groupNameFromIdentifier(sourceIdentifier);
+ requireParameterGroupIdentifier(sourceName);
+ requireParameterGroupIdentifier(targetName);
+ DbClusterParameterGroup source = getDbClusterParameterGroup(sourceName, effectiveRegion);
+ DbClusterParameterGroup target = createDbClusterParameterGroup(
+ targetName, source.getDbParameterGroupFamily(), targetDescription, effectiveRegion);
+ target.getParameters().putAll(source.getParameters());
+ putClusterParameterGroupForRegion(targetName, effectiveRegion, target);
+ return target;
+ }
+
+ /** ResetDBClusterParameterGroup; the managed {@code default.*} groups cannot be reset. */
+ public DbClusterParameterGroup resetDbClusterParameterGroup(
+ String name, boolean resetAllParameters, List<String> parameterNames, String region) {
+ String effectiveRegion = effectiveRegion(region);
+ if (managedClusterParameterGroup(name) != null) {
+ throw new AwsException("InvalidDBParameterGroupState",
+ "The default DB cluster parameter group cannot be modified.", 400);
+ }
+ DbClusterParameterGroup group = getDbClusterParameterGroup(name, effectiveRegion);
+ resetParameters(group.getParameters(), resetAllParameters, parameterNames);
+ putClusterParameterGroupForRegion(name, effectiveRegion, group);
+ return group;
+ }
+
// ── Option Groups ─────────────────────────────────────────────────────────
public OptionGroup createOptionGroup(
@@ -3660,6 +3765,37 @@ public class RdsService implements Resettable, ResourceProvider {
return group;
}
+ /**
+ * CopyOptionGroup: a new group for the source's engine and major version carrying copies of
+ * its options. The source may be a customer group or a managed {@code default:*} group, named
+ * by identifier or ARN; the target must not exist yet.
+ */
+ public OptionGroup copyOptionGroup(String sourceIdentifier, String targetName,
+ String targetDescription, Map<String, String> tags, String region) {
+ String effectiveRegion = effectiveRegion(region);
+ OptionGroup source = getOptionGroup(groupNameFromIdentifier(sourceIdentifier), effectiveRegion);
+ OptionGroup target = createOptionGroup(targetName, source.getEngineName(),
+ source.getMajorEngineVersion(), targetDescription, tags, effectiveRegion);
+ for (OptionGroupOption option : source.getOptions()) {
+ target.getOptions().add(copyOption(option));
+ }
+ putOptionGroupForRegion(targetName, effectiveRegion, target);
+ return target;
+ }
+
+ private static OptionGroupOption copyOption(OptionGroupOption source) {
+ OptionGroupOption copy = new OptionGroupOption(source.getOptionName());
+ copy.setOptionDescription(source.getOptionDescription());
+ copy.setOptionVersion(source.getOptionVersion());
+ copy.setPort(source.getPort());
+ copy.setPersistent(source.isPersistent());
+ copy.setPermanent(source.isPermanent());
+ copy.setOptionSettings(new LinkedHashMap<>(source.getOptionSettings()));
+ copy.setVpcSecurityGroupMemberships(new ArrayList<>(source.getVpcSecurityGroupMemberships()));
+ copy.setDbSecurityGroupMemberships(new ArrayList<>(source.getDbSecurityGroupMemberships()));
+ return copy;
+ }
+
public OptionGroup getOptionGroup(String name) {
return getOptionGroup(name, regionResolver.getDefaultRegion());
}
diff --git a/src/test/java/io/github/hectorvent/floci/services/rds/RdsParameterGroupCopyResetIntegrationTest.java b/src/test/java/io/github/hectorvent/floci/services/rds/RdsParameterGroupCopyResetIntegrationTest.java
new file mode 100644
index 0000000000..dd8845a770
--- /dev/null
+++ b/src/test/java/io/github/hectorvent/floci/services/rds/RdsParameterGroupCopyResetIntegrationTest.java
@@ -0,0 +1,350 @@
+package io.github.hectorvent.floci.services.rds;
+
+import io.quarkus.test.junit.QuarkusTest;
+import io.restassured.specification.RequestSpecification;
+import org.junit.jupiter.api.MethodOrderer;
+import org.junit.jupiter.api.Order;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.TestMethodOrder;
+
+import static io.restassured.RestAssured.given;
+import static io.restassured.http.ContentType.URLENC;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.not;
+
+/**
+ * CopyDBParameterGroup, CopyDBClusterParameterGroup, CopyOptionGroup, ResetDBParameterGroup and
+ * ResetDBClusterParameterGroup: a copy carries the source's family (or engine and major version),
+ * overrides and options into a group that must not exist yet; a reset drops overrides so the
+ * group answers with engine defaults again.
+ */
+@QuarkusTest
+@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
+class RdsParameterGroupCopyResetIntegrationTest {
+
+ private static final String SOURCE_PG = "copy-test-source-pg";
+ private static final String TARGET_PG = "copy-test-target-pg";
+ private static final String SOURCE_PG_ARN = "arn:aws:rds:us-east-1:000000000000:pg:" + SOURCE_PG;
+ private static final String SOURCE_CLUSTER_PG = "copy-test-source-cluster-pg";
+ private static final String TARGET_CLUSTER_PG = "copy-test-target-cluster-pg";
+ private static final String FROM_DEFAULT_CLUSTER_PG = "copy-test-from-default-cluster-pg";
+ private static final String SOURCE_OG = "copy-test-source-og";
+ private static final String TARGET_OG = "copy-test-target-og";
+
+ private static final String AUTH =
+ "AWS4-HMAC-SHA256 Credential=test/20260615/us-east-1/rds/aws4_request, "
+ + "SignedHeaders=content-type;host, Signature=test";
+
+ private static RequestSpecification query(String action) {
+ return given().header("Authorization", AUTH)
+ .contentType(URLENC)
+ .formParam("Action", action)
+ .formParam("Version", "2014-10-31");
+ }
+
+ @Test
+ @Order(1)
+ void copyDbParameterGroupCarriesFamilyOverridesAndTags() {
+ query("CreateDBParameterGroup")
+ .formParam("DBParameterGroupName", SOURCE_PG)
+ .formParam("DBParameterGroupFamily", "postgres15")
+ .formParam("Description", "source")
+ .when().post("/").then().statusCode(200);
+ query("ModifyDBParameterGroup")
+ .formParam("DBParameterGroupName", SOURCE_PG)
+ .formParam("Parameters.member.1.ParameterName", "max_connections")
+ .formParam("Parameters.member.1.ParameterValue", "250")
+ .formParam("Parameters.member.2.ParameterName", "log_min_duration_statement")
+ .formParam("Parameters.member.2.ParameterValue", "500")
+ .when().post("/").then().statusCode(200);
+
+ // The source may be named by ARN, as the API reference allows.
+ query("CopyDBParameterGroup")
+ .formParam("SourceDBParameterGroupIdentifier", SOURCE_PG_ARN)
+ .formParam("TargetDBParameterGroupIdentifier", TARGET_PG)
+ .formParam("TargetDBParameterGroupDescription", "copied")
+ .formParam("Tags.Tag.1.Key", "env")
+ .formParam("Tags.Tag.1.Value", "prod")
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(containsString("<CopyDBParameterGroupResult>"))
+ .body(containsString("<DBParameterGroupName>" + TARGET_PG + "</DBParameterGroupName>"))
+ .body(containsString("<DBParameterGroupFamily>postgres15</DBParameterGroupFamily>"))
+ .body(containsString("<Description>copied</Description>"))
+ .body(containsString(":pg:" + TARGET_PG + "</DBParameterGroupArn>"));
+
+ query("DescribeDBParameters")
+ .formParam("DBParameterGroupName", TARGET_PG)
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(containsString("<ParameterName>max_connections</ParameterName>"))
+ .body(containsString("<ParameterValue>250</ParameterValue>"))
+ .body(containsString("<ParameterName>log_min_duration_statement</ParameterName>"));
+
+ query("ListTagsForResource")
+ .formParam("ResourceName", "arn:aws:rds:us-east-1:000000000000:pg:" + TARGET_PG)
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(containsString("<Key>env</Key>"))
+ .body(containsString("<Value>prod</Value>"));
+ }
+
+ @Test
+ @Order(2)
+ void copyIsIndependentOfItsSourceAndRefusesAnExistingTarget() {
+ query("ModifyDBParameterGroup")
+ .formParam("DBParameterGroupName", SOURCE_PG)
+ .formParam("Parameters.member.1.ParameterName", "max_connections")
+ .formParam("Parameters.member.1.ParameterValue", "999")
+ .when().post("/").then().statusCode(200);
+
+ query("DescribeDBParameters")
+ .formParam("DBParameterGroupName", TARGET_PG)
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(containsString("<ParameterValue>250</ParameterValue>"))
+ .body(not(containsString("<ParameterValue>999</ParameterValue>")));
+
+ query("CopyDBParameterGroup")
+ .formParam("SourceDBParameterGroupIdentifier", SOURCE_PG)
+ .formParam("TargetDBParameterGroupIdentifier", TARGET_PG)
+ .formParam("TargetDBParameterGroupDescription", "again")
+ .when().post("/")
+ .then()
+ .statusCode(400)
+ .body(containsString("<Code>DBParameterGroupAlreadyExists</Code>"));
+
+ query("CopyDBParameterGroup")
+ .formParam("SourceDBParameterGroupIdentifier", "no-such-group")
+ .formParam("TargetDBParameterGroupIdentifier", "copy-test-never-created")
+ .formParam("TargetDBParameterGroupDescription", "x")
+ .when().post("/")
+ .then()
+ .statusCode(404)
+ .body(containsString("<Code>DBParameterGroupNotFound</Code>"));
+
+ query("CopyDBParameterGroup")
+ .formParam("SourceDBParameterGroupIdentifier", SOURCE_PG)
+ .formParam("TargetDBParameterGroupIdentifier", "copy-test-never-created")
+ .when().post("/")
+ .then()
+ .statusCode(400)
+ .body(containsString("TargetDBParameterGroupDescription"));
+
+ query("CopyDBParameterGroup")
+ .formParam("SourceDBParameterGroupIdentifier", "default.postgres15")
+ .formParam("TargetDBParameterGroupIdentifier", "copy-test-never-created")
+ .formParam("TargetDBParameterGroupDescription", "x")
+ .when().post("/")
+ .then()
+ .statusCode(400)
+ .body(containsString("<Code>InvalidParameterValue</Code>"))
+ .body(containsString("is not a valid identifier"));
+ }
+
+ @Test
+ @Order(3)
+ void resetDbParameterGroupDropsNamedOverridesOrAllOfThem() {
+ // Named the way `aws rds reset-db-parameter-group --parameters ...` puts it on the wire.
+ query("ResetDBParameterGroup")
+ .formParam("DBParameterGroupName", TARGET_PG)
+ .formParam("Parameters.Parameter.1.ParameterName", "max_connections")
+ .formParam("Parameters.Parameter.1.ApplyMethod", "immediate")
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(containsString("<ResetDBParameterGroupResult>"))
+ .body(containsString("<DBParameterGroupName>" + TARGET_PG + "</DBParameterGroupName>"));
+
+ query("DescribeDBParameters")
+ .formParam("DBParameterGroupName", TARGET_PG)
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(not(containsString("<ParameterName>max_connections</ParameterName>")))
+ .body(containsString("<ParameterName>log_min_duration_statement</ParameterName>"));
+
+ query("ResetDBParameterGroup")
+ .formParam("DBParameterGroupName", TARGET_PG)
+ .formParam("ResetAllParameters", "true")
+ .when().post("/")
+ .then()
+ .statusCode(200);
+
+ query("DescribeDBParameters")
+ .formParam("DBParameterGroupName", TARGET_PG)
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(not(containsString("<ParameterName>")));
+
+ query("ResetDBParameterGroup")
+ .formParam("DBParameterGroupName", TARGET_PG)
+ .formParam("ResetAllParameters", "true")
+ .formParam("Parameters.Parameter.1.ParameterName", "max_connections")
+ .when().post("/")
+ .then()
+ .statusCode(400)
+ .body(containsString("<Code>InvalidParameterCombination</Code>"));
+
+ query("ResetDBParameterGroup")
+ .formParam("DBParameterGroupName", "no-such-group")
+ .when().post("/")
+ .then()
+ .statusCode(404)
+ .body(containsString("<Code>DBParameterGroupNotFound</Code>"));
+ }
+
+ @Test
+ @Order(4)
+ void clusterParameterGroupCopyAndResetBehaveTheSameWay() {
+ query("CreateDBClusterParameterGroup")
+ .formParam("DBClusterParameterGroupName", SOURCE_CLUSTER_PG)
+ .formParam("DBParameterGroupFamily", "aurora-postgresql15")
+ .formParam("Description", "source")
+ .when().post("/").then().statusCode(200);
+ query("ModifyDBClusterParameterGroup")
+ .formParam("DBClusterParameterGroupName", SOURCE_CLUSTER_PG)
+ .formParam("Parameters.member.1.ParameterName", "rds.force_ssl")
+ .formParam("Parameters.member.1.ParameterValue", "1")
+ .when().post("/").then().statusCode(200);
+
+ query("CopyDBClusterParameterGroup")
+ .formParam("SourceDBClusterParameterGroupIdentifier", SOURCE_CLUSTER_PG)
+ .formParam("TargetDBClusterParameterGroupIdentifier", TARGET_CLUSTER_PG)
+ .formParam("TargetDBClusterParameterGroupDescription", "copied")
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(containsString("<CopyDBClusterParameterGroupResult>"))
+ .body(containsString("<DBClusterParameterGroupName>" + TARGET_CLUSTER_PG + "</DBClusterParameterGroupName>"))
+ .body(containsString("<DBParameterGroupFamily>aurora-postgresql15</DBParameterGroupFamily>"))
+ .body(containsString(":cluster-pg:" + TARGET_CLUSTER_PG + "</DBClusterParameterGroupArn>"));
+
+ query("DescribeDBClusterParameters")
+ .formParam("DBClusterParameterGroupName", TARGET_CLUSTER_PG)
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(containsString("<ParameterName>rds.force_ssl</ParameterName>"));
+
+ // A managed default group cannot be copied. AWS refuses it through the identifier rule,
+ // since default group names carry periods; the reference says to create a custom group
+ // for the family instead.
+ query("CopyDBClusterParameterGroup")
+ .formParam("SourceDBClusterParameterGroupIdentifier", "default.aurora-postgresql15")
+ .formParam("TargetDBClusterParameterGroupIdentifier", FROM_DEFAULT_CLUSTER_PG)
+ .formParam("TargetDBClusterParameterGroupDescription", "from default")
+ .when().post("/")
+ .then()
+ .statusCode(400)
+ .body(containsString("<Code>InvalidParameterValue</Code>"))
+ .body(containsString("is not a valid identifier"));
+ query("DescribeDBClusterParameterGroups")
+ .formParam("DBClusterParameterGroupName", FROM_DEFAULT_CLUSTER_PG)
+ .when().post("/")
+ .then()
+ .statusCode(404);
+
+ query("ResetDBClusterParameterGroup")
+ .formParam("DBClusterParameterGroupName", TARGET_CLUSTER_PG)
+ .formParam("ResetAllParameters", "true")
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(containsString("<ResetDBClusterParameterGroupResult>"))
+ .body(containsString("<DBClusterParameterGroupName>" + TARGET_CLUSTER_PG + "</DBClusterParameterGroupName>"));
+
+ query("DescribeDBClusterParameters")
+ .formParam("DBClusterParameterGroupName", TARGET_CLUSTER_PG)
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(not(containsString("<ParameterName>rds.force_ssl</ParameterName>")));
+
+ query("ResetDBClusterParameterGroup")
+ .formParam("DBClusterParameterGroupName", "default.aurora-postgresql15")
+ .when().post("/")
+ .then()
+ .statusCode(400)
+ .body(containsString("<Code>InvalidDBParameterGroupState</Code>"));
+ }
+
+ @Test
+ @Order(5)
+ void copyOptionGroupCarriesEngineVersionAndOptions() {
+ query("CreateOptionGroup")
+ .formParam("OptionGroupName", SOURCE_OG)
+ .formParam("EngineName", "mysql")
+ .formParam("MajorEngineVersion", "8.0")
+ .formParam("OptionGroupDescription", "source")
+ .when().post("/").then().statusCode(200);
+ query("ModifyOptionGroup")
+ .formParam("OptionGroupName", SOURCE_OG)
+ .formParam("OptionsToInclude.member.1.OptionName", "MARIADB_AUDIT_PLUGIN")
+ .formParam("OptionsToInclude.member.1.OptionSettings.member.1.Name", "SERVER_AUDIT_EVENTS")
+ .formParam("OptionsToInclude.member.1.OptionSettings.member.1.Value", "CONNECT")
+ .formParam("ApplyImmediately", "true")
+ .when().post("/").then().statusCode(200);
+
+ query("CopyOptionGroup")
+ .formParam("SourceOptionGroupIdentifier", SOURCE_OG)
+ .formParam("TargetOptionGroupIdentifier", TARGET_OG)
+ .formParam("TargetOptionGroupDescription", "copied")
+ .formParam("Tags.Tag.1.Key", "env")
+ .formParam("Tags.Tag.1.Value", "prod")
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(containsString("<CopyOptionGroupResult>"))
+ .body(containsString("<OptionGroupName>" + TARGET_OG + "</OptionGroupName>"))
+ .body(containsString("<EngineName>mysql</EngineName>"))
+ .body(containsString("<MajorEngineVersion>8.0</MajorEngineVersion>"))
+ .body(containsString("<OptionGroupDescription>copied</OptionGroupDescription>"))
+ .body(containsString("<OptionName>MARIADB_AUDIT_PLUGIN</OptionName>"))
+ .body(containsString("<Value>CONNECT</Value>"));
+
+ query("ListTagsForResource")
+ .formParam("ResourceName", "arn:aws:rds:us-east-1:000000000000:og:" + TARGET_OG)
+ .when().post("/")
+ .then()
+ .statusCode(200)
+ .body(containsString("<Key>env</Key>"));
+
+ query("CopyOptionGroup")
+ .formParam("SourceOptionGroupIdentifier", SOURCE_OG)
+ .formParam("TargetOptionGroupIdentifier", TARGET_OG)
+ .formParam("TargetOptionGroupDescription", "again")
+ .when().post("/")
+ .then()
+ .statusCode(400)
+ .body(containsString("<Code>OptionGroupAlreadyExistsFault</Code>"));
+
+ query("CopyOptionGroup")
+ .formParam("SourceOptionGroupIdentifier", "no-such-option-group")
+ .formParam("TargetOptionGroupIdentifier", "copy-test-never-created-og")
+ .formParam("TargetOptionGroupDescription", "x")
+ .when().post("/")
+ .then()
+ .statusCode(404)
+ .body(containsString("<Code>OptionGroupNotFoundFault</Code>"));
+ }
+
+ @Test
+ @Order(9)
+ void cleanUp() {
+ for (String name : new String[] {SOURCE_PG, TARGET_PG}) {
+ query("DeleteDBParameterGroup").formParam("DBParameterGroupName", name).when().post("/");
+ }
+ for (String name : new String[] {SOURCE_CLUSTER_PG, TARGET_CLUSTER_PG, FROM_DEFAULT_CLUSTER_PG}) {
+ query("DeleteDBClusterParameterGroup").formParam("DBClusterParameterGroupName", name).when().post("/");
+ }
+ for (String name : new String[] {SOURCE_OG, TARGET_OG}) {
+ query("DeleteOptionGroup").formParam("OptionGroupName", name).when().post("/");
+ }
+ }
+}