forked from docs/doc-exports
Qin Ying, Fan
62ab8a5fe2
Reviewed-by: Sarda, Priya <prsarda@noreply.gitea.eco.tsi-dev.otc-service.com> Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com> Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>
115 lines
9.1 KiB
HTML
115 lines
9.1 KiB
HTML
<a name="en-us_topic_0055025311"></a><a name="en-us_topic_0055025311"></a>
|
|
|
|
<h1 class="topictitle1">Querying All API Versions</h1>
|
|
<div id="body1539740810917"><div class="section" id="en-us_topic_0055025311__section109661156152112"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0055025311__p18437102532211">This API is used to query all API versions supported by Direct Connect.</p>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0055025311__section11867232184814"><h4 class="sectiontitle">URI</h4><p id="en-us_topic_0055025311__p9229183914812">GET /</p>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0055025311__section24112512"><h4 class="sectiontitle">Request</h4><p id="en-us_topic_0055025311__p45638969">None</p>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0055025311__section15686020"><a name="en-us_topic_0055025311__section15686020"></a><a name="section15686020"></a><h4 class="sectiontitle">Response</h4><p id="en-us_topic_0055025311__p81037681212"><a href="#en-us_topic_0055025311__table49902238182444">Table 1</a> lists the response parameters.</p>
|
|
|
|
<div class="tablenoborder"><a name="en-us_topic_0055025311__table49902238182444"></a><a name="table49902238182444"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0055025311__table49902238182444" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Response parameters</caption><thead align="left"><tr id="en-us_topic_0055025311__row27727643182444"><th align="left" class="cellrowborder" valign="top" width="25.277472252774725%" id="mcps1.3.4.3.2.4.1.1"><p id="en-us_topic_0055025311__p44979764154022">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25.01749825017498%" id="mcps1.3.4.3.2.4.1.2"><p id="en-us_topic_0055025311__p19482271154022">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="49.7050294970503%" id="mcps1.3.4.3.2.4.1.3"><p id="en-us_topic_0055025311__p47904218154022">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="en-us_topic_0055025311__row27455432182444"><td class="cellrowborder" valign="top" width="25.277472252774725%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en-us_topic_0055025311__p14315331153">versions</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.01749825017498%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en-us_topic_0055025311__p183213310519">List</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.7050294970503%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en-us_topic_0055025311__p7328337520">Specifies all API versions.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0055025311__row39593523182444"><td class="cellrowborder" valign="top" width="25.277472252774725%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en-us_topic_0055025311__p1326331857">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.01749825017498%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en-us_topic_0055025311__p183219331352">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.7050294970503%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en-us_topic_0055025311__p103293310511">Specifies the version number, for example, <strong id="en-us_topic_0055025311__b842352706151910">v2.0</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0055025311__row64801111182444"><td class="cellrowborder" valign="top" width="25.277472252774725%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en-us_topic_0055025311__p13233311516">links</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.01749825017498%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en-us_topic_0055025311__p932153310512">Array</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.7050294970503%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en-us_topic_0055025311__p13211331354">Specifies the API URL.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0055025311__row1144591413177"><td class="cellrowborder" valign="top" width="25.277472252774725%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en-us_topic_0055025311__p124464144178">href</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.01749825017498%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en-us_topic_0055025311__p244781412174">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.7050294970503%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en-us_topic_0055025311__p944741418176">Specifies the reference address of the current API version.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0055025311__row1383361812179"><td class="cellrowborder" valign="top" width="25.277472252774725%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en-us_topic_0055025311__p168331418121713">rel</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.01749825017498%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en-us_topic_0055025311__p17833131818174">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.7050294970503%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en-us_topic_0055025311__p188334182178">Specifies the relationship between the current API version and the referenced address.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0055025311__row162641945172612"><td class="cellrowborder" valign="top" width="25.277472252774725%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en-us_topic_0055025311__p14185402610">version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.01749825017498%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en-us_topic_0055025311__p111165442615">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.7050294970503%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en-us_topic_0055025311__p81145413260">Specifies the version. If APIs of this version support minor versions, set this parameter to the supported maximum minor version. If minor versions are not supported, leave this parameter blank.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0055025311__row48951951182444"><td class="cellrowborder" valign="top" width="25.277472252774725%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en-us_topic_0055025311__p19326339519">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.01749825017498%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en-us_topic_0055025311__p1432193314519">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.7050294970503%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en-us_topic_0055025311__p9331331653">Specifies the version status. Value options are as follows:</p>
|
|
<ul id="en-us_topic_0055025311__ul1936014510535"><li id="en-us_topic_0055025311__li14360125185320"><strong id="en-us_topic_0055025311__b13417575115">CURRENT</strong>: indicates a primary version.</li><li id="en-us_topic_0055025311__li169411719532"><strong id="en-us_topic_0055025311__b1727115171214">SUPPORTED</strong>: indicates an old version that is still supported.</li><li id="en-us_topic_0055025311__li5817131015535"><strong id="en-us_topic_0055025311__b855372871217">DEPRECATED</strong>: indicates a deprecated version that may be deleted later.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0055025311__row1230116345302"><td class="cellrowborder" valign="top" width="25.277472252774725%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en-us_topic_0055025311__p4868193513015">updated</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.01749825017498%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en-us_topic_0055025311__p7868835153014">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.7050294970503%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en-us_topic_0055025311__p2086903563016">Specifies the version release time in UTC. For example, the release time format of v2.0 APIs is YYYY-MM-DDTHH:MM:SSZ.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="en-us_topic_0055025311__row3302134133014"><td class="cellrowborder" valign="top" width="25.277472252774725%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en-us_topic_0055025311__p1486919351303">min_version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.01749825017498%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en-us_topic_0055025311__p1486913358304">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="49.7050294970503%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en-us_topic_0055025311__p19869123514308">Specifies the version. If APIs of this version support minor versions, set this parameter to the supported minimum minor version. If minor versions are not supported, leave this parameter blank.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="en-us_topic_0055025311__section542210409508"><h4 class="sectiontitle">Examples</h4><ul id="en-us_topic_0055025311__ul164071549155019"><li id="en-us_topic_0055025311__li2407104935015">Example request<pre class="screen" id="en-us_topic_0055025311__screen48295303132">GET /</pre>
|
|
</li><li id="en-us_topic_0055025311__li426275618505"><a name="en-us_topic_0055025311__li426275618505"></a><a name="li426275618505"></a>Example response<pre class="screen" id="en-us_topic_0055025311__screen188045113403">{
|
|
"versions": [
|
|
{
|
|
"id": "v2.0",
|
|
"links": [
|
|
{
|
|
"href": "https://dcaas.eu-de.otc.t-systems.com/v2.0",
|
|
"rel": "self"
|
|
}
|
|
],
|
|
"min_version": "",
|
|
"updated": "YYYY-MM-DDTHH:MM:SSZ",
|
|
"status": "CURRENT",
|
|
"version": ""
|
|
}
|
|
]
|
|
}</pre>
|
|
</li></ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-us_topic_0055025310.html">API Version</a></div>
|
|
</div>
|
|
</div>
|
|
|