From 460846cef28a502a51e4d52865743aea73e2f960 Mon Sep 17 00:00:00 2001
From: jichenjc <jichenjc@cn.ibm.com>
Date: Sat, 20 Feb 2016 22:33:18 +0800
Subject: [compute] Add server backup function

Add server backup function

There is no return value for this command per following doc
http://developer.openstack.org/api-ref-compute-v2.1.html#createBackup,
also novaclient can't be updated now due to backward compatible issue
http://lists.openstack.org/pipermail/openstack-dev/2016-March/089376.html,
so we have to get the information ourselves.

The Image tests were not using warlock images, so that needed to be fixed
before we could completely test things like --wait.

Change-Id: I30159518c4d3fdec89f15963bda641a0b03962d1
---
 doc/source/command-objects/server-backup.rst | 44 ++++++++++++++++++++++++++++
 doc/source/commands.rst                      |  1 +
 2 files changed, 45 insertions(+)
 create mode 100644 doc/source/command-objects/server-backup.rst

(limited to 'doc/source')

diff --git a/doc/source/command-objects/server-backup.rst b/doc/source/command-objects/server-backup.rst
new file mode 100644
index 00000000..23e17d5f
--- /dev/null
+++ b/doc/source/command-objects/server-backup.rst
@@ -0,0 +1,44 @@
+=============
+server backup
+=============
+
+A server backup is a disk image created in the Image store from a running server
+instance.  The backup command manages the number of archival copies to retain.
+
+Compute v2
+
+server backup create
+--------------------
+
+Create a server backup image
+
+.. program:: server create
+.. code:: bash
+
+    os server backup create
+        [--name <image-name>]
+        [--type <backup-type>]
+        [--rotate <count>]
+        [--wait]
+        <server>
+
+.. option:: --name <image-name>
+
+    Name of the backup image (default: server name)
+
+.. option:: --type <backup-type>
+
+    Used to populate the ``backup_type`` property of the backup
+    image (default: empty)
+
+.. option:: --rotate <count>
+
+    Number of backup images to keep (default: 1)
+
+.. option:: --wait
+
+    Wait for operation to complete
+
+.. describe:: <server>
+
+    Server to back up (name or ID)
diff --git a/doc/source/commands.rst b/doc/source/commands.rst
index 12542d1c..a6d94047 100644
--- a/doc/source/commands.rst
+++ b/doc/source/commands.rst
@@ -118,6 +118,7 @@ referring to both Compute and Volume quotas.
 * ``security group``: (**Compute**, **Network**) - groups of network access rules
 * ``security group rule``: (**Compute**, **Network**) - the individual rules that define protocol/IP/port access
 * ``server``: (**Compute**) virtual machine instance
+* ``server backup``: (**Compute**) backup server disk image by using snapshot method
 * ``server dump``: (**Compute**) a dump file of a server created by features like kdump
 * ``server group``: (**Compute**) a grouping of servers
 * ``server image``: (**Compute**) saved server disk image
-- 
cgit v1.2.1