doc-exports/docs/vpn/api-ref/en_topic_0093011517.html
gtema 6b71b4a1fa Initial import of the VPN API document
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: gtema <artem.goncharov@gmail.com>
Co-committed-by: gtema <artem.goncharov@gmail.com>
2022-12-07 13:22:09 +00:00

115 lines
9.0 KiB
HTML

<a name="en_topic_0093011517"></a><a name="en_topic_0093011517"></a>
<h1 class="topictitle1">Querying Details About a VPN Endpoint Group</h1>
<div id="body8662426"><div class="section" id="en_topic_0093011517__en-us_topic_0053740027_section33876408"><h4 class="sectiontitle"><strong id="en_topic_0093011517__en-us_topic_0053740027_b842352706112523">Function</strong></h4><p id="en_topic_0093011517__en-us_topic_0053740027_p54770906">This interface is used to query details about a VPN endpoint group.</p>
</div>
<div class="section" id="en_topic_0093011517__en-us_topic_0053740027_section36452220"><h4 class="sectiontitle">URI</h4><p id="en_topic_0093011517__p1142710172218">GET /v2.0/vpn/endpoint-groups/{endpoint_group_id}</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en_topic_0093011517__table19418153522110" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en_topic_0093011517__row10418143532118"><th align="left" class="cellrowborder" valign="top" width="25.507449255074494%" id="mcps1.3.2.3.2.5.1.1"><p id="en_topic_0093011517__p11427103572112"><strong id="en_topic_0093011517__b842352706172115">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.288571142885711%" id="mcps1.3.2.3.2.5.1.2"><p id="en_topic_0093011517__p84273352212">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.288571142885711%" id="mcps1.3.2.3.2.5.1.3"><p id="en_topic_0093011517__p242718358217">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.91540845915409%" id="mcps1.3.2.3.2.5.1.4"><p id="en_topic_0093011517__p104271435152111">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en_topic_0093011517__row44271735192115"><td class="cellrowborder" valign="top" width="25.507449255074494%" headers="mcps1.3.2.3.2.5.1.1 "><p id="en_topic_0093011517__p743473572111">endpoint_group_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.2.3.2.5.1.2 "><p id="en_topic_0093011517__p3434143514215">String</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.2.3.2.5.1.3 "><p id="en_topic_0093011517__p10434143592116">No</p>
</td>
<td class="cellrowborder" valign="top" width="45.91540845915409%" headers="mcps1.3.2.3.2.5.1.4 "><p id="en_topic_0093011517__p043443522110">Specifies the VPN endpoint group ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="en_topic_0093011517__en-us_topic_0053740027_section66948675"><h4 class="sectiontitle">Request Message</h4><p id="en_topic_0093011517__p102334784918">None</p>
</div>
<div class="section" id="en_topic_0093011517__en-us_topic_0053740027_section65667169"><h4 class="sectiontitle">Response Message</h4><p id="en_topic_0093011517__p5610128122216"><a href="#en_topic_0093011517__en-us_topic_0053740027_table58761073">Table 2</a> describes the response parameters.</p>
<div class="tablenoborder"><a name="en_topic_0093011517__en-us_topic_0053740027_table58761073"></a><a name="en-us_topic_0053740027_table58761073"></a><table cellpadding="4" cellspacing="0" summary="" id="en_topic_0093011517__en-us_topic_0053740027_table58761073" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameters</caption><thead align="left"><tr id="en_topic_0093011517__en-us_topic_0053740027_row2491394"><th align="left" class="cellrowborder" valign="top" width="29.76%" id="mcps1.3.4.3.2.4.1.1"><p id="en_topic_0093011517__en-us_topic_0053740027_p476380">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.67%" id="mcps1.3.4.3.2.4.1.2"><p id="en_topic_0093011517__en-us_topic_0053740027_p38586810">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="53.57000000000001%" id="mcps1.3.4.3.2.4.1.3"><p id="en_topic_0093011517__en-us_topic_0053740027_p33428900">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en_topic_0093011517__en-us_topic_0053740027_row23386368"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011517__en-us_topic_0053740027_p15247616">description</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011517__en-us_topic_0053740027_p27097356">Object</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011517__en-us_topic_0053740027_p14377323">Provides supplementary information about the VPN endpoint group.</p>
</td>
</tr>
<tr id="en_topic_0093011517__en-us_topic_0053740027_row62287048"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011517__en-us_topic_0053740027_p12086140">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011517__en-us_topic_0053740027_p39453247">String</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011517__en-us_topic_0053740027_p13871385">Specifies the project ID.</p>
</td>
</tr>
<tr id="en_topic_0093011517__en-us_topic_0053740027_row57733603"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011517__en-us_topic_0053740027_p45910260">endpoints</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011517__en-us_topic_0053740027_p27743545">List</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011517__en-us_topic_0053740027_p26161025">Specifies the endpoint list. The endpoints in a list must be of the same type.</p>
</td>
</tr>
<tr id="en_topic_0093011517__en-us_topic_0053740027_row34122633"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011517__en-us_topic_0053740027_p12469873">type</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011517__en-us_topic_0053740027_p3426769">String</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011517__en-us_topic_0053740027_p1565979">Specifies the endpoint type. The value can be <strong id="en_topic_0093011517__en-us_topic_0053740027_b126583707521264">subnet</strong> or <strong id="en_topic_0093011517__en-us_topic_0053740027_b191796307321264">cidr</strong>.</p>
</td>
</tr>
<tr id="en_topic_0093011517__en-us_topic_0053740027_row14093819"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011517__en-us_topic_0053740027_p748676">id</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011517__en-us_topic_0053740027_p60642794">String</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011517__en-us_topic_0053740027_p56026474">Specifies the VPN endpoint group ID.</p>
</td>
</tr>
<tr id="en_topic_0093011517__en-us_topic_0053740027_row34476226"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011517__en-us_topic_0053740027_p41110918">name</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011517__en-us_topic_0053740027_p41650091">String</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011517__en-us_topic_0053740027_p66066743">Specifies the VPN endpoint group name.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="en_topic_0093011517__en-us_topic_0053740027_section54133615"><h4 class="sectiontitle">Example</h4><ul id="en_topic_0093011517__ul2600135920223"><li id="en_topic_0093011517__li17600145910223">Example Request<pre class="screen" id="en_topic_0093011517__en-us_topic_0053740027_screen60038205">GET /v2.0/vpn/endpoint-groups/{endpoint_group_id}</pre>
</li></ul>
</div>
<ul id="en_topic_0093011517__ul5803063231"><li id="en_topic_0093011517__li5803106142317">Example Response<pre class="screen" id="en_topic_0093011517__screen2950916162313">{
"endpoint_group": {
"description": "",
"tenant_id": "4ad57e7ce0b24fca8f12b9834d91079d",
"endpoints": [
"10.2.0.0/24",
"10.3.0.0/24"
],
"type": "cidr",
"id": "6ecd9cf3-ca64-46c7-863f-f2eb1b9e838a",
"name": "peers"
}
}</pre>
</li></ul>
<div class="section" id="en_topic_0093011517__section6578292"><h4 class="sectiontitle">Returned Values</h4><p id="en_topic_0093011517__en-us_topic_0053740035_p19515943486">For details, see section <a href="en_topic_0093011522.html">Common Returned Values</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en_topic_0093011515.html">VPN Endpoint Group Management</a></div>
</div>
</div>