1;95;0cMerge branch '7.0-dev' into 7.2-dev

openapi.yaml

@@ -972,6 +972,12 @@ paths:
     $ref: paths/api@servers@[email protected]
   /api/servers/{id}/networkInterfaces/{networkInterfaceId}:
     $ref: paths/api@servers@id@[email protected]
+  /api/servers/{id}/maintenance:
+    $ref: paths/api@servers@[email protected]
+  /api/servers/{id}/leave-maintenance:
+    $ref: paths/api@servers@[email protected]
+  /api/servers/{id}/placement:
+    $ref: paths/api@servers@[email protected]
   /api/servers/change-cloud:
     $ref: paths/api@[email protected]
   /api/catalog/cart:

paths/api@servers@id@leave-maintenance.yaml

@@ -0,0 +1,23 @@
+put:
+  summary: Leave Maintenance Mode
+  description: This will leave maintenance mode on the host. Only available for supported server types such as MVM hosts.
+  operationId: leaveMaintenanceMode
+  tags:
+    - Hosts
+  parameters:
+    - $ref: ../components/parameters/id-path.yaml
+  responses:
+    '200':
+      description: Successful Request
+      content:
+        application/json:
+          schema:
+            $ref: ../components/schemas/200-success.yaml
+          examples:
+            Response:
+              value:
+                $ref: ../components/examples/success.json 
+    '4XX':
+      $ref: ../components/responses/4xx.yaml
+    '5XX':
+      $ref: ../components/responses/5xx.yaml

paths/api@servers@id@maintenance.yaml

@@ -0,0 +1,23 @@
+put:
+  summary: Enable Maintenance Mode
+  description: This will enable maintenance mode on the host. Only available for supported server types such as MVM.
+  operationId: enableMaintenanceMode
+  tags:
+    - Hosts
+  parameters:
+    - $ref: ../components/parameters/id-path.yaml
+  responses:
+    '200':
+      description: Successful Request
+      content:
+        application/json:
+          schema:
+            $ref: ../components/schemas/200-success.yaml
+          examples:
+            Response:
+              value:
+                $ref: ../components/examples/success.json 
+    '4XX':
+      $ref: ../components/responses/4xx.yaml
+    '5XX':
+      $ref: ../components/responses/5xx.yaml

paths/api@servers@id@placement.yaml

@@ -0,0 +1,48 @@
+put:
+  summary: Manage Host Placement
+  description: This will update the host placement settings for the virtual machine. Only available for supported server types such as MVM virtual machines.
+  operationId: serverMaintenanceMode
+  tags:
+    - Hosts
+  parameters:
+    - $ref: ../components/parameters/id-path.yaml
+  requestBody: 
+    content: 
+      application/json: 
+        schema:
+          type: object
+          properties:
+            server:
+              type: object
+              properties:
+                name: 
+                  type: string
+                  description: Placement Strategy
+                  enum:
+                    - auto
+                    - failover
+                    - pinned
+                preferredServer:
+                  type: object
+                  description: Object containing id of preferred target host to place VM on
+                  properties:
+                    id:
+                      type: integer
+                      format: int64
+                      example: 1
+                      description: Server ID
+  responses:
+    '200':
+      description: Successful Request
+      content:
+        application/json:
+          schema:
+            $ref: ../components/schemas/200-success.yaml
+          examples:
+            Response:
+              value:
+                $ref: ../components/examples/success.json 
+    '4XX':
+      $ref: ../components/responses/4xx.yaml
+    '5XX':
+      $ref: ../components/responses/5xx.yaml