Add servers and tags objects with overlays

Author: Kat Batuigas

admin/overlays/update-tags.yaml renamed to admin/v1-overlays/update-tags.yaml

@@ -0,0 +1,12 @@
+# This overlay adds the servers object to the Redpanda Admin API v2 specification.
+
+overlay: 1.0.0
+info:
+  title: Admin API v2 Servers
+  version: v1
+
+actions:
+  - target: "$"
+    update:
+      servers:
+        - url: http://localhost:9644

admin/v2-overlays/add-servers-object.yaml

@@ -0,0 +1,61 @@
+# This overlay extends the Redpanda Admin API specification by creating an
+# end-user facing list of tags and applying them to the relevant endpoints.
+overlay: 1.0.0
+info:
+  title: Redpanda Admin API v2 Tags
+  version: 1.0.0
+
+actions:
+  # Add tags object to the root level
+  - target: "$"
+    update:
+      tags:
+        - name: Brokers
+          description: See details about brokers in a Redpanda cluster, including client connections.
+        - name: Shadow Links
+          description: Manage shadow links for migration and disaster recovery.
+  
+  # Rename BrokerService endpoint tags
+  - target: "$.paths.*.*.tags[?(@ == 'BrokerService')]"
+    update: "Brokers"
+  
+  # Rename ShadowLinkService endpoint tags
+  - target: "$.paths.*.*.tags[?(@ == 'ShadowLinkService')]"
+    update: "Shadow Links"
+
+
+  # # Rename BrokerService endpoint tags
+  # - target: "$.paths['/redpanda.core.admin.v2.BrokerService/GetBroker'].post.tags"
+  #   update:
+  #     - "Brokers"
+  
+  # - target: "$.paths['/redpanda.core.admin.v2.BrokerService/ListBrokers'].post.tags"
+  #   update:
+  #     - "Brokers"
+      
+  # - target: "$.paths['/redpanda.core.admin.v2.BrokerService/ListKafkaConnections'].post.tags"
+  #   update:
+  #     - "Brokers"
+
+  # # Rename ShadowLinkService endpoint tags
+  # - target: "$.paths['/redpanda.core.admin.v2.ShadowLinkService/CreateShadowLink'].post.tags"
+  #   update:
+  #     - "Shadow Links"
+      
+  # - target: "$.paths['/redpanda.core.admin.v2.ShadowLinkService/UpdateShadowLink'].post.tags"
+  #   update:
+  #     - "Shadow Links"
+      
+  # - target: "$.paths['/redpanda.core.admin.v2.ShadowLinkService/DeleteShadowLink'].post.tags"
+  #   update:
+  #     - "Shadow Links"
+      
+  # - target: "$.paths['/redpanda.core.admin.v2.ShadowLinkService/ListShadowLinks'].post.tags"
+  #   update:
+  #     - "Shadow Links"
+      
+  # - target: "$.paths['/redpanda.core.admin.v2.ShadowLinkService/GetShadowLink'].post.tags"
+  #   update:
+  #     - "Shadow Links"
+
+