Implement Stage resource (#11)

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

Description of changes:

Implements support for creating `Stage` resources in API Gateway.

This is based off the `cPu1:resource/integration` branch and must be reviewed after merging #10. 

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

Author: cPu1

apis/v1alpha1/ack-generate-metadata.yaml

@@ -1,13 +1,13 @@
 ack_generate_info:
-  build_date: "2024-10-01T23:08:59Z"
+  build_date: "2024-10-01T23:40:20Z"
   build_hash: f8f98563404066ac3340db0a049d2e530e5c51cc
   go_version: go1.22.5
   version: v0.38.1
-api_directory_checksum: 432afd93573dfe74a6c14986217b9dc4cf038b35
+api_directory_checksum: 384f1a5b6a0daffcccbca3122cb095b288963990
 api_version: v1alpha1
 aws_sdk_go_version: v1.55.0
 generator_config_info:
-  file_checksum: 296561b679a8de658cca9713d3e98d893911a818
+  file_checksum: c096c3640019de8c8b01e6f0e4fbb2163e97e99e
   original_file_name: generator.yaml
 last_modification:
   reason: API generation

apis/v1alpha1/generator.yaml

@@ -16,7 +16,7 @@ ignore:
     - RequestValidator
 #    - Resource
 #    - RestApi
-    - Stage
+#    - Stage
     - UsagePlan
     - UsagePlanKey
 #    - VpcLink
@@ -164,3 +164,35 @@ resources:
         - ConflictException
         - NotFoundException
         - InvalidParameter
+  # Fields AccessLogSettings and ClientCertificateId are not in the Create API. Support for them will be added based on
+  # customer interest.
+  Stage:
+    fields:
+      RestAPIID:
+        references:
+          resource: RestAPI
+          path: Status.ID
+        is_required: true
+        is_immutable: true
+      StageName:
+        is_required: true
+        is_immutable: true
+    synced:
+      when:
+        - path: Status.CacheClusterStatus
+          in:
+            - AVAILABLE
+            - NOT_AVAILABLE
+    hooks:
+      sdk_update_pre_build_request:
+        template_path: hooks/stage/sdk_update_pre_build_request.go.tpl
+      sdk_update_post_build_request:
+        template_path: hooks/stage/sdk_update_post_build_request.go.tpl
+      delta_pre_compare:
+        code: customPreCompare(a, b)
+    exceptions:
+      terminal_codes:
+        - BadRequestException
+        - ConflictException
+        - NotFoundException
+        - InvalidParameter