From 2756cc316f12a1622f913e7b4e4b237104ff918c Mon Sep 17 00:00:00 2001
From: Zhenguo Niu <Niu.ZGlinux@gmail.com>
Date: Wed, 13 Sep 2017 10:24:11 +0800
Subject: [PATCH] [DOC] Add availability zone docs for users

Change-Id: I8ded9f679b91f7641d1b3c2330f2b8d00592e21a
---
 doc/source/index.rst                   |  1 +
 doc/source/user/availability-zones.rst | 30 ++++++++++++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 doc/source/user/availability-zones.rst

diff --git a/doc/source/index.rst b/doc/source/index.rst
index 789ce518..faffbf07 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -58,6 +58,7 @@ User Guide
   :maxdepth: 1
 
   user/states
+  user/availability-zones
   user/root-disk-partitions
 
 
diff --git a/doc/source/user/availability-zones.rst b/doc/source/user/availability-zones.rst
new file mode 100644
index 00000000..f7517c21
--- /dev/null
+++ b/doc/source/user/availability-zones.rst
@@ -0,0 +1,30 @@
+====================================================
+Select availability zones where servers are launched
+====================================================
+
+You can select which availability zone servers are launched on.
+
+#. To select the availabiilty zone where servers are launched, use the
+   ``--availability-zone ZONE`` parameter on the :command:`openstack
+   baremetalcompute server create` command.
+
+   For example:
+
+   .. code-block:: console
+
+      $ openstack baremetalcompute server create --image IMAGE --flavor m1.tiny \
+        --key-name KEY --availability-zone ZONE --nic net-id=UUID \
+        --partition ephemeral_gb=500 SERVER
+
+#. To view the list of valid zones, use the :command:`openstack baremetalcompute
+   availability zone list` command.
+
+   .. code-block:: console
+
+      $ openstack baremetalcompute availability zone list
+      +-----------+
+      | Zone Name |
+      +-----------+
+      | zone1     |
+      | zone2     |
+      +-----------+