Light, fluffy, and always free - The AWS Local Emulator alternative
feat: implement read-only describe/list APIs for resource collection (#1581)
Abhishek Dubeya40dc52f4d44
diff --git a/src/main/java/io/github/hectorvent/floci/services/backup/BackupController.java b/src/main/java/io/github/hectorvent/floci/services/backup/BackupController.javaindex de6f11ab59..eed4154194 100644--- a/src/main/java/io/github/hectorvent/floci/services/backup/BackupController.java+++ b/src/main/java/io/github/hectorvent/floci/services/backup/BackupController.java@@ -4,6 +4,7 @@ import com.fasterxml.jackson.databind.JsonNode;import com.fasterxml.jackson.databind.ObjectMapper;import com.fasterxml.jackson.databind.node.ArrayNode;import com.fasterxml.jackson.databind.node.ObjectNode;+import io.github.hectorvent.floci.core.common.AwsException;import io.github.hectorvent.floci.core.common.RegionResolver;import io.github.hectorvent.floci.services.backup.model.*;import jakarta.inject.Inject;@@ -87,6 +88,29 @@ public class BackupController {return Response.ok(out).build();}+ // Notification configuration is an optional, never-configured aspect of a vault in the+ // emulator. Per the AWS Backup API, GetBackupVaultNotifications returns+ // ResourceNotFoundException (HTTP 400) when no notification configuration exists for the+ // vault. We mirror that exact error contract so SDK clients see the documented+ // "not configured" signal rather than an empty 200 or a generic 400 they can't interpret.+ @GET+ @Path("/backup-vaults/{backupVaultName}/notification-configuration")+ public Response getBackupVaultNotifications(@PathParam("backupVaultName") String vaultName) {+ throw new AwsException("ResourceNotFoundException",+ "No notification configuration found for backup vault: " + vaultName, 400);+ }++ // Access policy is an optional, never-configured aspect of a vault in the emulator. Per the+ // AWS Backup API, GetBackupVaultAccessPolicy returns ResourceNotFoundException (HTTP 400)+ // when no policy exists for the vault. We mirror that exact error contract so SDK clients+ // see the documented "not configured" signal rather than an empty 200 or a generic 400.+ @GET+ @Path("/backup-vaults/{backupVaultName}/access-policy")+ public Response getBackupVaultAccessPolicy(@PathParam("backupVaultName") String vaultName) {+ throw new AwsException("ResourceNotFoundException",+ "No access policy found for backup vault: " + vaultName, 400);+ }+// ── Plan ───────────────────────────────────────────────────────────────────@PUTdiff --git a/src/main/java/io/github/hectorvent/floci/services/docdb/DocDbQueryHandler.java b/src/main/java/io/github/hectorvent/floci/services/docdb/DocDbQueryHandler.javaindex 17b392796b..13ae93b732 100644--- a/src/main/java/io/github/hectorvent/floci/services/docdb/DocDbQueryHandler.java+++ b/src/main/java/io/github/hectorvent/floci/services/docdb/DocDbQueryHandler.java@@ -35,6 +35,7 @@ public class DocDbQueryHandler {return switch (action) {case "CreateDBCluster" -> handleCreateDbCluster(params);case "DescribeDBClusters" -> handleDescribeDbClusters(params);+ case "DescribeDBClusterSnapshots" -> handleDescribeDbClusterSnapshots(params);case "DeleteDBCluster" -> handleDeleteDbCluster(params);case "ModifyDBCluster" -> handleModifyDbCluster(params);case "CreateDBInstance" -> handleCreateDbInstance(params);@@ -94,6 +95,14 @@ public class DocDbQueryHandler {return Response.ok(AwsQueryResponse.envelope("DescribeDBClusters", AwsNamespaces.RDS, xml.build())).build();}+ private Response handleDescribeDbClusterSnapshots(MultivaluedMap<String, String> params) {+ // Snapshots are not modeled by the emulator; return the wire-accurate empty result+ // the DocDB/RDS Query API uses (empty <DBClusterSnapshots/>, no <Marker>) so SDK+ // clients complete the read instead of failing on an unsupported action.+ XmlBuilder xml = new XmlBuilder().start("DBClusterSnapshots").end("DBClusterSnapshots");+ return Response.ok(AwsQueryResponse.envelope("DescribeDBClusterSnapshots", AwsNamespaces.RDS, xml.build())).build();+ }+private Response handleDeleteDbCluster(MultivaluedMap<String, String> params) {String id = params.getFirst("DBClusterIdentifier");if (id == null || id.isBlank()) {diff --git a/src/main/java/io/github/hectorvent/floci/services/elasticache/ElastiCacheQueryHandler.java b/src/main/java/io/github/hectorvent/floci/services/elasticache/ElastiCacheQueryHandler.javaindex d0a34fc3f6..a06a283ed5 100644--- a/src/main/java/io/github/hectorvent/floci/services/elasticache/ElastiCacheQueryHandler.java+++ b/src/main/java/io/github/hectorvent/floci/services/elasticache/ElastiCacheQueryHandler.java@@ -62,6 +62,8 @@ public class ElastiCacheQueryHandler {case "CreateCacheCluster" -> handleCreateCacheCluster(params);case "DescribeCacheClusters" -> handleDescribeCacheClusters(params);case "DeleteCacheCluster" -> handleDeleteCacheCluster(params);+ case "DescribeCacheSubnetGroups" -> handleDescribeCacheSubnetGroups(params);+ case "DescribeCacheParameterGroups" -> handleDescribeCacheParameterGroups(params);default -> AwsQueryResponse.error("UnsupportedOperation","Operation " + action + " is not supported.", AwsNamespaces.EC, 400);};@@ -278,6 +280,22 @@ public class ElastiCacheQueryHandler {}}+ // ── Subnet / Parameter Groups (read-only describes for resources not modeled) ────++ private Response handleDescribeCacheSubnetGroups(MultivaluedMap<String, String> params) {+ // Cache subnet groups are not modeled by the emulator; return the wire-accurate+ // empty result so SDK clients get a valid 200 instead of an unsupported-action 400.+ var xml = new XmlBuilder().start("CacheSubnetGroups").end("CacheSubnetGroups");+ return Response.ok(AwsQueryResponse.envelope("DescribeCacheSubnetGroups", AwsNamespaces.EC, xml.build())).build();+ }++ private Response handleDescribeCacheParameterGroups(MultivaluedMap<String, String> params) {+ // Cache parameter groups are not modeled by the emulator; return the wire-accurate+ // empty result so SDK clients get a valid 200 instead of an unsupported-action 400.+ var xml = new XmlBuilder().start("CacheParameterGroups").end("CacheParameterGroups");+ return Response.ok(AwsQueryResponse.envelope("DescribeCacheParameterGroups", AwsNamespaces.EC, xml.build())).build();+ }+// ── IAM Token Validation ──────────────────────────────────────────────────private Response handleValidateIamAuthToken(MultivaluedMap<String, String> params) {diff --git a/src/main/java/io/github/hectorvent/floci/services/glue/GlueJsonHandler.java b/src/main/java/io/github/hectorvent/floci/services/glue/GlueJsonHandler.javaindex 3ebb17a068..9ce4999f8b 100644--- a/src/main/java/io/github/hectorvent/floci/services/glue/GlueJsonHandler.java+++ b/src/main/java/io/github/hectorvent/floci/services/glue/GlueJsonHandler.java@@ -167,6 +167,13 @@ public class GlueJsonHandler {case "TagResource" -> handleTagResource(request);case "UntagResource" -> handleUntagResource(request);case "GetTags" -> handleGetTags(request);+ // Read-only Glue actions for resources the emulator does not model. The AWS SDK+ // expects each to return a 200 with its result key present (empty), so we emit the+ // documented empty shape rather than an InvalidAction 400 that callers can't read.+ case "GetJobs" -> Response.ok(Map.of("Jobs", List.of())).build();+ case "GetCrawlers" -> Response.ok(Map.of("Crawlers", List.of())).build();+ case "ListDataQualityRulesets" -> Response.ok(Map.of("Rulesets", List.of())).build();+ case "GetSecurityConfigurations" -> Response.ok(Map.of("SecurityConfigurations", List.of())).build();default -> throw new AwsException("InvalidAction", "Action " + action + " is not supported", 400);};}diff --git a/src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java b/src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.javaindex c69714a174..7088d73e3e 100644--- a/src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java+++ b/src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java@@ -57,6 +57,12 @@ public class IamQueryHandler {case "UntagUser" -> handleUntagUser(params);case "ListUserTags" -> handleListUserTags(params);case "ListMFADevices" -> handleListMFADevices(params);+ case "GetLoginProfile" -> handleGetLoginProfile(params);++ // Identity providers & server certificates (read-only, not modeled)+ case "ListSAMLProviders" -> handleListSAMLProviders(params);+ case "ListOpenIDConnectProviders" -> handleListOpenIDConnectProviders(params);+ case "ListServerCertificates" -> handleListServerCertificates(params);// Groupscase "CreateGroup" -> handleCreateGroup(params);@@ -130,6 +136,7 @@ public class IamQueryHandler {case "DeleteAccessKey" -> handleDeleteAccessKey(params);case "ListAccessKeys" -> handleListAccessKeys(params);case "UpdateAccessKey" -> handleUpdateAccessKey(params);+ case "GetAccessKeyLastUsed" -> handleGetAccessKeyLastUsed(params);// Instance Profilescase "CreateInstanceProfile" -> handleCreateInstanceProfile(params);@@ -235,6 +242,45 @@ public class IamQueryHandler {return Response.ok(AwsQueryResponse.envelope("ListMFADevices", AwsNamespaces.IAM, result)).build();}+ private Response handleGetLoginProfile(MultivaluedMap<String, String> params) {+ // Login profiles (console passwords) are not modeled. Per the IAM API,+ // GetLoginProfile returns NoSuchEntity (HTTP 404) when a user has no console+ // password — a documented, expected result that callers branch on. We must+ // return that exact error, not an empty 200 or an UnsupportedOperation 400,+ // which clients would treat as a real failure rather than "no profile".+ String userName = getParam(params, "UserName");+ return AwsQueryResponse.error("NoSuchEntity",+ "Login Profile for User " + (userName != null ? userName : "") + " cannot be found.",+ AwsNamespaces.IAM, 404);+ }++ private Response handleListSAMLProviders(MultivaluedMap<String, String> params) {+ // SAML identity providers are not modeled; return the wire-accurate empty+ // list (ListSAMLProviders is not paginated — no Marker/IsTruncated).+ String result = new XmlBuilder()+ .start("SAMLProviderList").end("SAMLProviderList")+ .build();+ return Response.ok(AwsQueryResponse.envelope("ListSAMLProviders", AwsNamespaces.IAM, result)).build();+ }++ private Response handleListOpenIDConnectProviders(MultivaluedMap<String, String> params) {+ // OIDC identity providers are not modeled; return the wire-accurate empty+ // list (ListOpenIDConnectProviders is not paginated).+ String result = new XmlBuilder()+ .start("OpenIDConnectProviderList").end("OpenIDConnectProviderList")+ .build();+ return Response.ok(AwsQueryResponse.envelope("ListOpenIDConnectProviders", AwsNamespaces.IAM, result)).build();+ }++ private Response handleListServerCertificates(MultivaluedMap<String, String> params) {+ // Server certificates are not modeled; return an empty paginated list.+ String result = new XmlBuilder()+ .start("ServerCertificateMetadataList").end("ServerCertificateMetadataList")+ .elem("IsTruncated", false)+ .build();+ return Response.ok(AwsQueryResponse.envelope("ListServerCertificates", AwsNamespaces.IAM, result)).build();+ }+// =========================================================================// Groups// =========================================================================@@ -647,6 +693,23 @@ public class IamQueryHandler {return Response.ok(AwsQueryResponse.envelopeNoResult("UpdateAccessKey", AwsNamespaces.IAM)).build();}+ private Response handleGetAccessKeyLastUsed(MultivaluedMap<String, String> params) {+ // Access-key usage is not modeled, so return the IAM API's documented+ // "never used" shape: an AccessKeyLastUsed with ServiceName=N/A and Region=N/A+ // and NO LastUsedDate. UserName is optional and its type is non-empty+ // (length 1-128); since the emulator exposes no AccessKeyId→UserName lookup,+ // the element is omitted rather than emitted empty — an empty string could be+ // rejected by a strict client, and callers that need the owner already have it+ // from the preceding ListAccessKeys call.+ String result = new XmlBuilder()+ .start("AccessKeyLastUsed")+ .elem("ServiceName", "N/A")+ .elem("Region", "N/A")+ .end("AccessKeyLastUsed")+ .build();+ return Response.ok(AwsQueryResponse.envelope("GetAccessKeyLastUsed", AwsNamespaces.IAM, result)).build();+ }+// =========================================================================// Instance Profiles// =========================================================================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.javaindex 56f1db97d8..e94c35641b 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@@ -69,6 +69,9 @@ public class RdsQueryHandler {case "DeleteDBClusterParameterGroup" -> handleDeleteDbClusterParameterGroup(params);case "ModifyDBClusterParameterGroup" -> handleModifyDbClusterParameterGroup(params);case "DescribeDBClusterParameters" -> handleDescribeDbClusterParameters(params);+ case "DescribeDBSnapshots" -> handleDescribeDbSnapshots(params);+ case "DescribeDBProxies" -> handleDescribeDbProxies(params);+ case "DescribeDBClusterSnapshots" -> handleDescribeDbClusterSnapshots(params);case "AddTagsToResource" -> handleAddTagsToResource(params);case "ListTagsForResource" -> handleListTagsForResource(params);case "RemoveTagsFromResource" -> handleRemoveTagsFromResource(params);@@ -586,6 +589,32 @@ public class RdsQueryHandler {}}+ // ── Snapshots & Proxies (not modeled — empty lists) ───────────────────────++ private Response handleDescribeDbSnapshots(MultivaluedMap<String, String> params) {+ // DB snapshots are not modeled; return the RDS Query API's wire-accurate empty+ // result (empty <DBSnapshots> wrapper, no <Marker>) so SDK clients complete the+ // read instead of failing with UnsupportedOperation.+ String result = new XmlBuilder().start("DBSnapshots").end("DBSnapshots").build();+ return Response.ok(AwsQueryResponse.envelope("DescribeDBSnapshots", AwsNamespaces.RDS, result)).build();+ }++ private Response handleDescribeDbProxies(MultivaluedMap<String, String> params) {+ // DB proxies are not modeled; return the RDS Query API's wire-accurate empty+ // result (empty <DBProxies> wrapper, no <Marker>) so SDK clients complete the+ // read instead of failing with UnsupportedOperation.+ String result = new XmlBuilder().start("DBProxies").end("DBProxies").build();+ return Response.ok(AwsQueryResponse.envelope("DescribeDBProxies", AwsNamespaces.RDS, result)).build();+ }++ private Response handleDescribeDbClusterSnapshots(MultivaluedMap<String, String> params) {+ // DB cluster snapshots are not modeled; return the RDS Query API's wire-accurate+ // empty result (empty <DBClusterSnapshots> wrapper, no <Marker>) so SDK clients+ // complete the read instead of failing with UnsupportedOperation.+ String result = new XmlBuilder().start("DBClusterSnapshots").end("DBClusterSnapshots").build();+ return Response.ok(AwsQueryResponse.envelope("DescribeDBClusterSnapshots", AwsNamespaces.RDS, result)).build();+ }+// ── XML builders ──────────────────────────────────────────────────────────private String dbInstanceXml(DbInstance i) {diff --git a/src/main/java/io/github/hectorvent/floci/services/s3/S3ControlController.java b/src/main/java/io/github/hectorvent/floci/services/s3/S3ControlController.javaindex 757a9a4af8..0be51c211a 100644--- a/src/main/java/io/github/hectorvent/floci/services/s3/S3ControlController.java+++ b/src/main/java/io/github/hectorvent/floci/services/s3/S3ControlController.java@@ -76,6 +76,40 @@ public class S3ControlController {}}+ /**+ * ListAccessPoints — returns the account's S3 access points.+ *+ * <p>The emulator has no access-point store. Per the S3 Control API, the only success+ * response for ListAccessPoints is HTTP 200 with a {@code <ListAccessPointsResult>}+ * carrying an {@code <AccessPointList>} — empty when the account has none — and an+ * optional {@code <NextToken>}. 404 is not a documented outcome for this operation, so+ * without this route an AWS SDK client cannot map the response to the expected result+ * or to a known error and the read fails (and, depending on the client's retry config,+ * may burn its retry budget on the unexpected status first). We therefore return the+ * documented empty list: an {@code <AccessPointList/>} with no {@code <NextToken>},+ * which ends pagination immediately.+ *+ * GET /v20180820/accesspoint+ * Header: x-amz-account-id+ */+ @GET+ @Path("/accesspoint")+ public Response listAccessPoints(+ @HeaderParam("x-amz-account-id") String accountId,+ @QueryParam("bucket") String bucket,+ @QueryParam("maxResults") String maxResults,+ @QueryParam("nextToken") String nextToken) {++ String xml = new XmlBuilder()+ .raw("<?xml version=\"1.0\" encoding=\"UTF-8\"?>")+ .start("ListAccessPointsResult", AwsNamespaces.S3_CONTROL)+ .start("AccessPointList")+ .end("AccessPointList")+ .end("ListAccessPointsResult")+ .build();+ return Response.ok(xml).build();+ }+/*** TagResource — replaces all tags on the specified S3 bucket.*diff --git a/src/main/java/io/github/hectorvent/floci/services/ssm/SsmJsonHandler.java b/src/main/java/io/github/hectorvent/floci/services/ssm/SsmJsonHandler.javaindex 6a0522d0ef..d3b760848b 100644--- a/src/main/java/io/github/hectorvent/floci/services/ssm/SsmJsonHandler.java+++ b/src/main/java/io/github/hectorvent/floci/services/ssm/SsmJsonHandler.java@@ -61,6 +61,10 @@ public class SsmJsonHandler {// Patch Manager (read-only: AWS-owned predefined baselines)case "DescribePatchBaselines" -> handleDescribePatchBaselines(request, region);case "GetDefaultPatchBaseline" -> handleGetDefaultPatchBaseline(request, region);+ // Read-only list operations (resources not modeled: empty results)+ case "ListDocuments" -> handleListDocuments(request, region);+ case "ListAssociations" -> handleListAssociations(request, region);+ case "DescribeMaintenanceWindows" -> handleDescribeMaintenanceWindows(request, region);// Agent registration (internal, not in public SDK)case "UpdateInstanceInformation" -> handleUpdateInstanceInformation(request, region);default -> Response.status(400)@@ -245,6 +249,27 @@ public class SsmJsonHandler {return Response.ok(response).build();}+ private Response handleListDocuments(JsonNode request, String region) {+ // SSM documents are not modeled: return an empty list.+ ObjectNode response = objectMapper.createObjectNode();+ response.set("DocumentIdentifiers", objectMapper.createArrayNode());+ return Response.ok(response).build();+ }++ private Response handleListAssociations(JsonNode request, String region) {+ // SSM associations are not modeled: return an empty list.+ ObjectNode response = objectMapper.createObjectNode();+ response.set("Associations", objectMapper.createArrayNode());+ return Response.ok(response).build();+ }++ private Response handleDescribeMaintenanceWindows(JsonNode request, String region) {+ // Maintenance windows are not modeled: return an empty list.+ ObjectNode response = objectMapper.createObjectNode();+ response.set("WindowIdentities", objectMapper.createArrayNode());+ return Response.ok(response).build();+ }+private Response handleLabelParameterVersion(JsonNode request, String region) {String name = request.path("Name").asText();long parameterVersion = request.path("ParameterVersion").asLong();diff --git a/src/test/java/io/github/hectorvent/floci/services/backup/BackupIntegrationTest.java b/src/test/java/io/github/hectorvent/floci/services/backup/BackupIntegrationTest.javaindex f6cce28cd2..2f14c7593c 100644--- a/src/test/java/io/github/hectorvent/floci/services/backup/BackupIntegrationTest.java+++ b/src/test/java/io/github/hectorvent/floci/services/backup/BackupIntegrationTest.java@@ -82,6 +82,34 @@ class BackupIntegrationTest {.statusCode(400);}+ @Test+ @Order(14)+ void getBackupVaultNotificationsReturnsResourceNotFound() {+ // Notifications are never configured in the emulator; the AWS Backup API returns+ // ResourceNotFoundException (HTTP 400) in that case, which clients branch on.+ given()+ .header("Authorization", AUTH)+ .when()+ .get("/backup-vaults/" + VAULT_NAME + "/notification-configuration")+ .then()+ .statusCode(400)+ .body("__type", equalTo("ResourceNotFoundException"));+ }++ @Test+ @Order(15)+ void getBackupVaultAccessPolicyReturnsResourceNotFound() {+ // Access policy is never configured in the emulator; the AWS Backup API returns+ // ResourceNotFoundException (HTTP 400) in that case, which clients branch on.+ given()+ .header("Authorization", AUTH)+ .when()+ .get("/backup-vaults/" + VAULT_NAME + "/access-policy")+ .then()+ .statusCode(400)+ .body("__type", equalTo("ResourceNotFoundException"));+ }+// ── Plan ───────────────────────────────────────────────────────────────────@Testdiff --git a/src/test/java/io/github/hectorvent/floci/services/docdb/DocDbIntegrationTest.java b/src/test/java/io/github/hectorvent/floci/services/docdb/DocDbIntegrationTest.javaindex 7dc0db4b96..831f4db4a6 100644--- a/src/test/java/io/github/hectorvent/floci/services/docdb/DocDbIntegrationTest.java+++ b/src/test/java/io/github/hectorvent/floci/services/docdb/DocDbIntegrationTest.java@@ -258,6 +258,20 @@ class DocDbIntegrationTest {.body(containsString("DBClusterNotFoundFault"));}+ @Test+ @Order(15)+ void describeClusterSnapshotsReturnsEmptyList() {+ given()+ .header("Authorization", AUTH)+ .contentType(FORM)+ .formParam("Action", "DescribeDBClusterSnapshots")+ .when().post("/")+ .then()+ .statusCode(200)+ .body(containsString("DescribeDBClusterSnapshotsResult"))+ .body(containsString("DBClusterSnapshots"));+ }+@Test@Order(16)void unsupportedAction() {diff --git a/src/test/java/io/github/hectorvent/floci/services/elasticache/ElastiCacheQueryHandlerTest.java b/src/test/java/io/github/hectorvent/floci/services/elasticache/ElastiCacheQueryHandlerTest.javanew file mode 100644index 0000000000..9ff59b059c--- /dev/null+++ b/src/test/java/io/github/hectorvent/floci/services/elasticache/ElastiCacheQueryHandlerTest.java@@ -0,0 +1,64 @@+package io.github.hectorvent.floci.services.elasticache;++import io.github.hectorvent.floci.core.common.RegionResolver;+import io.github.hectorvent.floci.services.elasticache.proxy.SigV4Validator;+import jakarta.ws.rs.core.MultivaluedHashMap;+import jakarta.ws.rs.core.MultivaluedMap;+import jakarta.ws.rs.core.Response;+import org.junit.jupiter.api.BeforeEach;+import org.junit.jupiter.api.Test;++import static org.junit.jupiter.api.Assertions.*;+import static org.mockito.Mockito.mock;++/**+ * Verifies the empty-list read responses for the subnet/parameter group describes, so+ * SDK clients get a valid 200 instead of failing with UnsupportedOperation (400).+ */+class ElastiCacheQueryHandlerTest {++ private ElastiCacheQueryHandler handler;++ @BeforeEach+ void setUp() {+ SigV4Validator sigV4Validator = mock(SigV4Validator.class);+ ElastiCacheService service = mock(ElastiCacheService.class);+ ElastiCacheMemcachedService memcachedService = mock(ElastiCacheMemcachedService.class);+ RegionResolver regionResolver = mock(RegionResolver.class);+ handler = new ElastiCacheQueryHandler(sigV4Validator, service, memcachedService, regionResolver);+ }++ @Test+ void describeCacheSubnetGroups_returnsEmptyWrapperWithoutMarker() {+ Response response = handler.handle("DescribeCacheSubnetGroups", params());++ assertEquals(200, response.getStatus());+ String body = (String) response.getEntity();+ assertTrue(body.contains("<DescribeCacheSubnetGroupsResult><CacheSubnetGroups></CacheSubnetGroups></DescribeCacheSubnetGroupsResult>"),+ "Expected empty CacheSubnetGroups wrapper inside the Result element");+ assertFalse(body.contains("<Marker>"), "Empty list must omit Marker");+ }++ @Test+ void describeCacheParameterGroups_returnsEmptyWrapperWithoutMarker() {+ Response response = handler.handle("DescribeCacheParameterGroups", params());++ assertEquals(200, response.getStatus());+ String body = (String) response.getEntity();+ assertTrue(body.contains("<DescribeCacheParameterGroupsResult><CacheParameterGroups></CacheParameterGroups></DescribeCacheParameterGroupsResult>"),+ "Expected empty CacheParameterGroups wrapper inside the Result element");+ assertFalse(body.contains("<Marker>"), "Empty list must omit Marker");+ }++ @Test+ void unsupportedOperationStillReturnsQueryError() {+ Response response = handler.handle("NoSuchAction", params());++ assertEquals(400, response.getStatus());+ assertTrue(((String) response.getEntity()).contains("UnsupportedOperation"));+ }++ private static MultivaluedMap<String, String> params() {+ return new MultivaluedHashMap<>();+ }+}diff --git a/src/test/java/io/github/hectorvent/floci/services/glue/GlueJsonHandlerEmptyListTest.java b/src/test/java/io/github/hectorvent/floci/services/glue/GlueJsonHandlerEmptyListTest.javanew file mode 100644index 0000000000..bfefd5da46--- /dev/null+++ b/src/test/java/io/github/hectorvent/floci/services/glue/GlueJsonHandlerEmptyListTest.java@@ -0,0 +1,92 @@+package io.github.hectorvent.floci.services.glue;++import com.fasterxml.jackson.databind.JsonNode;+import com.fasterxml.jackson.databind.ObjectMapper;+import io.github.hectorvent.floci.core.common.RegionResolver;+import io.github.hectorvent.floci.core.storage.InMemoryStorage;+import io.github.hectorvent.floci.core.storage.StorageBackend;+import io.github.hectorvent.floci.core.storage.StorageFactory;+import io.github.hectorvent.floci.services.glue.schemaregistry.GlueSchemaRegistryService;+import io.github.hectorvent.floci.services.resourcegroupstagging.ResourceGroupsTaggingService;+import jakarta.ws.rs.core.Response;+import org.junit.jupiter.api.BeforeEach;+import org.junit.jupiter.api.Test;++import com.fasterxml.jackson.core.type.TypeReference;+import java.util.Map;++import static org.junit.jupiter.api.Assertions.assertEquals;+import static org.junit.jupiter.api.Assertions.assertFalse;+import static org.junit.jupiter.api.Assertions.assertTrue;++/**+ * Verifies the wire-accurate empty-list responses for the read-only Glue actions on resources+ * the emulator does not model (GetJobs, GetCrawlers, ListDataQualityRulesets, GetSecurityConfigurations).+ * Each must return HTTP 200, an empty list under its result key, and omit NextToken.+ */+class GlueJsonHandlerEmptyListTest {++ private static final String REGION = "us-east-1";+ private static final String ACCOUNT_ID = "000000000000";++ private GlueJsonHandler handler;+ private ObjectMapper mapper;++ @BeforeEach+ void setUp() {+ mapper = new ObjectMapper();+ RegionResolver regionResolver = new RegionResolver(REGION, ACCOUNT_ID);+ StorageFactory storageFactory = new InMemoryStorageFactory();+ GlueSchemaRegistryService schemaRegistryService =+ new GlueSchemaRegistryService(storageFactory, regionResolver);+ GlueService glueService = new GlueService(+ storageFactory, schemaRegistryService, regionResolver, new ResourceGroupsTaggingService());+ handler = new GlueJsonHandler(glueService, schemaRegistryService, mapper);+ }++ @Test+ void getJobsReturnsEmptyJobsList() throws Exception {+ assertEmptyList("GetJobs", "Jobs");+ }++ @Test+ void getCrawlersReturnsEmptyCrawlersList() throws Exception {+ assertEmptyList("GetCrawlers", "Crawlers");+ }++ @Test+ void listDataQualityRulesetsReturnsEmptyRulesetsList() throws Exception {+ assertEmptyList("ListDataQualityRulesets", "Rulesets");+ }++ @Test+ void getSecurityConfigurationsReturnsEmptyList() throws Exception {+ assertEmptyList("GetSecurityConfigurations", "SecurityConfigurations");+ }++ private void assertEmptyList(String action, String listKey) throws Exception {+ Response response = handler.handle(action, mapper.createObjectNode(), REGION);++ assertEquals(200, response.getStatus());++ JsonNode body = mapper.valueToTree(response.getEntity());+ assertTrue(body.has(listKey), action + " response must contain " + listKey);+ assertTrue(body.get(listKey).isArray(), listKey + " must be a JSON array");+ assertEquals(0, body.get(listKey).size(), listKey + " must be empty");+ assertFalse(body.has("NextToken"), action + " response must omit NextToken");+ assertEquals(1, body.size(), action + " response must contain only " + listKey);+ }++ private static final class InMemoryStorageFactory extends StorageFactory {+ private InMemoryStorageFactory() {+ super(null, null);+ }++ @Override+ public <V> StorageBackend<String, V> create(String serviceName,+ String fileName,+ TypeReference<Map<String, V>> typeReference) {+ return new InMemoryStorage<>();+ }+ }+}diff --git a/src/test/java/io/github/hectorvent/floci/services/iam/IamIntegrationTest.java b/src/test/java/io/github/hectorvent/floci/services/iam/IamIntegrationTest.javaindex 0dadeeb649..a073f95bfb 100644--- a/src/test/java/io/github/hectorvent/floci/services/iam/IamIntegrationTest.java+++ b/src/test/java/io/github/hectorvent/floci/services/iam/IamIntegrationTest.java@@ -404,6 +404,85 @@ class IamIntegrationTest {.body("ListMFADevicesResponse.ListMFADevicesResult.IsTruncated", equalTo("false"));}+ @Test+ @Order(51)+ void getAccessKeyLastUsedReturnsNeverUsedShape() {+ given()+ .formParam("Action", "GetAccessKeyLastUsed")+ .formParam("AccessKeyId", "AKIAEXAMPLE")+ .header("Authorization",+ "AWS4-HMAC-SHA256 Credential=test/20260227/us-east-1/iam/aws4_request")+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .contentType("application/xml")+ .body("GetAccessKeyLastUsedResponse.GetAccessKeyLastUsedResult"+ + ".AccessKeyLastUsed.ServiceName", equalTo("N/A"));+ }++ @Test+ @Order(52)+ void getLoginProfileReturnsNoSuchEntity() {+ given()+ .formParam("Action", "GetLoginProfile")+ .formParam("UserName", "any-user")+ .header("Authorization",+ "AWS4-HMAC-SHA256 Credential=test/20260227/us-east-1/iam/aws4_request")+ .when()+ .post("/")+ .then()+ .statusCode(404)+ .contentType("application/xml")+ .body("ErrorResponse.Error.Code", equalTo("NoSuchEntity"));+ }++ @Test+ @Order(53)+ void listSamlProvidersReturnsEmptyList() {+ given()+ .formParam("Action", "ListSAMLProviders")+ .header("Authorization",+ "AWS4-HMAC-SHA256 Credential=test/20260227/us-east-1/iam/aws4_request")+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .contentType("application/xml")+ .body("ListSAMLProvidersResponse.ListSAMLProvidersResult.SAMLProviderList", isEmptyOrNullString());+ }++ @Test+ @Order(54)+ void listOpenIdConnectProvidersReturnsEmptyList() {+ given()+ .formParam("Action", "ListOpenIDConnectProviders")+ .header("Authorization",+ "AWS4-HMAC-SHA256 Credential=test/20260227/us-east-1/iam/aws4_request")+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .contentType("application/xml")+ .body("ListOpenIDConnectProvidersResponse.ListOpenIDConnectProvidersResult"+ + ".OpenIDConnectProviderList", isEmptyOrNullString());+ }++ @Test+ @Order(55)+ void listServerCertificatesReturnsEmptyPaginatedList() {+ given()+ .formParam("Action", "ListServerCertificates")+ .header("Authorization",+ "AWS4-HMAC-SHA256 Credential=test/20260227/us-east-1/iam/aws4_request")+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .contentType("application/xml")+ .body("ListServerCertificatesResponse.ListServerCertificatesResult.IsTruncated", equalTo("false"));+ }+@Test@Order(10)void createUser() {diff --git a/src/test/java/io/github/hectorvent/floci/services/rds/RdsQueryHandlerTest.java b/src/test/java/io/github/hectorvent/floci/services/rds/RdsQueryHandlerTest.javaindex 9038088f8b..dd058a99b2 100644--- a/src/test/java/io/github/hectorvent/floci/services/rds/RdsQueryHandlerTest.java+++ b/src/test/java/io/github/hectorvent/floci/services/rds/RdsQueryHandlerTest.java@@ -649,6 +649,41 @@ class RdsQueryHandlerTest {assertTrue(body.contains("<DBSubnetGroupArn>arn:aws:rds:us-east-1:123456789012:subgrp:default</DBSubnetGroupArn>"));}+ // ──────────────────────────── Snapshots & Proxies (empty lists) ─────────────++ @Test+ void describeDbSnapshots_returnsEmptyListWith200() {+ Response response = handler.handle("DescribeDBSnapshots", params());++ String body = (String) response.getEntity();+ assertEquals(200, response.getStatus());+ assertTrue(body.contains("<DescribeDBSnapshotsResult>"));+ assertTrue(body.contains("<DBSnapshots></DBSnapshots>"));+ assertFalse(body.contains("<Marker>"));+ }++ @Test+ void describeDbProxies_returnsEmptyListWith200() {+ Response response = handler.handle("DescribeDBProxies", params());++ String body = (String) response.getEntity();+ assertEquals(200, response.getStatus());+ assertTrue(body.contains("<DescribeDBProxiesResult>"));+ assertTrue(body.contains("<DBProxies></DBProxies>"));+ assertFalse(body.contains("<Marker>"));+ }++ @Test+ void describeDbClusterSnapshots_returnsEmptyListWith200() {+ Response response = handler.handle("DescribeDBClusterSnapshots", params());++ String body = (String) response.getEntity();+ assertEquals(200, response.getStatus());+ assertTrue(body.contains("<DescribeDBClusterSnapshotsResult>"));+ assertTrue(body.contains("<DBClusterSnapshots></DBClusterSnapshots>"));+ assertFalse(body.contains("<Marker>"));+ }+// ──────────────────────────── Helpers ────────────────────────────private static MultivaluedMap<String, String> params() {diff --git a/src/test/java/io/github/hectorvent/floci/services/ssm/SsmIntegrationTest.java b/src/test/java/io/github/hectorvent/floci/services/ssm/SsmIntegrationTest.javaindex cedf7cc623..27184ec33f 100644--- a/src/test/java/io/github/hectorvent/floci/services/ssm/SsmIntegrationTest.java+++ b/src/test/java/io/github/hectorvent/floci/services/ssm/SsmIntegrationTest.java@@ -316,6 +316,50 @@ class SsmIntegrationTest {.body("BaselineId", startsWith("pb-"));}+ // ── Read-only list operations for resources not modeled (empty results) ──++ @Test+ void listDocuments_returnsEmptyList() {+ given()+ .header("X-Amz-Target", "AmazonSSM.ListDocuments")+ .contentType(SSM_CONTENT_TYPE)+ .body("{}")+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .body("DocumentIdentifiers.size()", equalTo(0))+ .body("$", not(hasKey("NextToken")));+ }++ @Test+ void listAssociations_returnsEmptyList() {+ given()+ .header("X-Amz-Target", "AmazonSSM.ListAssociations")+ .contentType(SSM_CONTENT_TYPE)+ .body("{}")+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .body("Associations.size()", equalTo(0))+ .body("$", not(hasKey("NextToken")));+ }++ @Test+ void describeMaintenanceWindows_returnsEmptyList() {+ given()+ .header("X-Amz-Target", "AmazonSSM.DescribeMaintenanceWindows")+ .contentType(SSM_CONTENT_TYPE)+ .body("{}")+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .body("WindowIdentities.size()", equalTo(0))+ .body("$", not(hasKey("NextToken")));+ }+@Testvoid unsupportedOperation() {given()