API Microversioning

This patch set adds API microversion support along
with the first API microversion: start/end time for
CONTINUOUS audits.

APIImpact

Implements: blueprint api-microversioning
Depends-On: I6bb838d777b2c7aa799a70485980e5dc87838456
Change-Id: I17309d80b637f02bc5e6d33294472e02add88f86

api-ref/source/parameters.yaml

@@ -191,6 +191,13 @@ audit_autotrigger:
   in: body
   required: false
   type: boolean
+audit_endtime:
+  description: |
+    The time after which audit can't be executed.
+  in: body
+  required: false
+  type: string
+  min_version: 1.1
 audit_goal:
   description: |
     The UUID or name of the Goal.
@@ -229,6 +236,13 @@ audit_parameters:
   in: body
   required: false
   type: JSON
+audit_starttime:
+  description: |
+    The time after which audit can be executed in accordance with interval.
+  in: body
+  required: false
+  type: string
+  min_version: 1.1
 audit_state:
   description: |
     State of this audit. To get more information about states and

api-ref/source/samples/audit-cancel-response.json

@@ -48,5 +48,7 @@
     "strategy_name": "workload_stabilization",
     "next_run_time": "2018-04-06T11:56:00",
     "updated_at": "2018-04-06T11:54:01.266447+00:00",
-    "hostname": "controller"
-}
+    "hostname": "controller",
+    "start_time": null,
+    "end_time": null
+}

api-ref/source/samples/audit-create-request-continuous.json

@@ -8,5 +8,7 @@
         ]
     },
     "audit_type": "CONTINUOUS",
-    "interval": "*/2 * * * *"
-}
+    "interval": "*/2 * * * *",
+    "start_time":"2018-04-02 20:30:00",
+    "end_time": "2018-04-04 20:30:00"
+}

api-ref/source/samples/audit-create-response.json

@@ -48,5 +48,7 @@
     "strategy_name": "workload_stabilization",
     "next_run_time": null,
     "updated_at": null,
-    "hostname": null
-}
+    "hostname": null,
+    "start_time": null,
+    "end_time": null
+}

api-ref/source/samples/audit-list-detailed-response.json

@@ -50,7 +50,9 @@
             "strategy_name": "workload_stabilization",
             "next_run_time": "2018-04-06T09:46:00",
             "updated_at": "2018-04-06T09:44:01.604146+00:00",
-            "hostname": "controller"
+            "hostname": "controller",
+            "start_time": null,
+            "end_time": null
         }
     ]
-}
+}

api-ref/source/samples/audit-show-response.json

@@ -48,5 +48,7 @@
     "strategy_name": "workload_stabilization",
     "next_run_time": "2018-04-06T11:56:00",
     "updated_at": "2018-04-06T11:54:01.266447+00:00",
-    "hostname": "controller"
-}
+    "hostname": "controller",
+    "start_time": null,
+    "end_time": null
+}

api-ref/source/samples/audit-update-response.json

@@ -48,5 +48,7 @@
     "strategy_name": "workload_stabilization",
     "next_run_time": "2018-04-06T11:56:00",
     "updated_at": "2018-04-06T11:54:01.266447+00:00",
-    "hostname": "controller"
-}
+    "hostname": "controller",
+    "start_time": null,
+    "end_time": null
+}

api-ref/source/watcher-api-v1-audits.inc

@@ -46,6 +46,8 @@ Request
    - interval: audit_interval
    - scope: audittemplate_scope
    - auto_trigger: audit_autotrigger
+   - start_time: audit_starttime
+   - end_time: audit_endtime
 
 **Example ONESHOT Audit creation request:**
 
@@ -80,6 +82,8 @@ version 1:
     - scope: audittemplate_scope
     - links: links
     - hostname: audit_hostname
+    - start_time: audit_starttime
+    - end_time: audit_endtime
 
 **Example JSON representation of an Audit:**
 
@@ -176,6 +180,8 @@ Response
     - scope: audittemplate_scope
     - links: links
     - hostname: audit_hostname
+    - start_time: audit_starttime
+    - end_time: audit_endtime
 
 **Example JSON representation of an Audit:**
 
@@ -220,6 +226,8 @@ Response
     - scope: audittemplate_scope
     - links: links
     - hostname: audit_hostname
+    - start_time: audit_starttime
+    - end_time: audit_endtime
 
 **Example JSON representation of an Audit:**
 
@@ -272,6 +280,8 @@ version 1:
     - scope: audittemplate_scope
     - links: links
     - hostname: audit_hostname
+    - start_time: audit_starttime
+    - end_time: audit_endtime
 
 **Example JSON representation of an Audit:**
 
@@ -324,6 +334,8 @@ Response
     - scope: audittemplate_scope
     - links: links
     - hostname: audit_hostname
+    - start_time: audit_starttime
+    - end_time: audit_endtime
 
 **Example JSON representation of an Audit:**
 
@@ -347,4 +359,4 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
-   - audit_ident: audit_ident
+   - audit_ident: audit_ident