<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 14px; font-family: Calibri, sans-serif; ">
<div>
<div>
<div>Yes, the query parameters I'm talking about are on GET requests – mostly list resources calls – where you use the query parameters to filter the results. </div>
<div><br>
</div>
<div>For example, list servers, list flavors, list images…..</div>
<div><br>
</div>
<div>There aren't a lot of them – is anyone opposed to me showing the query parameters in the URIs?</div>
<div><br>
</div>
<div><br>
</div>
<div><br>
</div>
<div>
<div>
<div style="color: rgb(0, 0, 0); "><font class="Apple-style-span" color="rgb(0, 0, 0)" face="Apple Chancery"><i>Diane</i></font></div>
<div style="font-family: Calibri, sans-serif; font-size: 14px; color: rgb(0, 0, 0); ">
<font class="Apple-style-span" color="rgb(0, 0, 0)"><i>----------------------------------------------</i></font></div>
<div style="font-family: Calibri, sans-serif; font-size: 14px; color: rgb(0, 0, 0); ">
<font class="Apple-style-span" color="rgb(0, 0, 0)">Diane Fleming</font></div>
<div style="font-family: Calibri, sans-serif; font-size: 14px; ">
<div style="color: rgb(0, 0, 0); ">Software Developer II - US</div>
</div>
diane.fleming@rackspace.com</div>
<div>Cell 512.323.6799</div>
<div>Office 512.874.1260<br>
<span class="Apple-style-span" style="font-family: Calibri, sans-serif; ">
<div style="font-family: Calibri, sans-serif; font-size: 14px; ">
<div style="color: rgb(0, 0, 0); ">Skype drfleming0227</div>
<div style="color: rgb(0, 0, 0); ">Google-plus diane.fleming@gmail.com</div>
</div>
</span></div>
</div>
</div>
</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<div style="font-family:Calibri; font-size:11pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: 3pt">
<span style="font-weight:bold">From: </span>Nick Chase <<a href="mailto:nchase@mirantis.com">nchase@mirantis.com</a>><br>
<span style="font-weight:bold">Date: </span>Wednesday, July 10, 2013 12:24 PM<br>
<span style="font-weight:bold">To: </span>Diane Fleming <<a href="mailto:diane.fleming@rackspace.com">diane.fleming@rackspace.com</a>><br>
<span style="font-weight:bold">Cc: </span>"<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>" <<a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a>><br>
<span style="font-weight:bold">Subject: </span>Re: [Openstack-docs] Hi all - question<br>
</div>
<div><br>
</div>
<div>
<div>
<div dir="ltr">In general, it's unusual to include parameters on POST request URLs. That's not to say that it can't be done, but I think it might be a bit confusing; even if the parameters are sent on the URL, they ALSO have to be sent as part of the reqeust
body, as a normal POST request.
<div><br>
</div>
<div>That said, I'd be all for identifying "query" parameters in the tables...<br>
<div><br>
</div>
<div>---- Nick</div>
</div>
</div>
<div class="gmail_extra"><br>
<br>
<div class="gmail_quote">On Wed, Jul 10, 2013 at 11:16 AM, Diane Fleming <span dir="ltr">
<<a href="mailto:diane.fleming@rackspace.com" target="_blank">diane.fleming@rackspace.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="auto">
<div>No, I'm not suggesting that, though that's a good idea. I'm suggesting that the calls that have query parameters show them, like this</div>
<div><br>
</div>
<div>GET /<URL>/servers?marker=marker&limit=limit<br>
<br>
Sent from my iPhone</div>
<div>
<div class="h5">
<div><br>
On Jul 10, 2013, at 7:57 AM, "Nick Chase" <<a href="mailto:nchase@mirantis.com" target="_blank">nchase@mirantis.com</a>> wrote:<br>
<br>
</div>
<blockquote type="cite">
<div>
<div dir="ltr">On Wed, Jul 10, 2013 at 8:32 AM, Diane Fleming <span dir="ltr"><<a href="mailto:diane.fleming@rackspace.com" target="_blank">diane.fleming@rackspace.com</a>></span> wrote:
<div><br>
<div class="gmail_extra">
<div class="gmail_quote">
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div style="font-size:14px;font-family:Calibri,sans-serif;word-wrap:break-word">
<div>
<div>
<div>For example, in the individual API references, they do appear in the URIs, like this:</div>
<div><br>
</div>
<div><a href="http://docs.openstack.org/api/openstack-compute/2/content/List_Servers-d1e2078.html" target="_blank">http://docs.openstack.org/api/openstack-compute/2/content/List_Servers-d1e2078.html</a></div>
<div><br>
</div>
<div>However, this same call on the API Reference page looks like this – (see the "List Ids, names, and links for all servers" call)</div>
<div><br>
</div>
<div><a href="http://api.openstack.org/api-ref.html#compute" target="_blank">http://api.openstack.org/api-ref.html#compute</a></div>
<div><br>
</div>
<div>The query parms are described in the table, but don't appear in the URI itself. I find this really confusing. I'd like to have the page changed so that these appear in the URI – what are your thoughts? At the very least, they should be identified as "query"
parameters in the table. Let me know your thoughts!</div>
</div>
</div>
</div>
</blockquote>
<div><br>
</div>
<div>That URL actually refers to many calls, though; Are you suggesting that each call should have its own anchor, such as:</div>
<div><br>
</div>
<div><a href="http://api.openstack.org/api-ref.html#compute_servers_list" target="_blank">http://api.openstack.org/api-ref.html#compute_servers_list</a></div>
<div><a href="http://api.openstack.org/api-ref.html#compute_servers_create" target="_blank">http://api.openstack.org/api-ref.html#compute_servers_create</a></div>
<div><a href="http://api.openstack.org/api-ref.html#compute_servers_detail" target="_blank">http://api.openstack.org/api-ref.html#compute_servers_detail</a></div>
<div><a href="http://api.openstack.org/api-ref.html#compute_servers_delete" target="_blank">http://api.openstack.org/api-ref.html#compute_servers_delete</a></div>
<div><br>
</div>
<div>I'd be for that.</div>
<div><br>
</div>
<div>---- Nick</div>
<div><br>
</div>
<div> </div>
</div>
<br>
</div>
</div>
</div>
</div>
</blockquote>
</div>
</div>
</div>
</blockquote>
</div>
<br>
</div>
</div>
</div>
</span>
</body>
</html>