forked from docs/doc-exports
Wang , Deng Ke
21e968a153
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: Wang , Deng Ke <wangdengke2@huawei.com> Co-committed-by: Wang , Deng Ke <wangdengke2@huawei.com>
149 lines
14 KiB
HTML
149 lines
14 KiB
HTML
<a name="en-us_topic_0057306831"></a><a name="en-us_topic_0057306831"></a>
|
|
|
|
<h1 class="topictitle1">Querying an API Version List (Compatible with OpenStack)</h1>
|
|
<div id="body8662426"><div class="section" id="en-us_topic_0057306831__s527f618a3631437897927385613272af"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0057306831__en-us_topic_0032347778_p793298915440">This API is used to query the currently supported RDS API version list.</p>
|
|
<ul id="en-us_topic_0057306831__ul12259155218373"><li id="en-us_topic_0057306831__en-us_topic_0240111818_li836513175363">Before calling an API, you need to understand the API in <a href="rds_03_0001.html">Authentication</a>.</li><li id="en-us_topic_0057306831__en-us_topic_0240111818_li1991981933613">Before calling this API, obtain the required <a href="https://docs.otc.t-systems.com/en-us/endpoint/index.html" target="_blank" rel="noopener noreferrer">region and endpoint</a>.</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057306831__s74ec19de10d34f1687b2179083d744ae"><h4 class="sectiontitle">URI</h4><ul id="en-us_topic_0057306831__u449e627424f94c0e9e7c15a2c3b94849"><li id="en-us_topic_0057306831__l0832def8dc35487c9ba9c3d94df0d455">URI format<p id="en-us_topic_0057306831__a6f4d7cc228394ffa932257fcbb99e184"><a name="en-us_topic_0057306831__l0832def8dc35487c9ba9c3d94df0d455"></a><a name="l0832def8dc35487c9ba9c3d94df0d455"></a>PATH: /</p>
|
|
<p id="en-us_topic_0057306831__en-us_topic_0032347778_p284461015440">Method: GET</p>
|
|
</li><li id="en-us_topic_0057306831__l7f5496d051914575aae1e41efba4f8bb">Parameter description<p id="en-us_topic_0057306831__p76582032152710"><a name="en-us_topic_0057306831__l7f5496d051914575aae1e41efba4f8bb"></a><a name="l7f5496d051914575aae1e41efba4f8bb"></a>None</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057306831__s01687545134d465baa4b5d6c8a28dde0"><h4 class="sectiontitle">Request</h4><p id="en-us_topic_0057306831__p17139174720264">None</p>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057306831__s5ed2134cd7254287b6982b404afe1af5"><h4 class="sectiontitle">Response</h4><ul id="en-us_topic_0057306831__ub2cf5b02ebb449d99bfc33ce0853b18a"><li id="en-us_topic_0057306831__lcbc41c7f892b472e9f9c9c95fc123c85">Normal response
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057306831__tcf7775a6be1b47b5aa5297975d4256bb" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0057306831__r017d023a16ac47b486b0a3ac66422d15"><th align="left" class="cellrowborder" valign="top" width="26.26262626262626%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="en-us_topic_0057306831__a7505c1daa195443fb47e22863245e80c"><strong id="en-us_topic_0057306831__en-us_topic_0032347778_b842352706102328">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40.40404040404041%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="en-us_topic_0057306831__ac3a2b3811f064157a423119cf6bd8c05"><strong id="en-us_topic_0057306831__en-us_topic_0032347778_b842352706164541">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="en-us_topic_0057306831__a0d6afecd4b3744bc90bf9cc05e79c155"><strong id="en-us_topic_0057306831__en-us_topic_0032347778_b842352706163417">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057306831__r99baa6ed92f646b1846b461cf99bd4d8"><td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="en-us_topic_0057306831__a231101d576064625a2b6cc7c44720e2a">versions</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.40404040404041%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="en-us_topic_0057306831__ab6e71f44fc8e4442b7c2b97464beebe5">Array of objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="en-us_topic_0057306831__en-us_topic_0032347778_p476126915440">Indicates the list of detailed API version information.</p>
|
|
<p id="en-us_topic_0057306831__p12971510123511">For details, see <a href="#en-us_topic_0057306831__t597bb32ec3694c8e917e7b92cbcc8b18">Table 2</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="en-us_topic_0057306831__t597bb32ec3694c8e917e7b92cbcc8b18"></a><a name="t597bb32ec3694c8e917e7b92cbcc8b18"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057306831__t597bb32ec3694c8e917e7b92cbcc8b18" frame="border" border="1" rules="all"><caption><b>Table 2 </b>versions field data structure description</caption><thead align="left"><tr id="en-us_topic_0057306831__r66a50d84290f4eccb889a0d8e54c51f6"><th align="left" class="cellrowborder" valign="top" width="26.529999999999998%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="en-us_topic_0057306831__a6ba6d0001fd44bd09ff25243bd4bb001"><strong id="en-us_topic_0057306831__b156741737">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="39.800000000000004%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="en-us_topic_0057306831__a472d09f2c2624e15ad2662ea2214715b"><strong id="en-us_topic_0057306831__b1006960847">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.67%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="en-us_topic_0057306831__a02decdae0686467e82cb981d833cb370"><strong id="en-us_topic_0057306831__b1058882153">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057306831__r78c0afe5c849497a876f19c14a9ed4ee"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0057306831__a4fe5e70b5fc4446c984112261ead63d3">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.800000000000004%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0057306831__a11baa203faf04d838774d196d2c3d9fd">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0057306831__aac437d22b5bc49a5b75d163018e29121">Indicates the API version.</p>
|
|
<ul id="en-us_topic_0057306831__ul1725315498237"><li id="en-us_topic_0057306831__li16253349122312"><strong id="en-us_topic_0057306831__b7261534541">v1</strong>: indicates the API v1 version.</li><li id="en-us_topic_0057306831__li79171361241"><strong id="en-us_topic_0057306831__b0450103510410">v1.0</strong>: indicates the OpenStack trove API v1.0.</li><li id="en-us_topic_0057306831__li9727105472415"><strong id="en-us_topic_0057306831__b1134023611419">v3</strong>: indicates the API v3 version.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057306831__row42577582121025"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0057306831__p33971472121032">links</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.800000000000004%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0057306831__p871263121310">Array of objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0057306831__p30425021121032">Indicates the API link information. The value is empty when the version is <strong id="en-us_topic_0057306831__b9972193716411">v1</strong> or <strong id="en-us_topic_0057306831__b7661412057">v3</strong>.</p>
|
|
<p id="en-us_topic_0057306831__p93631481916">For details, see <a href="#en-us_topic_0057306831__t645d6d81bf2f42a18f1a65676a7219d7">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057306831__r2f9163942c1647dba639a5cacea9613b"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0057306831__ab6b2affa0c10471c99c0c271c505bffe">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.800000000000004%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0057306831__afc828afd7db94565ab0e74b64b7e3e59">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0057306831__p32916607104653">Indicates the version status.</p>
|
|
<p id="en-us_topic_0057306831__p1835621415265">The value <span class="parmvalue" id="en-us_topic_0057306831__parmvalue645211820517"><b>CURRENT</b></span> indicates that the version has been released.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057306831__rd1c8f00b419b468aa92c34291577c1cc"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0057306831__a8894d2ac89ff4fb2a8d634c42bb0f208">updated</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.800000000000004%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0057306831__ac1128a30986c441b92aa3c5cfcd56e05">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0057306831__acae232520194469a9accb354a7948c6d">Indicates the version update time.</p>
|
|
<p id="en-us_topic_0057306831__a3944e8a22ca2484086ec90b72cda3a8a">The format is yyyy-mm-dd Thh:mm:ssZ.</p>
|
|
<p id="en-us_topic_0057306831__a28bcdc5cc276482a8f0bd4b90cb9b23e"><strong id="en-us_topic_0057306831__b842352706104536">T</strong> is the separator between the calendar and the hourly notation of time. <strong id="en-us_topic_0057306831__b842352706161738">Z</strong> indicates the UTC.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="en-us_topic_0057306831__t645d6d81bf2f42a18f1a65676a7219d7"></a><a name="t645d6d81bf2f42a18f1a65676a7219d7"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057306831__t645d6d81bf2f42a18f1a65676a7219d7" frame="border" border="1" rules="all"><caption><b>Table 3 </b>links field data structure description (dedicated for OpenStack v1.0)</caption><thead align="left"><tr id="en-us_topic_0057306831__ra07a00bcadf64ad387c2dd75b4557e42"><th align="left" class="cellrowborder" valign="top" width="26.529999999999998%" id="mcps1.3.4.2.1.3.2.4.1.1"><p id="en-us_topic_0057306831__a5ea8fa3edfac44d887658822c2d57b26"><strong id="en-us_topic_0057306831__b2002039592">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="39.800000000000004%" id="mcps1.3.4.2.1.3.2.4.1.2"><p id="en-us_topic_0057306831__af15dfe6143894935a69dfad224e01197"><strong id="en-us_topic_0057306831__b997947024">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.67%" id="mcps1.3.4.2.1.3.2.4.1.3"><p id="en-us_topic_0057306831__a27c6f07346604234b91ad6ad5d31c701"><strong id="en-us_topic_0057306831__b1609678968">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057306831__r913f5e29affb484da3f97eef6547e87e"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="en-us_topic_0057306831__a61a58fd6166641d5aa9ef785fc475ae2">href</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.800000000000004%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="en-us_topic_0057306831__a571a52216e81461e928ecad12b114b19">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="en-us_topic_0057306831__en-us_topic_0032347778_p619568715440">Indicates the API URL and the value is <strong id="en-us_topic_0057306831__b84235270618633">""</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057306831__r9a2191a6f9a7465a983ac80b4c143dcd"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="en-us_topic_0057306831__aa37bc9bde57b42dca72babbca6d4ef86">rel</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.800000000000004%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="en-us_topic_0057306831__a601c1b6c0d3c410482bebe332656f0bc">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.67%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="en-us_topic_0057306831__ab2d6dd6fb61a4c46bedffa06052c155d">Its value is <strong id="en-us_topic_0057306831__b84235270616818">self</strong>, indicating that <strong id="en-us_topic_0057306831__b84235270616856">href</strong> is a local link.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="en-us_topic_0057306831__u2691e60a936f4ff6b1c721e9c5d12b2d"><li id="en-us_topic_0057306831__l6fc0f7f26b2b4df6a3651d7a71ed1296">Example normal response<pre class="codeblock" id="en-us_topic_0057306831__c5f01e9331bd14774aede9931421e29ba">{
|
|
"versions": [
|
|
{
|
|
"id": "v1",
|
|
"links": [],
|
|
"status": "CURRENT",
|
|
"updated": "2017-02-07T17:34:02Z"
|
|
},
|
|
{
|
|
"id": "v1.0",
|
|
"links": [
|
|
{
|
|
"href": "",
|
|
"rel": "self"
|
|
}
|
|
],
|
|
"status": "CURRENT",
|
|
"updated": "2017-03-23T17:34:02Z"
|
|
} ,
|
|
{
|
|
"id": "v3",
|
|
"links": [],
|
|
"status": "CURRENT",
|
|
"updated": "2019-01-15T12:00:00Z"
|
|
}
|
|
]
|
|
}</pre>
|
|
</li><li id="en-us_topic_0057306831__li659583819392">Abnormal Response<p id="en-us_topic_0057306831__p14551143944217"><a name="en-us_topic_0057306831__li659583819392"></a><a name="li659583819392"></a>For details, see <a href="en-us_topic_0032488197.html">Abnormal Request Results</a>.</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057306831__section4778540915440"><h4 class="sectiontitle">Status Code</h4><ul id="en-us_topic_0057306831__en-us_topic_0032347778_ul7858132212142"><li id="en-us_topic_0057306831__en-us_topic_0032347778_li58581622171411">Normal<p id="en-us_topic_0057306831__en-us_topic_0032347778_p1040982941020"><a name="en-us_topic_0057306831__en-us_topic_0032347778_li58581622171411"></a><a name="en-us_topic_0032347778_li58581622171411"></a>200</p>
|
|
</li><li id="en-us_topic_0057306831__en-us_topic_0032347778_li11583183218149">Abnormal<p id="en-us_topic_0057306831__en-us_topic_0032347778_p0723374409"><a name="en-us_topic_0057306831__en-us_topic_0032347778_li11583183218149"></a><a name="en-us_topic_0032347778_li11583183218149"></a>For details, see <a href="en-us_topic_0032488240.html">Status Codes</a>.</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057306831__section1183074220016"><h4 class="sectiontitle">Error Code</h4><p id="en-us_topic_0057306831__en-us_topic_0032347778_p19357163913406">For details, see <a href="en-us_topic_0032488241.html">Error Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0056887469.html">Obtaining an API Version</a></div>
|
|
</div>
|
|
</div>
|
|
|