doc-exports/docs/antiddos/api-ref/antiddos_02_0007.html
Li, Qiao 6c7c1c9d99 AntiDDoS API 20240914 version
Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com>
Co-authored-by: Li, Qiao <qiaoli@huawei.com>
Co-committed-by: Li, Qiao <qiaoli@huawei.com>
2024-11-06 12:22:01 +00:00

134 lines
9.1 KiB
HTML

<a name="antiddos_02_0007"></a><a name="antiddos_02_0007"></a>
<h1 class="topictitle1">Querying a Specified API Version</h1>
<div id="body1538213689775"><div class="section" id="antiddos_02_0007__section63597034"><h4 class="sectiontitle">Functions</h4><p class="MsoNormal" id="antiddos_02_0007__p23083503">This API allows you to query a specified API version.</p>
</div>
<div class="section" id="antiddos_02_0007__section35502400"><h4 class="sectiontitle">URI</h4><ul id="antiddos_02_0007__ul57824424"><li id="antiddos_02_0007__li50657768">URI format<p id="antiddos_02_0007__p37428884152022"><a name="antiddos_02_0007__li50657768"></a><a name="li50657768"></a>GET /{version_id}</p>
</li></ul>
</div>
<div class="section" id="antiddos_02_0007__section51086148"><h4 class="sectiontitle">Request</h4><p id="antiddos_02_0007__p025010221878"><strong id="antiddos_02_0007__b112138497215">Request parameters</strong></p>
<p id="antiddos_02_0007__p1171310105712">None</p>
</div>
<div class="section" id="antiddos_02_0007__section57122151"><h4 class="sectiontitle">Response</h4><ul id="antiddos_02_0007__ul36643426"><li id="antiddos_02_0007__li61355386">Parameter description
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0007__table15327568" frame="border" border="1" rules="all"><thead align="left"><tr id="antiddos_02_0007__row24486356"><th align="left" class="cellrowborder" valign="top" width="30.099999999999998%" id="mcps1.3.4.2.1.1.1.4.1.1"><p id="antiddos_02_0007__p37237828">Name</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="22.99%" id="mcps1.3.4.2.1.1.1.4.1.2"><p id="antiddos_02_0007__p63474072">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46.910000000000004%" id="mcps1.3.4.2.1.1.1.4.1.3"><p id="antiddos_02_0007__p41126201">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="antiddos_02_0007__row42887950"><td class="cellrowborder" valign="top" width="30.099999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0007__p51371903">version</p>
</td>
<td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0007__p2142367152712">Data structure</p>
</td>
<td class="cellrowborder" valign="top" width="46.910000000000004%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0007__p30346328">Version object</p>
</td>
</tr>
<tr id="antiddos_02_0007__row4681502"><td class="cellrowborder" valign="top" width="30.099999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0007__p1264115702215">id</p>
</td>
<td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0007__p46585119">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.910000000000004%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0007__p15298296">Version ID (Version number), for example, v 1</p>
</td>
</tr>
<tr id="antiddos_02_0007__row3466944"><td class="cellrowborder" valign="top" width="30.099999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0007__p12387033">links</p>
</td>
<td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0007__p63825615">List data structure</p>
</td>
<td class="cellrowborder" valign="top" width="46.910000000000004%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0007__p2492297">URL of the API</p>
</td>
</tr>
<tr id="antiddos_02_0007__row144801646162619"><td class="cellrowborder" valign="top" width="30.099999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0007__p34811461266">min_version</p>
</td>
<td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0007__p6550258270">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.910000000000004%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0007__p448174612618">If this API version supports microversions, the minimum microversion number is returned. If microversions are not supported, no value is returned.</p>
</td>
</tr>
<tr id="antiddos_02_0007__row19836152372716"><td class="cellrowborder" valign="top" width="30.099999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0007__p383610239276">status</p>
</td>
<td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0007__p118361023142716">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.910000000000004%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0007__p1338013918285">Version status. Valid values are as follows:</p>
<p id="antiddos_02_0007__p12382393282">CURRENT: Indicates that the version is the primary version.</p>
<p id="antiddos_02_0007__p5382189202813">SUPPORTED: Indicates that the version is an old version, but it is still supported.</p>
<p id="antiddos_02_0007__p738219202816">DEPRECATED: Indicates that this version is a discarded version and may be deleted later.</p>
</td>
</tr>
<tr id="antiddos_02_0007__row1910182213287"><td class="cellrowborder" valign="top" width="30.099999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0007__p610114226281">updated</p>
</td>
<td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0007__p181019227289">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.910000000000004%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0007__p4101132219286">Version release time</p>
</td>
</tr>
<tr id="antiddos_02_0007__row644342203017"><td class="cellrowborder" valign="top" width="30.099999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0007__p14446142153012">version</p>
</td>
<td class="cellrowborder" valign="top" width="22.99%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0007__p16446529302">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.910000000000004%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0007__p7446152173011">If this API version supports microversions, the maximum microversion number is returned. If microversions are not supported, no value is returned.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="antiddos_02_0007__ul549487"><li id="antiddos_02_0007__li4945391">Data structure description of <strong id="antiddos_02_0007__b986916122420">links</strong>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0007__table44508523" frame="border" border="1" rules="all"><thead align="left"><tr id="antiddos_02_0007__row13604004"><th align="left" class="cellrowborder" valign="top" width="37.34%" id="mcps1.3.4.3.1.2.1.4.1.1"><p id="antiddos_02_0007__p28182506">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.540000000000003%" id="mcps1.3.4.3.1.2.1.4.1.2"><p id="antiddos_02_0007__p20504736">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="37.12%" id="mcps1.3.4.3.1.2.1.4.1.3"><p id="antiddos_02_0007__p50270944">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="antiddos_02_0007__row45414681"><td class="cellrowborder" valign="top" width="37.34%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0007__p54710514">href</p>
</td>
<td class="cellrowborder" valign="top" width="25.540000000000003%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0007__p53636340152723">String</p>
</td>
<td class="cellrowborder" valign="top" width="37.12%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0007__p25189967">URL of the API</p>
</td>
</tr>
<tr id="antiddos_02_0007__row25383117"><td class="cellrowborder" valign="top" width="37.34%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0007__p42766607">rel</p>
</td>
<td class="cellrowborder" valign="top" width="25.540000000000003%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0007__p65381003152726">String</p>
</td>
<td class="cellrowborder" valign="top" width="37.12%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0007__p35618305">self</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="antiddos_02_0007__section13514162695711"><h4 class="sectiontitle">Example</h4><ul id="antiddos_02_0007__ul178811332182913"><li id="antiddos_02_0007__li966416362293">Example request<pre class="codeblock" id="antiddos_02_0007__codeblock13342439152134">GET /v1</pre>
</li></ul>
</div>
<ul id="antiddos_02_0007__ul1052817261570"><li id="antiddos_02_0007__li1752810260579">Example response<pre class="screen" id="antiddos_02_0007__screen14527192612571">{
"version":
{
"id": "v1",
"links": [
{
"href": "https://antiddos.eu-de.otc.t-systems.com/v1/",
"rel": "self"
}
],
"min_version": "",
"status": "CURRENT",
"updated": "2016-10-29T00:00:00Z",
"version": ""
}
}</pre>
</li></ul>
<div class="section" id="antiddos_02_0007__section44337314"><h4 class="sectiontitle">Status Code</h4><p class="MsoNormal" id="antiddos_02_0007__p1824493">For details, see <a href="antiddos_02_0031.html">Status Code</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="antiddos_02_0016.html">Anti-DDoS APIs</a></div>
</div>
</div>