summaryrefslogtreecommitdiff
path: root/api-ref/source/servers-action-deferred-delete.inc
diff options
context:
space:
mode:
authorSean Dague <sean@dague.net>2016-04-12 09:03:46 -0400
committerSean Dague <sean@dague.net>2016-04-13 07:34:45 -0400
commitd4e27714405e064ba8f62070e8c48d7fa71b6996 (patch)
treebd8b560fdc3864ea1c121b069926cd6b1d569556 /api-ref/source/servers-action-deferred-delete.inc
parentf1fa7eb15a8b4a081d8d8afd3e6d80302c20e39e (diff)
downloadnova-d4e27714405e064ba8f62070e8c48d7fa71b6996.tar.gz
Import RST files for documentation
This is the results of the RST conversion from WADL. It creates a single index plus a bunch of included files which represent sections of the API document. This is the starting point for fixing the documentation. Change-Id: I7d561c2ecdcd864172dedb54a551f17ad3bdfe26
Diffstat (limited to 'api-ref/source/servers-action-deferred-delete.inc')
-rw-r--r--api-ref/source/servers-action-deferred-delete.inc68
1 files changed, 68 insertions, 0 deletions
diff --git a/api-ref/source/servers-action-deferred-delete.inc b/api-ref/source/servers-action-deferred-delete.inc
new file mode 100644
index 0000000000..c6c42e0ad9
--- /dev/null
+++ b/api-ref/source/servers-action-deferred-delete.inc
@@ -0,0 +1,68 @@
+.. -*- rst -*-
+
+Force-Delete Server (Forcedelete Action)
+========================================
+
+.. rest_method:: POST /v2.1/{tenant_id}/servers/{server_id}/action
+
+Force-deletes a server before deferred cleanup.
+
+Specify the ``forceDelete`` action in the request body.
+
+Policy defaults enable only users with the administrative role or the owner of the server to perform this operation. Cloud providers can change these permissions through the ``policy.json`` file.
+
+Normal response codes: 202
+
+Error response codes: computeFault(400, 500), serviceUnavailable(503), badRequest(400),
+unauthorized(401), forbidden(403), badMethod(405), itemNotFound(404)
+
+Request
+^^^^^^^
+
+.. rest_parameters:: parameters.yaml
+
+ - tenant_id: tenant_id
+ - server_id: server_id
+ - forceDelete: forceDelete
+
+**Example Force-Delete Server (Forcedelete Action): JSON request**
+
+.. literalinclude:: ../../doc/api_samples/servers-action/force-delete-create-req.json
+ :language: javascript
+
+Response
+^^^^^^^^
+
+Restore Soft-Deleted Instance (Restore Action)
+==============================================
+
+.. rest_method:: POST /v2.1/{tenant_id}/servers/{server_id}/action
+
+Restores a previously soft-deleted server instance. You cannot use this method to restore deleted instances.
+
+Specify the ``restore`` action in the request body.
+
+Policy defaults enable only users with the administrative role or the owner of the server to perform this operation. Cloud providers can change these permissions through the ``policy.json`` file.
+
+Normal response codes: 202
+
+Error response codes: computeFault(400, 500), serviceUnavailable(503), badRequest(400),
+unauthorized(401), forbidden(403), badMethod(405), itemNotFound(404)
+
+Request
+^^^^^^^
+
+.. rest_parameters:: parameters.yaml
+
+ - tenant_id: tenant_id
+ - server_id: server_id
+ - restore: restore
+
+**Example Restore Soft-Deleted Instance (Restore Action): JSON request**
+
+.. literalinclude:: ../../doc/api_samples/servers-action/restore-create-req.json
+ :language: javascript
+
+Response
+^^^^^^^^
+