Add new overlays (#24)

* Address coderabbit suggestion on removing internal only value NETWORK_ACCESS_MODE_UNSPECIFIED

* RESOURCE_TYPE_ANY is not available when creating a new ACL

* Tiny changes to force deploy preview with overlays applied

* Fix JSONPath

* Apply suggestions from automated review

* Fix workflow errors

* Fix syntax error

* Try using a new component schema instead

* Fix api_gateway_access

* Note about manually updating resource types

---------

Co-authored-by: Kat Batuigas <kbauigas@gmail.com>

Author: kbatuigas

cloud-controlplane/overlays/update-api-gateway-access.yaml

@@ -0,0 +1,12 @@
+# This overlay updates the Cluster object in response examples to only use a 
+# user-facing value for the api_gateway_access field.
+overlay: 1.0.0
+info:
+  title: Update API Gateway Access Values in Response Examples
+  version: 1.0.0
+
+actions:
+  # Target api_gateway_access fields that are descendants of any example field within responses
+  - target: "$..responses..example..*[?(@.api_gateway_access == 'NETWORK_ACCESS_MODE_UNSPECIFIED')]"
+    update:
+      api_gateway_access: "NETWORK_ACCESS_MODE_PUBLIC"

cloud-dataplane/cloud-dataplane.yaml

@@ -683,7 +683,7 @@ components:
             { "reason": "API_DISABLED"
               "domain": "googleapis.com"
               "metadata": {
-                "resource": "projects/123",
+                "resource": "projects/1234",
                 "service": "pubsub.googleapis.com"
               }
             }

cloud-dataplane/overlays/remove-resource-type-any.yaml

@@ -0,0 +1,30 @@
+# This overlay removes the RESOURCE_TYPE_ANY value as an available option for the 
+# resource_type field in the CreateACLRequest schema.
+overlay: 1.0.0
+info:
+  title: Remove RESOURCE_TYPE_ANY from Create ACL Request Body
+  version: 1.0.0
+
+# Note that we will have to manually update this enum if the Cloud team adds
+# new resource types in the future.
+actions:
+  - target: "$.components.schemas"
+    update:
+      CreateACLResourceType:
+        description: |-
+          The type of resource (topic, consumer group, etc.) this
+          ACL targets.
+        enum:
+          - "RESOURCE_TYPE_TOPIC"
+          - "RESOURCE_TYPE_GROUP"
+          - "RESOURCE_TYPE_CLUSTER"
+          - "RESOURCE_TYPE_TRANSACTIONAL_ID"
+          - "RESOURCE_TYPE_DELEGATION_TOKEN"
+          - "RESOURCE_TYPE_USER"
+          - "RESOURCE_TYPE_REGISTRY"
+          - "RESOURCE_TYPE_SUBJECT"
+        type: "string"
+  # Replace the $ref with an inline enum that excludes RESOURCE_TYPE_ANY
+  - target: "$.components.schemas.CreateACLRequest.properties.resource_type"
+    update:
+      $ref: '#/components/schemas/CreateACLResourceType'