<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Mon, Aug 15, 2016 at 8:27 AM, Andrew Laski <span dir="ltr"><<a href="mailto:andrew@lascii.com" target="_blank">andrew@lascii.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">An API "capability" is going to be an action, or URL, that a user is<br>
allowed to use. So "boot an instance" or "resize this instance" are<br>
capabilities from the API point of view. Whether or not a user has this<br>
capability will be determined by looking at policy rules in place and<br>
the capabilities of the host the instance is on. For instance an<br>
upcoming volume multiattach feature may or may not be allowed for an<br>
instance depending on host support and the version of nova-compute code<br>
running on that host.<br>
<br>
A host "capability" is a description of the hardware or software on the<br>
host that determines whether or not that host can fulfill the needs of<br>
an instance looking for a home. So SSD or x86 could be host<br>
capabilities.<br>
<a href="https://github.com/jaypipes/os-capabilities/blob/master/os_capabilities/const.py" rel="noreferrer" target="_blank">https://github.com/jaypipes/<wbr>os-capabilities/blob/master/<wbr>os_capabilities/const.py</a><br>
has a list of some examples.<br></blockquote><div><br></div><div>We have spent a good amount of time thinking about naming resources in OpenStackClient and I think you have just stated what I would see as the best compromise here, just qualifying 'capability' to get specific.  There are far too many things in OpenStack to be able to use bare words to name anymore, we passed that a while back.</div><div><br></div><div>Even though this hinges on using capability slightly differently (actions vs properties), 'api capability' and 'host capability' are themselves a good solution, if not ideal.</div><div><br></div><div>If the difference between action and property is too strong to overcome, I would suggest just using 'host property' or 'host attribute'.  It looks like that list will include a variety of specific things, all of which though are intended to convey information about the host. <br></div></div><div class="gmail_extra"><br></div><div class="gmail_extra">Also, if these terms get surfaces to the user-visible level, I would like to see them fit existing usage as much as possible so we don't get another version of the 'metadata' vs 'properties' debate.</div><div class="gmail_extra"><br></div>dt<br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><br>Dean Troyer<br><a href="mailto:dtroyer@gmail.com" target="_blank">dtroyer@gmail.com</a><br></div>
</div></div>