remove REST API examples from RAID doc

This removes the REST API examples from the RAID documentation.
Our documentation typically only uses ironic (or openstackclient)
CLI. Also, this is the only place where 'curl' is documented. It was
mentioned that at least one person got confused and thought that
'curl' was packaged with our client.

Change-Id: Ib43be080a450144869bbce6ba6313db8bde93751

doc/source/admin/raid.rst

@@ -7,10 +7,14 @@ RAID Configuration
 Overview
 ========
 Ironic supports RAID configuration for bare metal nodes.  It allows operators
-to specify the desired RAID configuration via Ironic CLI or REST API.
+to specify the desired RAID configuration via the OpenStackClient CLI or REST
-The desired RAID configuration is applied on the bare metal during manual
+API.  The desired RAID configuration is applied on the bare metal during manual
 cleaning.
 
+The examples described here use the OpenStackClient CLI; please see the
+`REST API reference <https://developer.openstack.org/api-ref/baremetal/>`_
+for their corresponding REST API requests.
+
 Prerequisites
 =============
 The bare metal node needs to use a driver that supports RAID
@@ -38,9 +42,10 @@ in JSON format.
 
 Target RAID configuration
 -------------------------
-This is the desired RAID configuration on the bare metal node.  Using Ironic CLI
+This is the desired RAID configuration on the bare metal node.  Using the
-or REST API, the operator sets ``target_raid_config`` field of the node.
+OpenStackClient CLI (or REST API), the operator sets ``target_raid_config``
-The target RAID configuration will be applied during manual cleaning.
+field of the node. The target RAID configuration will be applied during manual
+cleaning.
 
 Target RAID configuration is a dictionary having ``logical_disks``
 as the key. The value for the ``logical_disks`` is a list of JSON
@@ -61,13 +66,9 @@ If the ``target_raid_config`` is an empty dictionary, it unsets the value of
 done on the node.
 
 Each dictionary of logical disk contains the desired properties of logical
-disk supported by the driver.  These properties are discoverable by using
+disk supported by the driver.  These properties are discoverable by::
-OpenStackClient CLI or REST API::
 
-  OpenStackClient CLI:
     openstack baremetal --os-baremetal-api-version 1.15 driver raid property list <driver name>
-  Ironic REST API:
-    curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: $AUTH_TOKEN" -H "X-OpenStack-Ironic-API-Version: 1.15"  http://<ironic-api-url>/v1/drivers/<driver name>/raid/logical_disk_properties
 
 The RAID feature is available in ironic API version 1.15 and above.
 If ``--os-baremetal-api-version`` is not used in the CLI, it will error out
@@ -236,11 +237,7 @@ physical disk found on the bare metal node.
 
 To get the current RAID configuration::
 
-  OpenStackClient CLI:
     openstack baremetal --os-baremetal-api-version 1.15 node show <node-uuid-or-name>
-  REST API:
-    curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: $AUTH_TOKEN" -H "X-OpenStack-Ironic-API-Version: 1.15" http://<ironic-api-url>/v1/nodes/<node-uuid-or-name>/states
-
 
 Workflow
 ========
@@ -256,11 +253,8 @@ Workflow
   `Target RAID configuration`_. The target RAID configuration is set on
   the Ironic node::
 
-    OpenStackClient CLI:
       openstack baremetal --os-baremetal-api-version 1.15 node set <node-uuid-or-name> \
          --target-raid-config <JSON file containing target RAID configuration>
-    REST API:
-      curl -X PUT -H "Content-Type: application/json" -H "X-Auth-Token: $AUTH_TOKEN" -H "X-OpenStack-Ironic-API-Version: 1.15" -d '<JSON data target RAID configuration>' http://<ironic-api-url>/v1/nodes/<node-uuid-or-name>/states/raid
 
     The CLI command can accept the input from standard input also:
        openstack baremetal --os-baremetal-api-version 1.15 node set <node-uuid-or-name> \
@@ -288,19 +282,13 @@ Workflow
 * Bring the node to ``manageable`` state and do a ``clean`` action to start
   cleaning on the node::
 
-    OpenStackClient CLI:
       openstack baremetal --os-baremetal-api-version 1.15 node clean <node-uuid-or-name> \
          --clean-steps <JSON file containing clean steps created above>
-    REST API:
-      curl -X PUT -H "Content-Type: application/json" -H "X-Auth-Token: $AUTH_TOKEN" -H "X-OpenStack-Ironic-API-Version: 1.15" -d '{'target': 'clean', 'clean_steps': <JSON description for clean steps as mentioned above>' http://<ironic-api-url>/v1/nodes/<node-uuid-or-name>/states/provision
 
 * After manual cleaning is complete, the current RAID configuration can be
   viewed using::
 
-    OpenStackClient CLI:
       openstack baremetal --os-baremetal-api-version 1.15 node show <node-uuid-or-name>
-    REST API:
-      curl -X GET -H "Content-Type: application/json" -H "X-Auth-Token: $AUTH_TOKEN" -H "X-OpenStack-Ironic-API-Version: 1.15" http://<ironic-api-url>/v1/nodes/<node-uuid-or-name>/states
 
 Using RAID in nova flavor for scheduling
 ========================================