api-ref verify os-floating-ip-pools.inc

verified the API doc for os-floating-ip-pools,
adjus the wording for 'owner' of the server, Also,
remove some common error code like 500, 503 etc

Part of bp:api-ref-in-rst

Change-Id: Id8bd213282bc53f1f9fbc24d1d2b03ea135c376e

api-ref/source/os-floating-ip-pools.inc

@@ -1,8 +1,4 @@
 .. -*- rst -*-
-.. needs:method_verification
-.. needs:parameter_verification
-.. needs:example_verification
-.. needs:body_verification
 
 ==========================================
  Floating IP pools (os-floating-ip-pools)
@@ -17,12 +13,14 @@ List Floating Ip Pools
 
 Lists floating IP pools.
 
-Policy defaults enable only users with the administrative role or the owner of the server to perform this operation. Cloud providers can change these permissions through the ``policy.json`` file.
+Policy defaults enable only users with the administrative role or user 
+who is authorized to operate on tenant <tenant_id> to perform this 
+operation. Cloud providers can change these permissions through the 
+``policy.json`` file.
 
 Normal response codes: 200
 
-Error response codes: computeFault(400, 500), serviceUnavailable(503), badRequest(400),
+Error response codes: unauthorized(401), forbidden(403)
-unauthorized(401), forbidden(403), badMethod(405), itemNotFound(404)
 
 Request
 -------
@@ -37,7 +35,7 @@ Response
 .. rest_parameters:: parameters.yaml
 
   - floating_ip_pools: floating_ip_pools
-  - name: name
+  - name: floating_ip_pool_name 
 
 **Example List Floating Ip Pools: JSON response**
 

api-ref/source/parameters.yaml

@@ -960,8 +960,14 @@ floating_ip_pools:
   description: |
     The ``floating_ip_pools`` object.
   in: body
-  required: false
+  required: true
   type: array
+floating_ip_pool_name:
+  description: |
+    The name of the floating ip pool.
+  in: body
+  required: true
+  type: string
 floating_ips:
   description: |
     The number of allowed floating IP addresses for each tenant.