<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">
<br class="">
<div>
<blockquote type="cite" class="">
<div class="">On Aug 3, 2016, at 12:59 AM, Ramakrishna, Deepti <<a href="mailto:deepti.ramakrishna@intel.com" class="">deepti.ramakrishna@intel.com</a>> wrote:</div>
<br class="Apple-interchange-newline">
<div class="">
<div class="WordSection1" style="page: WordSection1; font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;">
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">Hi,<o:p class=""></o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class=""><o:p class=""> </o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">I would like to bring your attention to my spec [1] (already approved) on capability APIs and would like to get feedback from API WG.<o:p class=""></o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class=""><o:p class=""> </o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">To summarize, I propose defining a capability API for every resource in a REST API where it makes sense and is needed. In the context of Cinder, we would have a capability API at
the root resource level (GET<span class="Apple-converted-space"> </span></span><span style="font-family: Consolas;" class="">/v3.x/{tenant_id}/capabilities</span><span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">) that would return,
e.g., [“volume-backup", “other-capability”]. Similarly, we could have a capability API on the volume types resource<span class="Apple-converted-space"> </span></span><span style="font-family: Consolas;" class="">(GET /v3.x/{tenant_id}/types/{volume_type_id}/capabilities</span><span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">)
that would return all the features supported by a volume type and so on.<o:p class=""></o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class=""><o:p class=""> </o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">I believe that this API pattern solves the problem of exposing capabilities and could be used for enabling/disabling UI widgets on Horizon and other clients. This pattern cleanly
translates to all OpenStack projects which all face the general problem.<o:p class=""></o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class=""><o:p class=""> </o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">Can you please look at the spec (and the implementation for Cinder [2]) and let me know if you have any feedback? I would be most interested in knowing your thoughts about cross-project
suitability of this solution.<o:p class=""></o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class=""><o:p class=""> </o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">Thanks,<o:p class=""></o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">Deepti<o:p class=""></o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class=""><o:p class=""> </o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">[1]<span class="Apple-converted-space"> </span><a href="https://review.openstack.org/#/c/306930/" style="color: rgb(149, 79, 114); text-decoration: underline;" class="">https://review.openstack.org/#/c/306930/</a><o:p class=""></o:p></span></div>
<div style="margin: 0in 0in 0.0001pt; font-size: 11pt; font-family: Calibri, sans-serif;" class="">
<span style="font-size: 12pt; font-family: 'Times New Roman', serif;" class="">[2]<span class="Apple-converted-space"> </span><a href="https://review.openstack.org/#/c/350310/" style="color: rgb(149, 79, 114); text-decoration: underline;" class="">https://review.openstack.org/#/c/350310/</a><o:p class=""></o:p></span></div>
</div>
</div>
</blockquote>
</div>
<br class="">
<div class="">I added this topic to the API WG meeting tomorrow.</div>
<div class=""><br class="">
</div>
<div class=""><a href="https://wiki.openstack.org/wiki/Meetings/API-WG" class="">https://wiki.openstack.org/wiki/Meetings/API-WG</a></div>
<div class=""><br class="">
</div>
<div class="">Everett</div>
<div class=""><br class="">
</div>
</body>
</html>