doc-exports/docs/vpn/api-ref/en_topic_0093011519.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

151 lines
13 KiB
HTML

<a name="en_topic_0093011519"></a><a name="en_topic_0093011519"></a>
<h1 class="topictitle1">Updating a VPN Endpoint Group</h1>
<div id="body8662426"><div class="section" id="en_topic_0093011519__en-us_topic_0053740031_section21433709"><h4 class="sectiontitle"><strong id="en_topic_0093011519__en-us_topic_0053740031_b842352706112523">Function</strong></h4><p id="en_topic_0093011519__en-us_topic_0053740031_p62483297">This interface is used to update a VPN endpoint group.</p>
</div>
<div class="section" id="en_topic_0093011519__en-us_topic_0053740031_section58685656"><h4 class="sectiontitle">URI</h4><p id="en_topic_0093011519__p108161168263">PUT /v2.0/vpn/endpoint-groups/{endpoint_group_id}</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en_topic_0093011519__table19418153522110" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en_topic_0093011519__row10418143532118"><th align="left" class="cellrowborder" valign="top" width="25.507449255074494%" id="mcps1.3.2.3.2.5.1.1"><p id="en_topic_0093011519__p11427103572112"><strong id="en_topic_0093011519__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_0093011519__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_0093011519__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_0093011519__p104271435152111">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en_topic_0093011519__row44271735192115"><td class="cellrowborder" valign="top" width="25.507449255074494%" headers="mcps1.3.2.3.2.5.1.1 "><p id="en_topic_0093011519__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_0093011519__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_0093011519__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_0093011519__p043443522110">Specifies the VPN endpoint group ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="en_topic_0093011519__en-us_topic_0053740031_section55917699"><h4 class="sectiontitle">Request Message</h4><p id="en_topic_0093011519__p13307101015270"><a href="#en_topic_0093011519__en-us_topic_0053740031_table16221316">Table 2</a> describes the request parameters.</p>
<div class="tablenoborder"><a name="en_topic_0093011519__en-us_topic_0053740031_table16221316"></a><a name="en-us_topic_0053740031_table16221316"></a><table cellpadding="4" cellspacing="0" summary="" id="en_topic_0093011519__en-us_topic_0053740031_table16221316" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="en_topic_0093011519__en-us_topic_0053740031_row20649961"><th align="left" class="cellrowborder" valign="top" width="25.507449255074494%" id="mcps1.3.3.3.2.5.1.1"><p id="en_topic_0093011519__en-us_topic_0053740031_p62034116">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.288571142885711%" id="mcps1.3.3.3.2.5.1.2"><p id="en_topic_0093011519__en-us_topic_0053740031_p58707504">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.288571142885711%" id="mcps1.3.3.3.2.5.1.3"><p id="en_topic_0093011519__en-us_topic_0053740031_p57687380">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.91540845915409%" id="mcps1.3.3.3.2.5.1.4"><p id="en_topic_0093011519__en-us_topic_0053740031_p42166233">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en_topic_0093011519__en-us_topic_0053740031_row58467488"><td class="cellrowborder" valign="top" width="25.507449255074494%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en_topic_0093011519__en-us_topic_0053740031_p38246063">description</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en_topic_0093011519__en-us_topic_0053740031_p10923387">String</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en_topic_0093011519__en-us_topic_0053740031_p12379115">No</p>
</td>
<td class="cellrowborder" valign="top" width="45.91540845915409%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en_topic_0093011519__en-us_topic_0053740031_p63184231">Provides supplementary information about the VPN endpoint group.</p>
</td>
</tr>
<tr id="en_topic_0093011519__en-us_topic_0053740031_row31787174"><td class="cellrowborder" valign="top" width="25.507449255074494%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en_topic_0093011519__en-us_topic_0053740031_p24624288">name</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en_topic_0093011519__en-us_topic_0053740031_p48410331">String</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en_topic_0093011519__en-us_topic_0053740031_p28922751">No</p>
</td>
<td class="cellrowborder" valign="top" width="45.91540845915409%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en_topic_0093011519__en-us_topic_0053740031_p61041458">Specifies the VPN endpoint group name.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="note" id="en_topic_0093011519__note268345013266"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ol id="en_topic_0093011519__ol12206115117268"><li id="en_topic_0093011519__li15214115114263">The <strong id="en_topic_0093011519__en-us_topic_0053740031_b84235270692755">endpoint_group_id</strong> parameter must be specified.</li><li id="en_topic_0093011519__li1421485113266">The value of <strong id="en_topic_0093011519__en-us_topic_0053740031_b842352706144933">name</strong> can contain 1 to 64 characters.</li><li id="en_topic_0093011519__li321419514269">The value of <strong id="en_topic_0093011519__en-us_topic_0053740031_b120501305120950">description</strong> can contain a maximum of 255 characters.</li><li id="en_topic_0093011519__li1214135117269">The <strong id="en_topic_0093011519__en-us_topic_0053740031_b84235270620329">project_id</strong> parameter is not supported.</li></ol>
</div></div>
</div>
<div class="section" id="en_topic_0093011519__en-us_topic_0053740031_section33497244"><h4 class="sectiontitle">Response Message</h4><p id="en_topic_0093011519__p068883719278"><a href="#en_topic_0093011519__en-us_topic_0053740031_table45411103">Table 3</a> describes the response parameters.</p>
<div class="tablenoborder"><a name="en_topic_0093011519__en-us_topic_0053740031_table45411103"></a><a name="en-us_topic_0053740031_table45411103"></a><table cellpadding="4" cellspacing="0" summary="" id="en_topic_0093011519__en-us_topic_0053740031_table45411103" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response parameters</caption><thead align="left"><tr id="en_topic_0093011519__en-us_topic_0053740031_row48031108"><th align="left" class="cellrowborder" valign="top" width="29.76%" id="mcps1.3.4.3.2.4.1.1"><p id="en_topic_0093011519__en-us_topic_0053740031_p65314517">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_0093011519__en-us_topic_0053740031_p55984556">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_0093011519__en-us_topic_0053740031_p27859461">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en_topic_0093011519__en-us_topic_0053740031_row42023897"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011519__en-us_topic_0053740031_p48492497">description</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011519__en-us_topic_0053740031_p35578198">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011519__en-us_topic_0053740031_p23930149">Provides supplementary information about the VPN endpoint group.</p>
</td>
</tr>
<tr id="en_topic_0093011519__en-us_topic_0053740031_row14044750"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011519__en-us_topic_0053740031_p63882937">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_0093011519__en-us_topic_0053740031_p7135413">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011519__en-us_topic_0053740031_p40569470">Specifies the project ID.</p>
</td>
</tr>
<tr id="en_topic_0093011519__en-us_topic_0053740031_row29580916"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011519__en-us_topic_0053740031_p47244029">endpoints</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011519__en-us_topic_0053740031_p1561146">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011519__en-us_topic_0053740031_p42136306">Specifies the endpoint list. The endpoints in a list must be of the same type.</p>
</td>
</tr>
<tr id="en_topic_0093011519__en-us_topic_0053740031_row43682438"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011519__en-us_topic_0053740031_p48616614">type</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011519__en-us_topic_0053740031_p45631679">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011519__en-us_topic_0053740031_p16804345">Specifies the endpoint type. The value can be <strong id="en_topic_0093011519__en-us_topic_0053740031_b126583707521264">subnet</strong> or <strong id="en_topic_0093011519__en-us_topic_0053740031_b191796307321264">cidr</strong>.</p>
</td>
</tr>
<tr id="en_topic_0093011519__en-us_topic_0053740031_row17021380"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011519__en-us_topic_0053740031_p36554565">id</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011519__en-us_topic_0053740031_p8129827">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011519__en-us_topic_0053740031_p55361044">Specifies the VPN endpoint group ID.</p>
</td>
</tr>
<tr id="en_topic_0093011519__en-us_topic_0053740031_row28487351"><td class="cellrowborder" valign="top" width="29.76%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en_topic_0093011519__en-us_topic_0053740031_p25774132">name</p>
</td>
<td class="cellrowborder" valign="top" width="16.67%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en_topic_0093011519__en-us_topic_0053740031_p7329937">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="53.57000000000001%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en_topic_0093011519__en-us_topic_0053740031_p41771788">Provides supplementary information about the VPN endpoint group.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="en_topic_0093011519__en-us_topic_0053740031_section33039746"><h4 class="sectiontitle">Example</h4><ul id="en_topic_0093011519__ul339321182816"><li id="en_topic_0093011519__li839316116284">Example Request<pre class="screen" id="en_topic_0093011519__en-us_topic_0053740031_screen21336517215226">PUT /v2.0/vpn/endpoint-groups/{endpoint_group_id}
{
"endpoint_group" : {
"description" : "New description"
}
}</pre>
</li></ul>
</div>
<ul id="en_topic_0093011519__ul13191313142816"><li id="en_topic_0093011519__li919101352816">Example Response<pre class="screen" id="en_topic_0093011519__screen1938510215287">{
"endpoint_group" : {
"description" : "New 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_0093011519__section6578292"><h4 class="sectiontitle">Returned Values</h4><p id="en_topic_0093011519__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>