From 3beac8edc4230adcb2aaa977c74b576a9af3eccf Mon Sep 17 00:00:00 2001
From: Kravchenko Pavel <kpavel@il.ibm.com>
Date: Thu, 7 Feb 2013 14:38:02 +0200
Subject: [PATCH] Extension for rebuild-for-ha

Adds an extension for blueprint rebuild-for-ha

Evacuation of VM from a failed host for HA.
New api supports recreate/rebuild modes. With shared storage,
VM is recreated on the target from disk.
Otherwise, rebuild from original image is performed.

DocImpact

Change-Id: Id7e3e68dbaaf74e9314440d98195a92454078fd9
Co-authored-by: Oshrit Feder <oshritf@il.ibm.com>
---
 .../all_extensions/extensions-get-resp.json   |  8 ++++++++
 .../all_extensions/extensions-get-resp.xml    |  3 +++
 .../os-evacuate/server-evacuate-req.json      |  7 +++++++
 .../os-evacuate/server-evacuate-req.xml       |  5 +++++
 .../os-evacuate/server-evacuate-resp.json     |  3 +++
 .../os-evacuate/server-evacuate-resp.xml      |  2 ++
 .../os-evacuate/server-post-req.json          | 16 ++++++++++++++++
 .../os-evacuate/server-post-req.xml           | 19 +++++++++++++++++++
 .../os-evacuate/server-post-resp.json         | 16 ++++++++++++++++
 .../os-evacuate/server-post-resp.xml          |  6 ++++++
 10 files changed, 85 insertions(+)
 create mode 100644 doc/api_samples/os-evacuate/server-evacuate-req.json
 create mode 100644 doc/api_samples/os-evacuate/server-evacuate-req.xml
 create mode 100644 doc/api_samples/os-evacuate/server-evacuate-resp.json
 create mode 100644 doc/api_samples/os-evacuate/server-evacuate-resp.xml
 create mode 100644 doc/api_samples/os-evacuate/server-post-req.json
 create mode 100644 doc/api_samples/os-evacuate/server-post-req.xml
 create mode 100644 doc/api_samples/os-evacuate/server-post-resp.json
 create mode 100644 doc/api_samples/os-evacuate/server-post-resp.xml

diff --git a/doc/api_samples/all_extensions/extensions-get-resp.json b/doc/api_samples/all_extensions/extensions-get-resp.json
index 3cb31fc2d..439d1af18 100644
--- a/doc/api_samples/all_extensions/extensions-get-resp.json
+++ b/doc/api_samples/all_extensions/extensions-get-resp.json
@@ -184,6 +184,14 @@
             "namespace": "http://docs.openstack.org/compute/ext/deferred-delete/api/v1.1",
             "updated": "2011-09-01T00:00:00+00:00"
         },
+        {
+            "alias": "os-evacuate",
+            "description": "Enables server evacuation",
+            "links": [],
+            "name": "Evacuate",
+            "namespace": "http://docs.openstack.org/compute/ext/evacuate/api/v2",
+            "updated": "2012-12-05T00:00:00+00:00"
+        },
         {
             "alias": "os-fixed-ips",
             "description": "Fixed IPs support.",
diff --git a/doc/api_samples/all_extensions/extensions-get-resp.xml b/doc/api_samples/all_extensions/extensions-get-resp.xml
index 8b0b218aa..71f79dc3a 100644
--- a/doc/api_samples/all_extensions/extensions-get-resp.xml
+++ b/doc/api_samples/all_extensions/extensions-get-resp.xml
@@ -84,6 +84,9 @@
   <extension alias="os-deferred-delete" updated="2011-09-01T00:00:00+00:00" namespace="http://docs.openstack.org/compute/ext/deferred-delete/api/v1.1" name="DeferredDelete">
     <description>Instance deferred delete.</description>
   </extension>
+  <extension alias="os-evacuate" updated="2012-12-05T00:00:00+00:00" namespace="http://docs.openstack.org/compute/ext/evacuate/api/v2" name="Evacuate">
+    <description>Enables server evacuation</description>
+  </extension>
   <extension alias="os-fixed-ips" updated="2012-10-18T13:25:27-06:00" namespace="http://docs.openstack.org/compute/ext/fixed_ips/api/v2" name="FixedIPs">
     <description>Fixed IPs support.</description>
   </extension>
diff --git a/doc/api_samples/os-evacuate/server-evacuate-req.json b/doc/api_samples/os-evacuate/server-evacuate-req.json
new file mode 100644
index 000000000..72a90e19a
--- /dev/null
+++ b/doc/api_samples/os-evacuate/server-evacuate-req.json
@@ -0,0 +1,7 @@
+{
+    "evacuate": {
+        "host": "TargetHost",
+        "adminPass": "MySecretPass",
+        "onSharedStorage": "True"
+    }
+}
diff --git a/doc/api_samples/os-evacuate/server-evacuate-req.xml b/doc/api_samples/os-evacuate/server-evacuate-req.xml
new file mode 100644
index 000000000..636772dca
--- /dev/null
+++ b/doc/api_samples/os-evacuate/server-evacuate-req.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<rescue xmlns="http://docs.openstack.org/compute/api/v2"
+    host="TargetHost"
+    adminPass="MySecretPass"
+    onSharedStorage="True"/>
diff --git a/doc/api_samples/os-evacuate/server-evacuate-resp.json b/doc/api_samples/os-evacuate/server-evacuate-resp.json
new file mode 100644
index 000000000..a023c720b
--- /dev/null
+++ b/doc/api_samples/os-evacuate/server-evacuate-resp.json
@@ -0,0 +1,3 @@
+{
+    "adminPass": "MySecretPass"
+}
diff --git a/doc/api_samples/os-evacuate/server-evacuate-resp.xml b/doc/api_samples/os-evacuate/server-evacuate-resp.xml
new file mode 100644
index 000000000..582388670
--- /dev/null
+++ b/doc/api_samples/os-evacuate/server-evacuate-resp.xml
@@ -0,0 +1,2 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<adminPass>MySecretPass</adminPass>
\ No newline at end of file
diff --git a/doc/api_samples/os-evacuate/server-post-req.json b/doc/api_samples/os-evacuate/server-post-req.json
new file mode 100644
index 000000000..d88eb4122
--- /dev/null
+++ b/doc/api_samples/os-evacuate/server-post-req.json
@@ -0,0 +1,16 @@
+{
+    "server" : {
+        "name" : "new-server-test",
+        "imageRef" : "http://openstack.example.com/openstack/images/70a599e0-31e7-49b7-b260-868f441e862b",
+        "flavorRef" : "http://openstack.example.com/openstack/flavors/1",
+        "metadata" : {
+            "My Server Name" : "Apache1"
+        },
+        "personality" : [
+            {
+                "path" : "/etc/banner.txt",
+                "contents" : "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA=="
+            }
+        ]
+    }
+}
\ No newline at end of file
diff --git a/doc/api_samples/os-evacuate/server-post-req.xml b/doc/api_samples/os-evacuate/server-post-req.xml
new file mode 100644
index 000000000..0a3c8bb53
--- /dev/null
+++ b/doc/api_samples/os-evacuate/server-post-req.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<server xmlns="http://docs.openstack.org/compute/api/v1.1" imageRef="http://openstack.example.com/openstack/images/70a599e0-31e7-49b7-b260-868f441e862b" flavorRef="http://openstack.example.com/openstack/flavors/1" name="new-server-test">
+  <metadata>
+    <meta key="My Server Name">Apache1</meta>
+  </metadata>
+  <personality>
+    <file path="/etc/banner.txt">
+        ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBp
+        dCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5k
+        IGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVs
+        c2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4g
+        QnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRo
+        ZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlv
+        dSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vy
+        c2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6
+        b25zLiINCg0KLVJpY2hhcmQgQmFjaA==
+    </file>
+  </personality>
+</server>
\ No newline at end of file
diff --git a/doc/api_samples/os-evacuate/server-post-resp.json b/doc/api_samples/os-evacuate/server-post-resp.json
new file mode 100644
index 000000000..d9114225a
--- /dev/null
+++ b/doc/api_samples/os-evacuate/server-post-resp.json
@@ -0,0 +1,16 @@
+{
+    "server": {
+        "adminPass": "xjDVAYHmc34s",
+        "id": "784f5005-bec9-4c22-8c42-5a7dcba88d82",
+        "links": [
+            {
+                "href": "http://openstack.example.com/v2/openstack/servers/784f5005-bec9-4c22-8c42-5a7dcba88d82",
+                "rel": "self"
+            },
+            {
+                "href": "http://openstack.example.com/openstack/servers/784f5005-bec9-4c22-8c42-5a7dcba88d82",
+                "rel": "bookmark"
+            }
+        ]
+    }
+}
\ No newline at end of file
diff --git a/doc/api_samples/os-evacuate/server-post-resp.xml b/doc/api_samples/os-evacuate/server-post-resp.xml
new file mode 100644
index 000000000..3a31871ba
--- /dev/null
+++ b/doc/api_samples/os-evacuate/server-post-resp.xml
@@ -0,0 +1,6 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<server xmlns:atom="http://www.w3.org/2005/Atom" xmlns="http://docs.openstack.org/compute/api/v1.1" id="70b4263f-bae1-4ac4-a1c5-e5bb193767bc" adminPass="ttv8YPD3tRPm">
+  <metadata/>
+  <atom:link href="http://openstack.example.com/v2/openstack/servers/70b4263f-bae1-4ac4-a1c5-e5bb193767bc" rel="self"/>
+  <atom:link href="http://openstack.example.com/openstack/servers/70b4263f-bae1-4ac4-a1c5-e5bb193767bc" rel="bookmark"/>
+</server>
\ No newline at end of file