← Back to team overview

yahoo-eng-team team mailing list archive

[Bug 1673593] [NEW] api-ref: descriptions for the various host fields in server GET response are useless

 

Public bug reported:

This came up in a review for the mistaken use of the hypervisor_hostname
field in the server GET response:

https://review.openstack.org/#/c/446685/2/nova/tests/functional/regressions/test_bug_1671648.py@149

Looking at the API ref:

https://developer.openstack.org/api-ref/compute/?expanded=show-server-
details-detail#id25

There are three 'host' related fields in the response:

1. hostId - The ID of the host.
2. OS-EXT-SRV-ATTR:host - The host name. Appears in the response for administrative users only.
3. OS-EXT-SRV-ATTR:hypervisor_hostname - The hypervisor host name. Appears in the response for administrative users only.

The hostId is an obfuscated id for the hostname in the guest (server
instance).

The 'host' is the name of the compute host that the nova-compute service
is running on. This comes from the 'host' configuration option value in
nova.conf.

The 'hypervisor_hostname' is the hostname of the hypervisor, provided by
the compute driver, which in most cases is the same as 'host' *except*
in the case of Ironic in which case it's the Ironic node name.

** Affects: nova
     Importance: Low
         Status: Confirmed


** Tags: api-ref

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to OpenStack Compute (nova).
https://bugs.launchpad.net/bugs/1673593

Title:
  api-ref: descriptions for the various host fields in server GET
  response are useless

Status in OpenStack Compute (nova):
  Confirmed

Bug description:
  This came up in a review for the mistaken use of the
  hypervisor_hostname field in the server GET response:

  https://review.openstack.org/#/c/446685/2/nova/tests/functional/regressions/test_bug_1671648.py@149

  Looking at the API ref:

  https://developer.openstack.org/api-ref/compute/?expanded=show-server-
  details-detail#id25

  There are three 'host' related fields in the response:

  1. hostId - The ID of the host.
  2. OS-EXT-SRV-ATTR:host - The host name. Appears in the response for administrative users only.
  3. OS-EXT-SRV-ATTR:hypervisor_hostname - The hypervisor host name. Appears in the response for administrative users only.

  The hostId is an obfuscated id for the hostname in the guest (server
  instance).

  The 'host' is the name of the compute host that the nova-compute
  service is running on. This comes from the 'host' configuration option
  value in nova.conf.

  The 'hypervisor_hostname' is the hostname of the hypervisor, provided
  by the compute driver, which in most cases is the same as 'host'
  *except* in the case of Ironic in which case it's the Ironic node
  name.

To manage notifications about this bug go to:
https://bugs.launchpad.net/nova/+bug/1673593/+subscriptions


Follow ups