Add support for RestoreDBClusterToPointInTime (#194)

Issue #, if available:
aws-controllers-k8s/community#1665

Description of changes:
This PR add support for restoring a `DBCluster` from another cluster, and specifying the type and time for the restore.

It follows the same approach used for restoring a `DBCluster` from a snapshot in #101

Author: MauAraujo

apis/v1alpha1/ack-generate-metadata.yaml

@@ -1,13 +1,13 @@
 ack_generate_info:
-  build_date: "2024-08-29T17:12:38Z"
+  build_date: "2024-09-02T17:25:38Z"
   build_hash: f8f98563404066ac3340db0a049d2e530e5c51cc
   go_version: go1.22.5
   version: v0.38.1
-api_directory_checksum: 721d07f7f5c29de8a1c65268e497be355ee1b3fd
+api_directory_checksum: c6892f99dde0bc4fbc875f328cf37ededd376229
 api_version: v1alpha1
 aws_sdk_go_version: v1.44.232
 generator_config_info:
-  file_checksum: 02d67bd678a59333a653acc2a27ac01e64619ef3
+  file_checksum: 4f7799d67888347f8993c5b20512bd2044a375a9
   original_file_name: generator.yaml
 last_modification:
   reason: API generation

apis/v1alpha1/db_cluster.go

@@ -131,6 +131,22 @@ resources:
         from:
           operation: RestoreDBClusterFromSnapshot
           path: SnapshotIdentifier
+      SourceDBClusterIdentifier:
+        from:
+          operation: RestoreDBClusterToPointInTime
+          path: SourceDBClusterIdentifier
+      RestoreType:
+        from:
+          operation: RestoreDBClusterToPointInTime
+          path: RestoreType
+      RestoreToTime:
+        from:
+          operation: RestoreDBClusterToPointInTime
+          path: RestoreToTime
+      UseLatestRestorableTime:
+        from:
+          operation: RestoreDBClusterToPointInTime
+          path: UseLatestRestorableTime
       Tags:
         compare:
           # We have a custom comparison function...
@@ -180,7 +196,7 @@ resources:
         from:
           operation: ModifyDBClusterParameterGroup
           path: Parameters
-        documentation:  DEPRECATED - do not use.  Prefer ParameterOverrides instead.
+        documentation: DEPRECATED - do not use.  Prefer ParameterOverrides instead.
       ParameterOverrides:
         custom_field:
           # Map keys are the parameter name and the values are the parameter value.
@@ -399,7 +415,7 @@ resources:
         - DBSubnetGroupDoesNotCoverEnoughAZs
         - InvalidSubnet
         - InvalidParameter
-        - SubnetAlreadyInUse 
+        - SubnetAlreadyInUse
     hooks:
       sdk_read_many_post_set_output:
         template_path: hooks/db_subnet_group/sdk_read_many_post_set_output.go.tpl

apis/v1alpha1/generator.yaml

@@ -1028,6 +1028,59 @@ spec:
                   this DB cluster is created as a read replica.
 
 
+                  Valid for: Aurora DB clusters and Multi-AZ DB clusters
+                type: string
+              restoreToTime:
+                description: |-
+                  The date and time to restore the DB cluster to.
+
+
+                  Valid Values: Value must be a time in Universal Coordinated Time (UTC) format
+
+
+                  Constraints:
+
+
+                     * Must be before the latest restorable time for the DB instance
+
+
+                     * Must be specified if UseLatestRestorableTime parameter isn't provided
+
+
+                     * Can't be specified if the UseLatestRestorableTime parameter is enabled
+
+
+                     * Can't be specified if the RestoreType parameter is copy-on-write
+
+
+                  Example: 2015-03-07T23:45:00Z
+
+
+                  Valid for: Aurora DB clusters and Multi-AZ DB clusters
+                format: date-time
+                type: string
+              restoreType:
+                description: |-
+                  The type of restore to be performed. You can specify one of the following
+                  values:
+
+
+                     * full-copy - The new DB cluster is restored as a full copy of the source
+                     DB cluster.
+
+
+                     * copy-on-write - The new DB cluster is restored as a clone of the source
+                     DB cluster.
+
+
+                  Constraints: You can't specify copy-on-write if the engine version of the
+                  source DB cluster is earlier than 1.11.
+
+
+                  If you don't specify a RestoreType value, then the new DB cluster is restored
+                  as a full copy of the source DB cluster.
+
+
                   Valid for: Aurora DB clusters and Multi-AZ DB clusters
                 type: string
               scalingConfiguration:
@@ -1084,6 +1137,19 @@ spec:
                      * Must match the identifier of an existing Snapshot.
 
 
+                  Valid for: Aurora DB clusters and Multi-AZ DB clusters
+                type: string
+              sourceDBClusterIdentifier:
+                description: |-
+                  The identifier of the source DB cluster from which to restore.
+
+
+                  Constraints:
+
+
+                     * Must match the identifier of an existing DBCluster.
+
+
                   Valid for: Aurora DB clusters and Multi-AZ DB clusters
                 type: string
               sourceRegion:
@@ -1138,6 +1204,18 @@ spec:
                       type: string
                   type: object
                 type: array
+              useLatestRestorableTime:
+                description: |-
+                  A value that indicates whether to restore the DB cluster to the latest restorable
+                  backup time. By default, the DB cluster isn't restored to the latest restorable
+                  backup time.
+
+
+                  Constraints: Can't be specified if RestoreToTime parameter is provided.
+
+
+                  Valid for: Aurora DB clusters and Multi-AZ DB clusters
+                type: boolean
               vpcSecurityGroupIDs:
                 description: |-
                   A list of EC2 VPC security groups to associate with this DB cluster.

apis/v1alpha1/zz_generated.deepcopy.go

@@ -131,6 +131,22 @@ resources:
         from:
           operation: RestoreDBClusterFromSnapshot
           path: SnapshotIdentifier
+      SourceDBClusterIdentifier:
+        from:
+          operation: RestoreDBClusterToPointInTime
+          path: SourceDBClusterIdentifier
+      RestoreType:
+        from:
+          operation: RestoreDBClusterToPointInTime
+          path: RestoreType
+      RestoreToTime:
+        from:
+          operation: RestoreDBClusterToPointInTime
+          path: RestoreToTime
+      UseLatestRestorableTime:
+        from:
+          operation: RestoreDBClusterToPointInTime
+          path: UseLatestRestorableTime
       Tags:
         compare:
           # We have a custom comparison function...
@@ -180,7 +196,7 @@ resources:
         from:
           operation: ModifyDBClusterParameterGroup
           path: Parameters
-        documentation:  DEPRECATED - do not use.  Prefer ParameterOverrides instead.
+        documentation: DEPRECATED - do not use.  Prefer ParameterOverrides instead.
       ParameterOverrides:
         custom_field:
           # Map keys are the parameter name and the values are the parameter value.
@@ -399,7 +415,7 @@ resources:
         - DBSubnetGroupDoesNotCoverEnoughAZs
         - InvalidSubnet
         - InvalidParameter
-        - SubnetAlreadyInUse 
+        - SubnetAlreadyInUse
     hooks:
       sdk_read_many_post_set_output:
         template_path: hooks/db_subnet_group/sdk_read_many_post_set_output.go.tpl