Add api for privileged

Change-Id: I998cca8290a01744fa809d21091e1cb94dfe1ea0
Implements: blueprint support-zun-create-privileged

api-ref/source/containers.inc

@@ -58,6 +58,7 @@ Request
   - availability_zone: container_availability_zone
   - hints: hints
   - mounts: mounts
+  - privileged: privileged-request
 
 Request Example
 ----------------
@@ -95,6 +96,7 @@ Response
   - ports: ports
   - auto_remove: auto_remove
   - auto_heal: auto_heal
+  - privileged: privileged
 
 
 Response Example
@@ -166,6 +168,7 @@ Response
   - task_state: task_state
   - status_reason: status_reason
   - ports: ports
+  - privileged: privileged
 
 Response Example
 ----------------
@@ -228,6 +231,7 @@ Response
   - task_state: task_state
   - status_reason: status_reason
   - ports: ports
+  - privileged: privileged
 
 Response Example
 ----------------
@@ -428,6 +432,7 @@ Return new container with updated attributes.
   - task_state: task_state
   - status_reason: status_reason
   - ports: ports
+  - privileged: privileged
 
 Response Example
 ----------------

api-ref/source/parameters.yaml

@@ -769,6 +769,18 @@ ports:
   in: body
   required: true
   type: string
+privileged:
+  description: |
+    Give extended privileges to the container.
+  in: body
+  required: true
+  type: boolean
+privileged-request:
+  description: |
+    Give extended privileges to the container.
+  in: body
+  required: false
+  type: boolean
 project_id_container_action:
   description: |
     The UUID of the project that this container belongs to.

api-ref/source/samples/container-create-req.json

@@ -42,5 +42,6 @@
             "source": "myvol",
             "destination": "/data"
         }
-    ]
+    ],
+    "privileged": false
 }

api-ref/source/samples/container-create-resp.json

@@ -39,6 +39,7 @@
     "hostname": "testhost",
     "auto_remove": false,
     "auto_heal": false,
+    "privileged": false,
     "disk": 0,
     "user_id": "0a9cdb65757b4216935e27f333d1c48b",
     "project_id": "77a89a275765486d86144caad70825e4"

api-ref/source/samples/container-get-all-resp.json

@@ -42,6 +42,7 @@
             "status_detail": "Exited(0) 10 mins ago ",
             "auto_remove": false,
             "auto_heal": false,
+            "privileged": false,
             "host": "ubuntu",
             "image_driver": "docker",
             "task_state": null,

api-ref/source/samples/container-show-resp.json

@@ -39,6 +39,7 @@
     "workdir": "/home/ubuntu",
     "auto_remove": false,
     "auto_heal": false,
+    "privileged": false,
     "status_detail": "Exited(0) 8 mins ago ",
     "host": "ubuntu",
     "image_driver": "docker",

api-ref/source/samples/container-update-resp.json

@@ -49,5 +49,6 @@
     "command": "/bin/sh -c 'echo hello'",
     "runtime": "runc",
     "cpu": 3.0,
-    "interactive": false
+    "interactive": false,
+    "privileged": false,
 }