Multi-sources: Add agent data model and endpoint definition for multi sources

api/v1alpha1/agent/openapi.yaml

@@ -53,6 +53,42 @@ paths:
             application/json:
               schema:
                 $ref: '../openapi.yaml#/components/schemas/Error'
+  /api/v1/agents/{id}/status:
+    put:
+      tags:
+        - agent
+      description: update status of the agent
+      operationId: updateAgentStatus
+      parameters:
+        - name: id
+          in: path
+          description: ID the agent
+          required: true
+          schema:
+            type: string
+            format: uuid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AgentStatusUpdate'
+      responses:
+        "200":
+          description: OK
+        "201":
+          description: OK
+        "401":
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '../openapi.yaml#/components/schemas/Error'
+        "410":
+          description: Gone
+          content:
+            application/json:
+              schema:
+                $ref: '../openapi.yaml#/components/schemas/Error'
   /health:
     get:
       tags:
@@ -80,3 +116,19 @@ components:
         - status
         - statusInfo
         - credentialUrl
+    AgentStatusUpdate:
+      type: object
+      properties:
+        id:
+          type: string
+        status:
+          type: string
+        statusInfo:
+          type: string
+        credentialUrl:
+          type: string
+      required:
+        - status
+        - statusInfo
+        - credentialUrl
+        - id

api/v1alpha1/common.go

@@ -16,3 +16,20 @@ func StringToSourceStatus(s string) SourceStatus {
 		return SourceStatusNotConnected
 	}
 }
+
+func StringToAgentStatus(s string) AgentStatus {
+	switch s {
+	case string(AgentStatusError):
+		return AgentStatusError
+	case string(AgentStatusGatheringInitialInventory):
+		return AgentStatusGatheringInitialInventory
+	case string(AgentStatusUpToDate):
+		return AgentStatusUpToDate
+	case string(AgentStatusWaitingForCredentials):
+		return AgentStatusWaitingForCredentials
+	case string(AgentStatusNotConnected):
+		return AgentStatusNotConnected
+	default:
+		return AgentStatusNotConnected
+	}
+}

api/v1alpha1/openapi.yaml

@@ -199,6 +199,25 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
+  /api/v1/agents:
+    get:
+      tags:
+        - agent
+      description: list agents
+      operationId: listAgents
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AgentList"
+        "401":
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
   /health:
     get:
       tags:
@@ -442,3 +461,36 @@ components:
             type: string
           count:
             type: integer
+
+    Agent:
+      type: object
+      properties:
+        id:
+          type: string
+        status:
+          type: string
+          enum: [not-connected, waiting-for-credentials, error, gathering-initial-inventory, up-to-date, source-gone]
+        statusInfo:
+          type: string
+        credentialUrl:
+          type: string
+        sourceId:
+          type: string
+        createdAt:
+          type: string
+          format: date-time
+        updatedAt:
+          type: string
+          format: date-time
+      required:
+        - id
+        - status
+        - statusInfo
+        - credentialUrl
+        - createdAt
+        - updatedAt
+
+    AgentList:
+      type: array
+      items:
+        $ref: '#/components/schemas/Agent'