vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/eip/api-ref/eip_openstackapi_0003.html
Qin Ying, Fan aca2e5c333 EIP API 1027 version 
Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>
2022-10-31 11:11:49 +00:00

158 lines
14 KiB
HTML
Raw Blame History

<a name="eip_openstackapi_0003"></a><a name="eip_openstackapi_0003"></a>
<h1 class="topictitle1">Querying a Specified API Version</h1>
<div id="body8662426"><div class="section" id="eip_openstackapi_0003__en-us_topic_0201534145_section292172513710"><h4 class="sectiontitle">Function</h4><p id="eip_openstackapi_0003__en-us_topic_0201534145_p852715264378">This API is used to query the version of a specified API.</p>
</div>
<div class="section" id="eip_openstackapi_0003__en-us_topic_0201534145_section092618252375"><h4 class="sectiontitle">URI</h4><p id="eip_openstackapi_0003__en-us_topic_0201534145_p76195219224">GET /{api_version}</p>
<p id="eip_openstackapi_0003__en-us_topic_0201534145_p17789155311512"><a href="#eip_openstackapi_0003__en-us_topic_0201534145_table8488410142319">Table 1</a> describes the parameters.</p>
<div class="tablenoborder"><a name="eip_openstackapi_0003__en-us_topic_0201534145_table8488410142319"></a><a name="en-us_topic_0201534145_table8488410142319"></a><table cellpadding="4" cellspacing="0" summary="" id="eip_openstackapi_0003__en-us_topic_0201534145_table8488410142319" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="eip_openstackapi_0003__en-us_topic_0201534145_row9493141018236"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.4.2.4.1.1"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p94981610102320"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b842352706193648">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.4.2.4.1.2"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p12502171018236"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b842352706193653">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.4.2.4.1.3"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p0503161052316"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b8423527061645">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="eip_openstackapi_0003__en-us_topic_0201534145_row050661014235"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.1 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p5516910112316">api_version</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.2 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p1851919102230">String</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.4.2.4.1.3 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p25212100235">Specifies the version number, for example <strong id="eip_openstackapi_0003__en-us_topic_0201534145_b84235270685253">v2.0</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="eip_openstackapi_0003__en-us_topic_0201534145_section159431125133719"><h4 class="sectiontitle">Request Message</h4><ul id="eip_openstackapi_0003__en-us_topic_0201534145_ul6314758192316"><li id="eip_openstackapi_0003__en-us_topic_0201534145_li1431465892318">Request parameter<p id="eip_openstackapi_0003__en-us_topic_0201534145_p655442321511"><a name="eip_openstackapi_0003__en-us_topic_0201534145_li1431465892318"></a><a name="en-us_topic_0201534145_li1431465892318"></a>None</p>
</li></ul>
<ul id="eip_openstackapi_0003__en-us_topic_0201534145_ul1726162811245"><li id="eip_openstackapi_0003__en-us_topic_0201534145_li5261128182419">Example request<pre class="screen" id="eip_openstackapi_0003__en-us_topic_0201534145_screen272554182417">GET https://{Endpoint}/v2.0</pre>
</li></ul>
</div>
<div class="section" id="eip_openstackapi_0003__en-us_topic_0201534145_section199536251373"><h4 class="sectiontitle">Response Message</h4><ul id="eip_openstackapi_0003__en-us_topic_0201534145_ul1618733182517"><li id="eip_openstackapi_0003__en-us_topic_0201534145_li118713114259">Response parameter
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="eip_openstackapi_0003__en-us_topic_0201534145_table1595322519378" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameter</caption><thead align="left"><tr id="eip_openstackapi_0003__en-us_topic_0201534145_row95291726133710"><th align="left" class="cellrowborder" valign="top" width="23.23%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p1252992613712"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b288960372">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.25%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p55291826163717"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b1112022058">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.519999999999996%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p1552913260373"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b503142040">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="eip_openstackapi_0003__en-us_topic_0201534145_row15529326203718"><td class="cellrowborder" valign="top" width="23.23%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p8529826133712">resources</p>
</td>
<td class="cellrowborder" valign="top" width="25.25%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p13529152643712">Array of <a href="#eip_openstackapi_0003__en-us_topic_0201534145_table1195920258372">resource</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="51.519999999999996%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p1852902653713">Specifies the <strong id="eip_openstackapi_0003__en-us_topic_0201534145_b84235270685442">resource</strong> object list.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="eip_openstackapi_0003__en-us_topic_0201534145_table1195920258372"></a><a name="en-us_topic_0201534145_table1195920258372"></a><table cellpadding="4" cellspacing="0" summary="" id="eip_openstackapi_0003__en-us_topic_0201534145_table1195920258372" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b84235270685537">resource</strong> object</caption><thead align="left"><tr id="eip_openstackapi_0003__en-us_topic_0201534145_row5529132615373"><th align="left" class="cellrowborder" valign="top" width="23.23%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p1252920262374"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b2016729654">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.25%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p2529126123714"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b693882856">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.519999999999996%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p105291226143715"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b2130002376">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="eip_openstackapi_0003__en-us_topic_0201534145_row1552919263377"><td class="cellrowborder" valign="top" width="23.23%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p10529192611375">name</p>
</td>
<td class="cellrowborder" valign="top" width="25.25%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p352910264377">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.519999999999996%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p052918269376">Specifies the resource name.</p>
</td>
</tr>
<tr id="eip_openstackapi_0003__en-us_topic_0201534145_row852942611373"><td class="cellrowborder" valign="top" width="23.23%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p1152902613374">collection</p>
</td>
<td class="cellrowborder" valign="top" width="25.25%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p185293264370">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.519999999999996%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p8529192614377">Specifies the resource collection name.</p>
</td>
</tr>
<tr id="eip_openstackapi_0003__en-us_topic_0201534145_row6529726133710"><td class="cellrowborder" valign="top" width="23.23%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p25291326103715">links</p>
</td>
<td class="cellrowborder" valign="top" width="25.25%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p2658122615326">Array of <a href="#eip_openstackapi_0003__en-us_topic_0201534145_table4442151110172">link</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="51.519999999999996%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p1252922613371">Specifies the link list. For details, see <a href="#eip_openstackapi_0003__en-us_topic_0201534145_table4442151110172">Table 4</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="eip_openstackapi_0003__en-us_topic_0201534145_table4442151110172"></a><a name="en-us_topic_0201534145_table4442151110172"></a><table cellpadding="4" cellspacing="0" summary="" id="eip_openstackapi_0003__en-us_topic_0201534145_table4442151110172" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b7788449151218">link</strong> objects</caption><thead align="left"><tr id="eip_openstackapi_0003__en-us_topic_0201534145_row12442181131712"><th align="left" class="cellrowborder" valign="top" width="23.23%" id="mcps1.3.4.2.1.3.2.4.1.1"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p044251171713"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b220024813381">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.25%" id="mcps1.3.4.2.1.3.2.4.1.2"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p4442411201715"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b915035849">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.519999999999996%" id="mcps1.3.4.2.1.3.2.4.1.3"><p id="eip_openstackapi_0003__en-us_topic_0201534145_p124423117177"><strong id="eip_openstackapi_0003__en-us_topic_0201534145_b9873125010388">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="eip_openstackapi_0003__en-us_topic_0201534145_row1444331111711"><td class="cellrowborder" valign="top" width="23.23%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p164432011131719">href</p>
</td>
<td class="cellrowborder" valign="top" width="25.25%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p444331114174">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.519999999999996%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p17443151171713">Specifies the API link.</p>
</td>
</tr>
<tr id="eip_openstackapi_0003__en-us_topic_0201534145_row174431411161711"><td class="cellrowborder" valign="top" width="23.23%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p16443191131712">rel</p>
</td>
<td class="cellrowborder" valign="top" width="25.25%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p2443111117171">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.519999999999996%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="eip_openstackapi_0003__en-us_topic_0201534145_p1944331171712">Specifies the relationship between the API link and the API version.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="eip_openstackapi_0003__en-us_topic_0201534145_li963818205263">Example response<pre class="screen" id="eip_openstackapi_0003__en-us_topic_0201534145_screen125631611141616">{
"resources": [
{
"links": [
{
"href": "https://vpc.systems.com/v2.0/subnets",
"rel": "self"
}
],
"name": "subnet",
"collection": "subnets"
},
{
"links": [
{
"href": "https://vpc.systems.com/v2.0/networks",
"rel": "self"
}
],
"name": "network",
"collection": "networks"
},
{
"links": [
{
"href": "https://vpc.systems.com/v2.0/ports",
"rel": "self"
}
],
"name": "port",
"collection": "ports"
}
]
}</pre>
</li></ul>
</div>
<div class="section" id="eip_openstackapi_0003__en-us_topic_0201534145_section31981619"><h4 class="sectiontitle">Status Code</h4><p id="eip_openstackapi_0003__en-us_topic_0201534145_p18112112662914">See <a href="eip_api05_0001.html#eip_api05_0001">Status Codes</a>.</p>
</div>
<div class="section" id="eip_openstackapi_0003__en-us_topic_0201534145_section85821649202813"><h4 class="sectiontitle">Error Code</h4><p id="eip_openstackapi_0003__en-us_topic_0201534145_p7233105282813">See <a href="eip_api05_0002.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="eip_openstackapi_0001.html">API Version Information</a></div>
</div>
</div>
View Git Blame Copy Permalink