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>
147 lines
13 KiB
HTML
147 lines
13 KiB
HTML
<a name="en-us_topic_0032347778"></a><a name="en-us_topic_0032347778"></a>
|
|
|
|
<h1 class="topictitle1">Querying API Versions</h1>
|
|
<div id="body42915540"><div class="section" id="en-us_topic_0032347778__section9793815440"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0032347778__p793298915440">This API is used to query the currently supported RDS API versions.</p>
|
|
<ul id="en-us_topic_0032347778__ul4365141719360"><li id="en-us_topic_0032347778__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_0032347778__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_0032347778__section428804115440"><h4 class="sectiontitle">URI</h4><ul id="en-us_topic_0032347778__ul1178707715440"><li id="en-us_topic_0032347778__li3897482915440">URI format<p id="en-us_topic_0032347778__p78401671305"><a name="en-us_topic_0032347778__li3897482915440"></a><a name="li3897482915440"></a>GET https://{<em id="en-us_topic_0032347778__i5611162401314">Endpoint</em>}/rds/</p>
|
|
</li><li id="en-us_topic_0032347778__li2560149615440">Parameter description<p id="en-us_topic_0032347778__p2908688015440"><a name="en-us_topic_0032347778__li2560149615440"></a><a name="li2560149615440"></a>None</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0032347778__section2907369315440"><h4 class="sectiontitle">Request</h4><ul id="en-us_topic_0032347778__ul1183180183717"><li id="en-us_topic_0032347778__li1283110163719">Request parameters<p id="en-us_topic_0032347778__p848415163614"><a name="en-us_topic_0032347778__li1283110163719"></a><a name="li1283110163719"></a>None</p>
|
|
</li></ul>
|
|
<ul id="en-us_topic_0032347778__ul16431430131617"><li id="en-us_topic_0032347778__li4411135064210">Example<p id="en-us_topic_0032347778__p1454414211213"><a name="en-us_topic_0032347778__li4411135064210"></a><a name="li4411135064210"></a>GET https://rds.eu-de.otc.t-systems.com/rds</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0032347778__section5543006115440"><h4 class="sectiontitle">Response</h4><ul id="en-us_topic_0032347778__ul6064993315440"><li id="en-us_topic_0032347778__li897849015440">Normal response
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0032347778__table3575976715440" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0032347778__row5028223115440"><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_0032347778__p4632888215440"><strong id="en-us_topic_0032347778__b842352706102328_3">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_0032347778__p6165196615440"><strong id="en-us_topic_0032347778__b842352706164541_1">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_0032347778__p2775334615440"><strong id="en-us_topic_0032347778__b842352706163417_3">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0032347778__row3342858315440"><td class="cellrowborder" valign="top" width="26.26262626262626%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="en-us_topic_0032347778__p2336072515440">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_0032347778__p49221130121216">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_0032347778__p476126915440">Indicates the list of detailed API version information.</p>
|
|
<p id="en-us_topic_0032347778__p877352874313">For details, see <a href="#en-us_topic_0032347778__table37479565104653">Table 2</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="en-us_topic_0032347778__table37479565104653"></a><a name="table37479565104653"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0032347778__table37479565104653" 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_0032347778__row65790814104653"><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_0032347778__p27455703104653"><strong id="en-us_topic_0032347778__b842352706102328_5">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40.23%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="en-us_topic_0032347778__p9319469104653"><strong id="en-us_topic_0032347778__b842352706164541_3">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.239999999999995%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="en-us_topic_0032347778__p16679495104653"><strong id="en-us_topic_0032347778__b842352706163417_5">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0032347778__row8861837104653"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0032347778__p46720233104653">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.23%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0032347778__p26242496104653">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.239999999999995%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0032347778__p45267452104653">Indicates the API version.</p>
|
|
<ul id="en-us_topic_0032347778__ul1725315498237"><li id="en-us_topic_0032347778__li16253349122312"><strong id="en-us_topic_0032347778__b192361814298">v1</strong>: indicates the API v1 version.</li><li id="en-us_topic_0032347778__li79171361241"><strong id="en-us_topic_0032347778__b11223411142919">v1.0</strong>: indicates the OpenStack trove API v1.0.</li><li id="en-us_topic_0032347778__li9727105472415"><strong id="en-us_topic_0032347778__b172244408114">v3</strong>: indicates the API v3 version.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0032347778__row1548795912115"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0032347778__p26342211121111">links</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.23%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0032347778__p1329784718535">Array of objects</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.239999999999995%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0032347778__p31978734121111">Indicates the API link information. The value is empty when the version is <strong id="en-us_topic_0032347778__b84235270615454">v1</strong> or <strong id="en-us_topic_0032347778__b8551221142314">v3</strong>.</p>
|
|
<p id="en-us_topic_0032347778__p3549257124214">For details, see <a href="#en-us_topic_0032347778__table630875915440">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0032347778__row4753892104653"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0032347778__p49520946104653">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.23%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0032347778__p51773656104653">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.239999999999995%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0032347778__p32916607104653">Indicates the version status.</p>
|
|
<p id="en-us_topic_0032347778__p1880593015412"><strong id="en-us_topic_0032347778__b12381327195914">CURRENT</strong>: indicates that the version is recommended.</p>
|
|
<p id="en-us_topic_0032347778__p10804162614411"><strong id="en-us_topic_0032347778__b84235270619220">DEPRECATED</strong>: indicates a deprecated version which may be deleted later.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0032347778__row27814010104653"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0032347778__p38342341104653">updated</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40.23%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0032347778__p18721892104653">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.239999999999995%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0032347778__p40078272104653">Indicates the version update time.</p>
|
|
<p id="en-us_topic_0032347778__p25160128104653">The format is yyyy-mm-dd Thh:mm:ssZ.</p>
|
|
<p id="en-us_topic_0032347778__p25114560104653"><strong id="en-us_topic_0032347778__b842352706104536">T</strong> is the separator between the calendar and the hourly notation of time. <strong id="en-us_topic_0032347778__b842352706161738">Z</strong> indicates the Coordinated Universal Time (UTC).</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="en-us_topic_0032347778__table630875915440"></a><a name="table630875915440"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0032347778__table630875915440" 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_0032347778__row4191288815440"><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_0032347778__p3950073415440"><strong id="en-us_topic_0032347778__b842352706102328_7">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_0032347778__p4544288515440"><strong id="en-us_topic_0032347778__b842352706164541_5">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_0032347778__p5699506015440"><strong id="en-us_topic_0032347778__b842352706163417_7">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0032347778__row5319717215440"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="en-us_topic_0032347778__p1400369315440">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_0032347778__p6055731815440">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_0032347778__p619568715440">Indicates the API URL and the value is <strong id="en-us_topic_0032347778__b84235270618633">""</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0032347778__row5576118615440"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="en-us_topic_0032347778__p2036224315440">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_0032347778__p3872902515440">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_0032347778__p4856427103410">The values are as follows, depending on the version:</p>
|
|
<ul id="en-us_topic_0032347778__ul17151313173514"><li id="en-us_topic_0032347778__li1151813173516">V3</li><li id="en-us_topic_0032347778__li1372311512359">V1</li><li id="en-us_topic_0032347778__li1699801710355">V1.0</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="en-us_topic_0032347778__ul3468747215440"><li id="en-us_topic_0032347778__li4375179915440">Example normal response<pre class="codeblock" id="en-us_topic_0032347778__codeblock14379153617107">{
|
|
"versions": [{
|
|
"id": "v1",
|
|
"links": [],
|
|
"status": "CURRENT",
|
|
"updated": "2017-02-07T17:34:02Z"
|
|
}, {
|
|
"id": "v1.0",
|
|
"links": [{
|
|
"href": "",
|
|
"rel": "v1.0"
|
|
}],
|
|
"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_0032347778__li659583819392">Abnormal response<p id="en-us_topic_0032347778__p014165512396"><a name="en-us_topic_0032347778__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_0032347778__section4778540915440"><h4 class="sectiontitle">Status Code</h4><ul id="en-us_topic_0032347778__ul7858132212142"><li id="en-us_topic_0032347778__li58581622171411">Normal<p id="en-us_topic_0032347778__p1040982941020"><a name="en-us_topic_0032347778__li58581622171411"></a><a name="li58581622171411"></a>200</p>
|
|
</li><li id="en-us_topic_0032347778__li11583183218149">Abnormal<p id="en-us_topic_0032347778__p0723374409"><a name="en-us_topic_0032347778__li11583183218149"></a><a name="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_0032347778__section946032144017"><h4 class="sectiontitle">Error Code</h4><p id="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>
|
|
|