Skip to content

armgit / floci

Public Imported from GitHub
0

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

feat(route53): update supported operations and add VPC association actions (#2959)

Matheus Andrédf0e7bc79c12
diff --git a/docs/services/index.md b/docs/services/index.md
index f5d882df10..706573d4e5 100644
--- a/docs/services/index.md
+++ b/docs/services/index.md
@@ -98,7 +98,7 @@ Operation counts are exact. For dispatch-table services (Query and JSON 1.1) eac
| [AWS FIS](fis.md) | `/experimentTemplates/*`, `/experiments/*`, `/actions/*`, `/targetResourceTypes/*`, `/safetyLevers/*`, `/tags/*` | REST JSON | 26 |
| [CodeGuru Reviewer](codegurureviewer.md) | `/associations`, `/associations/{associationArn}`, `/tags/*` | REST JSON | 7 |
| [CloudFront](cloudfront.md) | `/2020-05-31/distribution/*`, `/2020-05-31/cache-policy/*`, `/2020-05-31/function/*` | REST XML | 50 |
-| [Route53](route53.md) | `/2013-04-01/hostedzone/*`, `/2013-04-01/healthcheck/*`, `/2013-04-01/change/*` | REST XML | 17 |
+| [Route53](route53.md) | `/2013-04-01/hostedzone/*`, `/2013-04-01/healthcheck/*`, `/2013-04-01/change/*` | REST XML | 25 |
| [Route 53 Resolver](route53resolver.md) | `POST /` + `X-Amz-Target: Route53Resolver.*` | JSON 1.1 | 18 |
| [Cloud Map](cloudmap.md) | `POST /` + `X-Amz-Target: Route53AutoNaming_v20170314.*` | JSON 1.1 | 22 |
| [AWS Config](config.md) | `POST /` + `X-Amz-Target: StarlingDoveService.*` | JSON 1.1 | 33 |
diff --git a/docs/services/route53.md b/docs/services/route53.md
index 7964ae375c..bc1233e220 100644
--- a/docs/services/route53.md
+++ b/docs/services/route53.md
@@ -4,25 +4,35 @@ Route53 management-plane emulation. Supports hosted zones, resource record sets,
## Supported Operations
-| Operation | Method | Path |
-|---|---|---|
-| CreateHostedZone | POST | `/2013-04-01/hostedzone` |
-| GetHostedZone | GET | `/2013-04-01/hostedzone/{Id}` |
-| DeleteHostedZone | DELETE | `/2013-04-01/hostedzone/{Id}` |
-| ListHostedZones | GET | `/2013-04-01/hostedzone` |
-| ListHostedZonesByName | GET | `/2013-04-01/hostedzonesbyname` |
-| GetHostedZoneCount | GET | `/2013-04-01/hostedzonecount` |
-| ChangeResourceRecordSets | POST | `/2013-04-01/hostedzone/{Id}/rrset` |
-| ListResourceRecordSets | GET | `/2013-04-01/hostedzone/{Id}/rrset` |
-| GetChange | GET | `/2013-04-01/change/{Id}` |
-| CreateHealthCheck | POST | `/2013-04-01/healthcheck` |
-| GetHealthCheck | GET | `/2013-04-01/healthcheck/{HealthCheckId}` |
-| DeleteHealthCheck | DELETE | `/2013-04-01/healthcheck/{HealthCheckId}` |
-| ListHealthChecks | GET | `/2013-04-01/healthcheck` |
-| UpdateHealthCheck | POST | `/2013-04-01/healthcheck/{HealthCheckId}` |
-| ListTagsForResource | GET | `/2013-04-01/tags/{ResourceType}/{ResourceId}` |
-| ChangeTagsForResource | POST | `/2013-04-01/tags/{ResourceType}/{ResourceId}` |
-| GetAccountLimit | GET | `/2013-04-01/accountlimit/{Type}` |
+<!-- floci:actions:start -->
+| Action | Description |
+| --- | --- |
+| `CreateHostedZone` | `POST /2013-04-01/hostedzone`. A `<VPC>` element in the request creates a private zone and records the first VPC association. |
+| `GetHostedZone` | `GET /2013-04-01/hostedzone/{Id}`. Private zones include their `<VPCs>` list. |
+| `DeleteHostedZone` | `DELETE /2013-04-01/hostedzone/{Id}` |
+| `ListHostedZones` | `GET /2013-04-01/hostedzone` |
+| `ListHostedZonesByName` | `GET /2013-04-01/hostedzonesbyname` |
+| `AssociateVPCWithHostedZone` | `POST /2013-04-01/hostedzone/{Id}/associatevpc`. Private zones only; re-associating an attached VPC is a no-op. |
+| `DisassociateVPCFromHostedZone` | `POST /2013-04-01/hostedzone/{Id}/disassociatevpc`. Refuses to remove the last association (`LastVPCAssociation`). |
+| `CreateVPCAssociationAuthorization` | `POST /2013-04-01/hostedzone/{Id}/authorizevpcassociation`. Validates and echoes the VPC; zones are not account-scoped, so no authorization is enforced. |
+| `DeleteVPCAssociationAuthorization` | `POST /2013-04-01/hostedzone/{Id}/deauthorizevpcassociation` |
+| `ListHostedZonesByVPC` | `GET /2013-04-01/hostedzonesbyvpc?vpcid=…&vpcregion=…`. Paginates with `maxitems` / `nexttoken`. |
+| `GetHostedZoneCount` | `GET /2013-04-01/hostedzonecount` |
+| `ChangeResourceRecordSets` | `POST /2013-04-01/hostedzone/{Id}/rrset` |
+| `ListResourceRecordSets` | `GET /2013-04-01/hostedzone/{Id}/rrset` |
+| `GetChange` | `GET /2013-04-01/change/{Id}` |
+| `CreateHealthCheck` | `POST /2013-04-01/healthcheck` |
+| `GetHealthCheck` | `GET /2013-04-01/healthcheck/{HealthCheckId}` |
+| `DeleteHealthCheck` | `DELETE /2013-04-01/healthcheck/{HealthCheckId}` |
+| `ListHealthChecks` | `GET /2013-04-01/healthcheck` |
+| `UpdateHealthCheck` | `POST /2013-04-01/healthcheck/{HealthCheckId}` |
+| `ListTagsForResource` | `GET /2013-04-01/tags/{ResourceType}/{ResourceId}` |
+| `ChangeTagsForResource` | `POST /2013-04-01/tags/{ResourceType}/{ResourceId}` |
+| `GetAccountLimit` | `GET /2013-04-01/accountlimit/{Type}` |
+| `GetHealthCheckStatus` | `GET /2013-04-01/healthcheck/{HealthCheckId}/status` |
+| `GetDNSSEC` | `GET /2013-04-01/hostedzone/{Id}/dnssec`. Always reports signing as `NOT_SIGNING`. |
+| `GetHostedZoneLimit` | `GET /2013-04-01/hostedzonelimit/{HostedZoneId}/{Type}` |
+<!-- floci:actions:end -->
## Behavior
@@ -34,6 +44,9 @@ Route53 management-plane emulation. Supports hosted zones, resource record sets,
- Hosted zone IDs are returned with the `/hostedzone/` prefix in XML responses (e.g. `/hostedzone/Z1PA6795UKMFR9`). The AWS SDK strips this prefix client-side.
- Health check IDs are plain UUIDs without a prefix.
- Tags are supported for both `hostedzone` and `healthcheck` resource types.
+- A hosted zone is private when `CreateHostedZone` carries a `<VPC>` element; `HostedZoneConfig.PrivateZone` is response-only.
+- `AssociateVPCWithHostedZone` rejects public zones with `PublicZoneVPCAssociation`, and `DisassociateVPCFromHostedZone` rejects removing the last VPC with `LastVPCAssociation`.
+- Associating a VPC that is already attached to another zone with the same name fails with `ConflictingDomainExists`.
## Default Nameservers
@@ -100,6 +113,26 @@ aws route53 create-health-check \
"ResourcePath": "/health"
}'
+# Create a private hosted zone attached to a VPC
+aws route53 create-hosted-zone \
+ --name internal.example.com \
+ --caller-reference "$(date +%s)" \
+ --vpc VPCRegion=us-east-1,VPCId=vpc-0123456789abcdef0
+
+# Attach a second VPC to the private zone
+aws route53 associate-vpc-with-hosted-zone \
+ --hosted-zone-id Z1PA6795UKMFR9 \
+ --vpc VPCRegion=us-east-1,VPCId=vpc-0fedcba9876543210
+
+# List the private zones attached to a VPC
+aws route53 list-hosted-zones-by-vpc \
+ --vpc-id vpc-0fedcba9876543210 --vpc-region us-east-1
+
+# Detach a VPC (the last association cannot be removed)
+aws route53 disassociate-vpc-from-hosted-zone \
+ --hosted-zone-id Z1PA6795UKMFR9 \
+ --vpc VPCRegion=us-east-1,VPCId=vpc-0fedcba9876543210
+
# Delete a hosted zone
aws route53 delete-hosted-zone --id Z1PA6795UKMFR9
```
@@ -108,7 +141,7 @@ aws route53 delete-hosted-zone --id Z1PA6795UKMFR9
- Reusable delegation sets
- Traffic policies and traffic policy instances
-- VPC association (private hosted zones)
+- Cross-account VPC association authorization (zones are not account-scoped, so `CreateVPCAssociationAuthorization` is accepted but not enforced)
- Query logging configs
- DNSSEC (key signing keys, enabling/disabling)
- `TestDNSAnswer`
diff --git a/tools/docs/services.yaml b/tools/docs/services.yaml
index b0951d7e7b..a6bdb971f7 100644
--- a/tools/docs/services.yaml
+++ b/tools/docs/services.yaml
@@ -166,6 +166,18 @@ services:
# SubnetIds / VpcSecurityGroupIds / TagKeys are labels of an inner member-name
# switch (memberKeyRegex), not actions — same shape as the rds exclusions above.
exclude_actions: [SubnetIds, VpcSecurityGroupIds, TagKeys]
+ - service: route53
+ doc: docs/services/route53.md
+ sources:
+ - { path: src/main/java/io/github/hectorvent/floci/services/route53/Route53Controller.java, mode: rest }
+ # JAX-RS method names use Java casing; map them onto the canonical Route 53 action names.
+ rename_actions:
+ AssociateVpcWithHostedZone: AssociateVPCWithHostedZone
+ DisassociateVpcFromHostedZone: DisassociateVPCFromHostedZone
+ CreateVpcAssociationAuthorization: CreateVPCAssociationAuthorization
+ DeleteVpcAssociationAuthorization: DeleteVPCAssociationAuthorization
+ ListHostedZonesByVpc: ListHostedZonesByVPC
+ GetDnssec: GetDNSSEC
- service: route53resolver
doc: docs/services/route53resolver.md
sources: