Merge "Add api-ref for container kill"

api-ref/source/containers.inc

@@ -5,7 +5,7 @@
 ===================
 
 Lists, creates, shows details for, stats, updates, deletes, starts, resizes,
-stops, pauses, unpauses, restarts, renames, commits, attaches to containers,
+stops, pauses, unpauses, restarts, renames, commits, kills, attaches to containers,
 gets archive from container, puts archive to container, and adds security group
 for specified container, gets logs of a container, displays the running
 processes in a container.
@@ -257,6 +257,46 @@ This request does not return anything in the response body.
   - X-Openstack-Request-Id: request_id
 
 
+Kill a container
+================
+
+.. rest_method:: POST /v1/containers/{container_ident}/kill?signal={signal}
+
+Kill a running container.
+
+Response Codes
+--------------
+
+.. rest_status_code:: success status.yaml
+
+   - 202
+
+.. rest_status_code:: error status.yaml
+
+   - 400
+   - 401
+   - 403
+   - 404
+   - 409
+
+Request
+-------
+
+.. rest_parameters:: parameters.yaml
+
+  - container_ident: container_ident
+  - signal: signal
+
+Response
+--------
+
+This request does not return anything in the response body.
+
+.. rest_parameters:: parameters.yaml
+
+  - X-Openstack-Request-Id: request_id
+
+
 Display stats of a container
 ============================
 

api-ref/source/parameters.yaml

@@ -65,6 +65,12 @@ security_group_query:
   in: query
   required: true
   type: string
+signal:
+  description: |
+    The signal to kill a container.
+  in: query
+  required: false
+  type: string
 since:
   description: |
     Show logs since a given datetime or integer epoch (in seconds).