lbaas v2.0 api-ref inconsistencies

[brenda]

This bug tracker is for errors with the documentation, use the following as a template and remove or add fields as you see fit. Convert [ ] into [x] to check boxes:

- [x] This doc is inaccurate in this way: ______
- [ ] This is a doc addition request.
- [x] I have a fix to the document that I can paste below including example: input and output.

If you have a troubleshooting or support issue, use the following resources:

 - Ask OpenStack: http://ask.openstack.org
 - The mailing list: http://lists.openstack.org
 - IRC: 'openstack' channel on Freenode

-----------------------------------
Release: 1.8.1.dev40 on 'Tue Jul 18 18:01:21 2017, commit 7581af4'
SHA:
Source: Can't derive source file URL
URL: https://developer.openstack.org/api-ref/networking/v2/

[brenda (tian-mingming)]

there are three problems with lbaas v2.0 api:
1.There is no "name" attribute in "POST /v2.0/lbaas/health_monitors" request body, but from the lbaas v2.0 code and datamodel , there is a "name" attribute added in to healthmonitor object, and in fact, we can use "name" attribute in request body when creating a healthmonitor.
2. the attribute usage description is not right about "protocol" attribute of listener, you can find this error in "POST /v2.0/lbaas/listeners",like below:
protocol body string The IP protocol. Valid value is icmp, tcp, udp, or null. No default.
3. There is a "subnet_id" attribute in ""POST /v2.0/lbaas/pools", but both the code and datamodel has no "subnet_id" in
lbaas v2 pool object. It's confusing. Why remove "subnet_id" from pool?

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/536288

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/536288
Committed: https://git.openstack.org/cgit/openstack/neutron-lib/commit/?id=2c98c01e9907248de247b751a8deee1461f8be5d
Submitter: Zuul
Branch: master

commit 2c98c01e9907248de247b751a8deee1461f8be5d
Author: yanpuqing <email address hidden>
Date: Thu Jan 4 08:23:42 2018 +0000

    Fix the mistake of lbaas api-ref

    There are some mistakes of lbaas api-ref.
    1.There is no definition for "status", "status_description",
    "healthmonitors_status", "provider", "subnet_id", "vip_id"
    attributes in the pool, and "listeners", "session_persistence"
    should be defined in the pool.
    2.The protocol_port of listener and the delay of healthmonitor is an
    integer.
    3.The id of healthmonitor of the pool named "healthmonitor_id"
    rather than "healthmonitors".
    4.There is no "name" attribute in "POST /v2.0/lbaas/health_monitors"
    request body, but from the lbaas v2.0 code and datamodel, there is
     a "name" attribute added in to healthmonitor object.
    The patch fixes those mistakes.

    Change-Id: Ia7417c818f6646c419f734d7273fd3bf8eb5aad5
    Closes-Bug: #1719259

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/neutron-lib 1.19.0 release.