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
14 KiB
HTML
147 lines
14 KiB
HTML
<a name="en-us_topic_0057306832"></a><a name="en-us_topic_0057306832"></a>
|
|
|
|
<h1 class="topictitle1">Querying a Specified API Version Information (Compatible with OpenStack)</h1>
|
|
<div id="body8662426"><div class="section" id="en-us_topic_0057306832__se8a5fdb5b69140fd9a6a162a2c946544"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0057306832__a555aaa2bc6b740d09318a35f3856d64f">This API is used to query the specified API version.</p>
|
|
<ul id="en-us_topic_0057306832__ul12259155218373"><li id="en-us_topic_0057306832__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_0057306832__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_0057306832__s8712952f689e42849bfa7025a8e9c26f"><h4 class="sectiontitle">URI</h4><ul id="en-us_topic_0057306832__u973f2d3bad0b4f428dd09622235fa6cb"><li id="en-us_topic_0057306832__l57502406ab974590b886add3a82a0b78">URI format<p id="en-us_topic_0057306832__ac05e6c0628f54886a192f2101f14026f"><a name="en-us_topic_0057306832__l57502406ab974590b886add3a82a0b78"></a><a name="l57502406ab974590b886add3a82a0b78"></a>PATH: /v1.0</p>
|
|
<p id="en-us_topic_0057306832__a7df19c8c4111485cbb623e27a8636dbe">Method: GET</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057306832__sf8445598dc1d4accb1009f668e3f1ecf"><h4 class="sectiontitle">Request</h4><p id="en-us_topic_0057306832__a3634f7de07bc46468ce1eac25b239a86">None</p>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0057306832__s3f86068037d34985978d5319f962aed1"><h4 class="sectiontitle">Response</h4><ul id="en-us_topic_0057306832__uf1634872c57b444fac97971c86c1539f"><li id="en-us_topic_0057306832__l533049d315264e5a859a14da420f19c4">Normal response
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057306832__ta171724895be4537bbe91c6b330ae5ce" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0057306832__rbedc4fe052c146af934330775aaeba39"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="en-us_topic_0057306832__a42f6eedd33674c2f816859311dff9977"><strong id="en-us_topic_0057306832__en-us_topic_0032347779_b842352706102328">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="en-us_topic_0057306832__a6afd7a78742d44cf9ae4b267ee6d1684"><strong id="en-us_topic_0057306832__en-us_topic_0032347779_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_0057306832__a627b20f6558b481cb956f1e9e4066183"><strong id="en-us_topic_0057306832__en-us_topic_0032347779_b842352706163417">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057306832__r88496f9018374c7b9e90193348520374"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="en-us_topic_0057306832__a7fdf81619fa246bdbe4a368c7742111d">versions</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="en-us_topic_0057306832__a9a9492e05cb648e885d1e747a339d04d">Object</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_0057306832__a92bad74081154ce6a5337bf766dea530">Indicates the list of detailed API version information.</p>
|
|
<p id="en-us_topic_0057306832__p5766192462116">For details, see <a href="#en-us_topic_0057306832__t5963fff962ed43abb7a3e7d46742f177">Table 2</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057306832__row6705357611756"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="en-us_topic_0057306832__p6023687711820">version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="en-us_topic_0057306832__p5356304153">Object</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_0057306832__p1005360411820">Indicates the list of detailed API version information.</p>
|
|
<p id="en-us_topic_0057306832__p1815410320219">For details, see <a href="#en-us_topic_0057306832__t5963fff962ed43abb7a3e7d46742f177">Table 2</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="en-us_topic_0057306832__t5963fff962ed43abb7a3e7d46742f177"></a><a name="t5963fff962ed43abb7a3e7d46742f177"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057306832__t5963fff962ed43abb7a3e7d46742f177" 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_0057306832__re7b458966c154793973d30e4f9484d30"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="en-us_topic_0057306832__aa8a0ea4f858b4e93b0511a227f423769"><strong id="en-us_topic_0057306832__b24080716">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="en-us_topic_0057306832__ae9525ddc0df7401790c8aa3639214182"><strong id="en-us_topic_0057306832__b1008201159">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="en-us_topic_0057306832__ae06052e3e2b844cca0f51e47f6d620eb"><strong id="en-us_topic_0057306832__b1206444668">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057306832__r94d24e2978694f5dab231414b5052e31"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0057306832__a0fa0e6898d284b19846167535fd33e7c">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0057306832__a685d2a430e0940c4859474efe2cd23f1">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0057306832__a605f505929f7413eab02a91f8967a2e0">Indicates the API version.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057306832__row2126108012754"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0057306832__p16997501285">links</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0057306832__p34620521285">Array</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0057306832__p408083281285">Indicates the API link information.</p>
|
|
<p id="en-us_topic_0057306832__p5314441142117">For details, see <a href="#en-us_topic_0057306832__t39ce8ee145d0420f9b392b8b6897bd15">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057306832__rcd2f361a04d948c5bb73954c6d819774"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0057306832__a62c7a1a0e07d4b63b5dd4aae7d190569">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0057306832__aa8a04dbf0d5d475da26785a1edd0dbf0">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0057306832__a45f8228ed2054117a2d286fde0d805ce">Indicates the version status.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057306832__rfbbdb750c08d4b5ca5c305b1cebe308e"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="en-us_topic_0057306832__acb3944d5001d481d9f231aecbdd78616">updated</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="en-us_topic_0057306832__ae2f32c984c5a4589a151fe2ed0e97b6c">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="en-us_topic_0057306832__aaa9a5d99f9e34b0592c5d1dc91350299">Indicates the version update time.</p>
|
|
<p id="en-us_topic_0057306832__a67f4ade5f67b4b00bca133cc7b9d6aa2">The format is yyyy-mm-dd Thh:mm:ssZ.</p>
|
|
<p id="en-us_topic_0057306832__a36d1013820b94694a2498bb899e76fb7"><strong id="en-us_topic_0057306832__b842352706104536">T</strong> is the separator between the calendar and the hourly notation of time. <strong id="en-us_topic_0057306832__b842352706161738">Z</strong> indicates the UTC.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="en-us_topic_0057306832__t39ce8ee145d0420f9b392b8b6897bd15"></a><a name="t39ce8ee145d0420f9b392b8b6897bd15"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0057306832__t39ce8ee145d0420f9b392b8b6897bd15" frame="border" border="1" rules="all"><caption><b>Table 3 </b>links field data structure description</caption><thead align="left"><tr id="en-us_topic_0057306832__re0d5492ee4c74e7baf0d6835fdb85f6d"><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_0057306832__a0d47c1e2eda942fd915f14fe2a95a7fa"><strong id="en-us_topic_0057306832__b1640135724">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_0057306832__a644502e4b2514d1c85c0f93b9ac7f289"><strong id="en-us_topic_0057306832__b2021585003">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_0057306832__ae7079a1e380a40afba5a6a5de69eda3a"><strong id="en-us_topic_0057306832__b1000583669">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0057306832__r5bc2727ac5744a8e976ee1b2dd7f0b9a"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="en-us_topic_0057306832__a8229f25d830a4e0580e409909894a80b">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_0057306832__a3f4057e3fea64c19806b893971fcd556">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_0057306832__en-us_topic_0032347779_p619568715440">Indicates the API URL and the value is <strong id="en-us_topic_0057306832__b84235270618633">""</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0057306832__rd4ec13ef5bf046e2891351e0a8e8e7c0"><td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="en-us_topic_0057306832__abeff09729c074f3f891587452b023b80">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_0057306832__ae412b819da8948cbad262b653caf8f32">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_0057306832__aadccb003a11348fdbbe3243d439df7db">Its value is <strong id="en-us_topic_0057306832__b84235270616818">self</strong>, indicating that <strong id="en-us_topic_0057306832__b84235270616856">href</strong> is a local link.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="en-us_topic_0057306832__ua12071ddad2b4e2dbaf8f30692ef90f4"><li id="en-us_topic_0057306832__ldee35c938fce4941aa70fe05eda5ef98">Example normal response<pre class="codeblock" id="en-us_topic_0057306832__codeblock2150756715418">{
|
|
"version": {
|
|
"id": "v1.0",
|
|
"links": [{
|
|
"href": "",
|
|
"rel": "self"
|
|
}],
|
|
"status": "CURRENT",
|
|
"updated": "2017-03-23T17:34:02Z"
|
|
},
|
|
"versions": {
|
|
"id": "v1.0",
|
|
"links": [{
|
|
"href": "",
|
|
"rel": "self"
|
|
}],
|
|
"status": "CURRENT",
|
|
"updated": "2017-03-23T17:34:02Z"
|
|
}
|
|
}</pre>
|
|
</li><li id="en-us_topic_0057306832__li3272104617508">Abnormal response<p id="en-us_topic_0057306832__ade217b3cc8df43ae9860bc62de76e932"><a name="en-us_topic_0057306832__li3272104617508"></a><a name="li3272104617508"></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_0057306832__section4778540915440"><h4 class="sectiontitle">Status Code</h4><ul id="en-us_topic_0057306832__en-us_topic_0032347778_ul7858132212142"><li id="en-us_topic_0057306832__en-us_topic_0032347778_li58581622171411">Normal<p id="en-us_topic_0057306832__en-us_topic_0032347778_p1040982941020"><a name="en-us_topic_0057306832__en-us_topic_0032347778_li58581622171411"></a><a name="en-us_topic_0032347778_li58581622171411"></a>200</p>
|
|
</li><li id="en-us_topic_0057306832__en-us_topic_0032347778_li11583183218149">Abnormal<p id="en-us_topic_0057306832__en-us_topic_0032347778_p0723374409"><a name="en-us_topic_0057306832__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_0057306832__section1183074220016"><h4 class="sectiontitle">Error Code</h4><p id="en-us_topic_0057306832__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>
|
|
|