From 37376b9acdee92c01b8235fdc45c78a7110362ed Mon Sep 17 00:00:00 2001
From: Ronald Bradford <ronald.bradford@gmail.com>
Date: Mon, 6 Jun 2016 15:49:15 -0400
Subject: [PATCH] api-ref: parameter verification os-fixed-ips

Change-Id: I0140ee7e49ffa39be07fe3f9a6ad24123be2a723
---
 api-ref/source/os-fixed-ips.inc | 22 ++++++++++++++-----
 api-ref/source/parameters.yaml  | 39 ++++++++++++++++++++++++++++++++-
 2 files changed, 54 insertions(+), 7 deletions(-)

diff --git a/api-ref/source/os-fixed-ips.inc b/api-ref/source/os-fixed-ips.inc
index 39b9b9a144cc..5a873c817ace 100644
--- a/api-ref/source/os-fixed-ips.inc
+++ b/api-ref/source/os-fixed-ips.inc
@@ -1,7 +1,5 @@
 .. -*- rst -*-
-.. needs:parameter_verification
 .. needs:example_verification
-.. needs:body_verification
 
 ==========================
  Fixed IPs (os-fixed-ips)
@@ -26,12 +24,20 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
-
-  - fixed_ip: fixed_ip
+  - fixed_ip: fixed_ip_path
 
 Response
 --------
 
+.. rest_parameters:: parameters.yaml
+
+  - fixed_ip: fixed_ip_obj
+  - address: ip_address
+  - cidr: cidr
+  - host: fixed_ip_host
+  - hostname: fixed_ip_hostname
+
+
 **Example Show Fixed Ip Details: JSON response**
 
 .. literalinclude:: ../../doc/api_samples/os-fixed-ips/fixedips-get-resp.json
@@ -44,7 +50,8 @@ Reserve Or Release A Fixed Ip
 
 Reserves or releases a fixed IP.
 
-To reserve a fixed IP address, specify ``reserve`` in the request body. To release a fixed IP address, specify ``unreserve`` in the request body.
+To reserve a fixed IP address, specify ``reserve`` in the request body.
+To release a fixed IP address, specify ``unreserve`` in the request body.
 
 Normal response codes: 202
 
@@ -55,8 +62,10 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
+  - fixed_ip: fixed_ip_path
+  - reserve: action_reserve
+  - unreserve: action_unreserve
 
-  - fixed_ip: fixed_ip
 
 **Example Reserve Or Release A Fixed Ip: JSON request**
 
@@ -66,3 +75,4 @@ Request
 Response
 --------
 
+There is no body content for the response of a successful POST query
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index be5d642bc7a1..56df72bdfd64 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -82,7 +82,7 @@ domain:
   in: path
   required: true
   type: string
-fixed_ip_1:
+fixed_ip_path:
   description: |
     The fixed IP of interest to you.
   in: path
@@ -638,6 +638,18 @@ accessIPv6_in:
   type: string
   description: |
     IPv6 address that should be used to access this server.
+action_reserve:
+  description: |
+    The attribute to reserve an IP with a value of ``null``.
+  in: body
+  required: false
+  type: string
+action_unreserve:
+  description: |
+    The attribute to release an IP with a value of ``null``.
+  in: body
+  required: false
+  type: string
 addFixedIp:
   description: |
     The action.
@@ -1205,6 +1217,25 @@ fixed_ip:
   in: body
   required: false
   type: string
+fixed_ip_host:
+  description: |
+    The hostname of the host that manages the server that is associated with
+    this fixed IP address.
+  in: body
+  required: true
+  type: string
+fixed_ip_hostname:
+  description: |
+    The hostname of the server that is associated with this fixed IP address.
+  in: body
+  required: true
+  type: string
+fixed_ip_obj:
+  description: |
+    A fixed IP address object.
+  in: body
+  required: true
+  type: object
 fixed_ips:
   description: |
     Fixed IP addresses.  If you request a specific fixed IP address without
@@ -1781,6 +1812,12 @@ ip_address_req:
   in: body
   required: true
   type: string
+ip_host:
+  description: |
+    The name or ID of the host associated to the IP.
+  in: body
+  required: true
+  type: string
 ip_protocol:
   description: |
     The IP protocol. A valid value is ICMP, TCP, or UDP.