feat: update the readme and integration tests

Author: 0xdsqr

packages/@aws-cdk-testing/framework-integ/test/aws-route53/test/integ.failover-record.ts

@@ -0,0 +1,52 @@
+import { App, Duration, Stack, StackProps } from 'aws-cdk-lib';
+import { Construct } from 'constructs';
+import * as route53 from 'aws-cdk-lib/aws-route53';
+import { IntegTest } from '@aws-cdk/integ-tests-alpha';
+
+class TestStack extends Stack {
+  constructor(scope: Construct, id: string, props?: StackProps) {
+    super(scope, id, props);
+
+    const hostedZone = new route53.PublicHostedZone(this, 'HostedZone', {
+      zoneName: 'cdk.dev',
+    });
+
+    const healthCheck = new route53.HealthCheck(this, 'HealthCheck', {
+      type: route53.HealthCheckType.HTTP,
+      fqdn: 'example.com',
+      port: 80,
+      resourcePath: '/health',
+      failureThreshold: 3,
+      requestInterval: Duration.seconds(30),
+    });
+
+    // Primary failover record with health check
+    new route53.ARecord(this, 'ARecordFailoverPrimary', {
+      zone: hostedZone,
+      recordName: 'failover',
+      target: route53.RecordTarget.fromIpAddresses('1.2.3.4'),
+      failover: route53.Failover.PRIMARY,
+      healthCheck,
+      setIdentifier: 'failover-primary',
+      ttl: Duration.seconds(60),
+    });
+
+    // Secondary failover record
+    new route53.ARecord(this, 'ARecordFailoverSecondary', {
+      zone: hostedZone,
+      recordName: 'failover',
+      target: route53.RecordTarget.fromIpAddresses('5.6.7.8'),
+      failover: route53.Failover.SECONDARY,
+      setIdentifier: 'failover-secondary',
+      ttl: Duration.seconds(60),
+    });
+  }
+}
+
+const app = new App();
+const stack = new TestStack(app, 'failover-record');
+
+new IntegTest(app, 'Route53FailoverRecordInteg', {
+  testCases: [stack],
+});
+app.synth();

packages/aws-cdk-lib/aws-route53/README.md

@@ -216,6 +216,36 @@ new route53.ARecord(this, 'ARecordLatency1', {
 });
 ```
 
+To enable [failover routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy-failover.html), use the `failover` parameter:
+
+```ts
+declare const myZone: route53.HostedZone;
+
+const healthCheck = new route53.HealthCheck(this, 'HealthCheck', {
+  type: route53.HealthCheckType.HTTP,
+  fqdn: 'example.com',
+  port: 80,
+  resourcePath: '/health',
+  failureThreshold: 3,
+  requestInterval: Duration.seconds(30),
+});
+
+new route53.ARecord(this, 'ARecordFailoverPrimary', {
+  zone: myZone,
+  target: route53.RecordTarget.fromIpAddresses('1.2.3.4'),
+  failover: route53.Failover.PRIMARY,
+  healthCheck,
+  setIdentifier: 'failover-primary',
+});
+
+new route53.ARecord(this, 'ARecordFailoverSecondary', {
+  zone: myZone,
+  target: route53.RecordTarget.fromIpAddresses('5.6.7.8'),
+  failover: route53.Failover.SECONDARY,
+  setIdentifier: 'failover-secondary',
+});
+```
+
 To enable [multivalue answer routing](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy-multivalue.html), use the `multivalueAnswer` parameter:
 
 ```ts