Documentation: logical name support

[OpenStack Infra]

https://review.openstack.org/141737
commit ea25926c261cb6efff19d36778aef775d39d2785
Author: Michael Davies <email address hidden>
Date: Mon Dec 15 15:02:35 2014 +1030

    Add logical name support to Ironic

    Everything that is tracked in Ironic is done via UUID. This isn't very
    friendly to humans.

    This change adds a new concept to ironic, that being the <logical name>,
    which can be used interchangeably with the <node uuid>. Everywhere a
    <node uuid> can be specified, we are able to instead specify a <logical
    name>, if such an association exists for that node.

    APIImpact:
        This raises the X-OpenStack-Ironic-API-Version to 1.5, and
        adds a new "name" property to nodes, which can be substituted
        for the UUID in requests.

        This also adds a 'node' parameter for 'GET /v1/nodes/validate'. This
        parameter can be a node's UUID or name. The existing 'node_uuid'
        parameter is still supported.

    DocImpact

    blueprint: logical-names

    Co-Authored-By: Devananda van der Veen <email address hidden>
    Change-Id: I505181a1df064194848e3d5b79d01746024ce037

[Atsushi SAKAI (sakaia)]

This issue relates to 1482238
https://bugs.launchpad.net/openstack-api-site/+bug/1482238

[Atsushi SAKAI (sakaia)]

name is already in sample code
http://developer.openstack.org/api-ref-baremetal-v1.html#listNodes

[Ruby Loo (rloo)]

We have documentation about the node's name in the api-ref, with respect to the various node APIs so I'm going to mark this as fixed. (It is possible we may have missed some places, but that should be a different bug.)

[Ruby Loo (rloo)]

by 'api-ref' I mean http://developer.openstack.org/api-ref/baremetal/index.html