chore(openapi): update connector-mgmt/v1 OpenAPI document (#106)

Co-authored-by: app-services-ci <app-services-ci@users.noreply.github.com>

Author: app-services-ci

.openapi/connector_mgmt.yaml

@@ -71,7 +71,7 @@ paths:
                   $ref: "#/components/examples/500Example"
           description: Unexpected error occurred
       security:
-        - Bearer: []
+        - Bearer: [ ]
       operationId: getConnectorTypeByID
       summary: Get a connector type by id
 
@@ -80,7 +80,7 @@ paths:
       tags:
         - Connector Types
       security:
-        - Bearer: []
+        - Bearer: [ ]
       operationId: listConnectorTypes
       summary: Returns a list of connector types
       parameters:
@@ -174,7 +174,7 @@ paths:
                   $ref: "#/components/examples/500Example"
           description: An unexpected error occurred creating the connector
       security:
-        - Bearer: []
+        - Bearer: [ ]
       summary: Create a new connector
     get:
       tags:
@@ -213,7 +213,7 @@ paths:
                   $ref: "#/components/examples/500Example"
           description: Unexpected error occurred
       security:
-        - Bearer: []
+        - Bearer: [ ]
       operationId: listConnectors
       summary: Returns a list of connector types
   "/api/connector_mgmt/v1/kafka_connectors/{id}":
@@ -262,7 +262,7 @@ paths:
                   $ref: "#/components/examples/500Example"
           description: Unexpected error occurred
       security:
-        - Bearer: []
+        - Bearer: [ ]
       operationId: getConnector
       summary: Get a connector
     delete:
@@ -303,7 +303,7 @@ paths:
                   $ref: "#/components/examples/500DeleteExample"
           description: Unexpected error occurred
       security:
-        - Bearer: []
+        - Bearer: [ ]
       operationId: deleteConnector
       summary: Delete a connector
     patch:
@@ -344,19 +344,21 @@ paths:
                   $ref: "#/components/examples/500Example"
           description: Unexpected error occurred
       security:
-        - Bearer: []
+        - Bearer: [ ]
       operationId: patchConnector
       summary: patch a connector
       requestBody:
         description: Data to patch the connector with
         content:
-          application/json-patch+json:
+          application/json:
             schema:
-              description: A JSON Patch, RFC 6902 - https://tools.ietf.org/html/rfc6902
-              type: object
+              $ref: "#/components/schemas/Connector"
           application/merge-patch+json:
             schema:
-              description: A JSON Merge Patch, RFC 7386 - https://tools.ietf.org/html/rfc7386
+              $ref: "#/components/schemas/Connector"
+          application/json-patch+json:
+            schema:
+              description: A JSON Patch, RFC 6902 - https://tools.ietf.org/html/rfc6902
               type: object
         required: true
 
@@ -424,7 +426,7 @@ paths:
                   $ref: "#/components/examples/500Example"
           description: An unexpected error occurred creating the connector cluster
       security:
-        - Bearer: []
+        - Bearer: [ ]
       summary: Create a new connector cluster
     get:
       tags:
@@ -458,7 +460,7 @@ paths:
                   $ref: "#/components/examples/500Example"
           description: Unexpected error occurred
       security:
-        - Bearer: []
+        - Bearer: [ ]
       operationId: listConnectorClusters
       summary: Returns a list of connector clusters
   /api/connector_mgmt/v1/kafka_connector_clusters/{connector_cluster_id}:
@@ -507,7 +509,7 @@ paths:
                   $ref: "#/components/examples/500Example"
           description: Unexpected error occurred
       security:
-        - Bearer: []
+        - Bearer: [ ]
       operationId: getConnectorCluster
       summary: Get a connector cluster
     delete:
@@ -548,11 +550,11 @@ paths:
                   $ref: "#/components/examples/500DeleteExample"
           description: Unexpected error occurred
       security:
-        - Bearer: []
+        - Bearer: [ ]
       operationId: deleteConnectorCluster
       summary: Delete a connector cluster
-  ? /api/connector_mgmt/v1/kafka_connector_clusters/{connector_cluster_id}/addon_parameters
-  : parameters:
+  /api/connector_mgmt/v1/kafka_connector_clusters/{connector_cluster_id}/addon_parameters:
+    parameters:
       - name: connector_cluster_id
         description: The id of the connector cluster
         schema:
@@ -597,7 +599,7 @@ paths:
                   $ref: "#/components/examples/500Example"
           description: Unexpected error occurred
       security:
-        - Bearer: []
+        - Bearer: [ ]
       operationId: getConnectorClusterAddonParameters
       summary: Get a connector cluster's addon parameters
 
@@ -636,13 +638,12 @@ components:
               type: array
               items:
                 type: string
-                enum: [sink, source]
+                enum: [ sink, source ]
             json_schema:
               description: >-
                 A json schema that can be used to validate a connectors
                 connector_spec field.
               type: object # todo: replace with better type
-
     ConnectorTypeList:
       allOf:
         - $ref: "#/components/schemas/List"
@@ -651,8 +652,7 @@ components:
             items:
               type: array
               items:
-                allOf:
-                  - $ref: "#/components/schemas/ConnectorType"
+                $ref: "#/components/schemas/ConnectorType"
 
     ConnectorList:
       allOf:
@@ -662,8 +662,7 @@ components:
             items:
               type: array
               items:
-                allOf:
-                  - $ref: "#/components/schemas/Connector"
+                $ref: "#/components/schemas/Connector"
 
     Connector:
       description: A connector holds the configuration to connect a Kafka topic to another system.
@@ -744,8 +743,7 @@ components:
       description: "A list of addon parameters"
       type: array
       items:
-        allOf:
-          - $ref: "#/components/schemas/AddonParameter"
+        $ref: "#/components/schemas/AddonParameter"
 
     AddonParameter:
       description: "A addon parameter"
@@ -786,8 +784,7 @@ components:
             items:
               type: array
               items:
-                allOf:
-                  - $ref: "#/components/schemas/ConnectorCluster"
+                $ref: "#/components/schemas/ConnectorCluster"
 
     KafkaConnectionSettings:
       properties: