api-ref: a wrong description for 'hosts' parameter in os-availability-zone.inc

[Takashi Natsume]

http://developer.openstack.org/api-ref/compute/#availability-zones-os-availability-zone

In "Get Availability Zone Information", the 'hosts' response parameter is always 'null'.

https://github.com/openstack/nova/blob/75a4869a845e42cf63e1bfdaaeddafcda219ee28/nova/api/openstack/compute/availability_zone.py#L44

The following current description for it is not proper.

> An object containing a list of host information.
> The host information is comprised of host and service objects.
> The service object returns three parameters representing the states of the service: active, available, and updated_at.

[OpenStack Infra (hudson-openstack)]

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

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/417233
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=7c66d4184b225e7f3eda77aee84663e1f1d09c53
Submitter: Jenkins
Branch: master

commit 7c66d4184b225e7f3eda77aee84663e1f1d09c53
Author: Takashi NATSUME <email address hidden>
Date: Fri Jan 6 07:59:11 2017 +0900

    api-ref: Fix a parameter in os-availability-zone.inc

    In "Get Availability Zone Information",
    the 'hosts' response parameter is always 'null'.
    So fix the description.

    Change-Id: I23bd8b3a422aa03c3f56d7f2f10f6603acd0078a
    Closes-Bug: #1654427

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/nova 15.0.0.0b3 development milestone.