vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/vpn/api-ref/vpn_api_1048.html
Hongwei, King Wang 32c06a10a2 vpn_api 
Reviewed-by: Sarda, Priya <prsarda@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-authored-by: Hongwei, King Wang <king.wanghongwei@huawei.com>
Co-committed-by: Hongwei, King Wang <king.wanghongwei@huawei.com>
2024-08-15 14:18:28 +00:00

176 lines
18 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001807370560"></a><a name="EN-US_TOPIC_0000001807370560"></a>
<h1 class="topictitle1">Creating a VPN Endpoint Group</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_section57841469"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p19009899">This API is used to create a VPN endpoint group.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_section50811173"><h4 class="sectiontitle">URI</h4><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p35111058151818">POST /v2.0/vpn/endpoint-groups</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_section22064367"><h4 class="sectiontitle">Request</h4><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p1014039171919"><a href="#EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_table31025868">Table 1</a> describes the request parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_table31025868"></a><a name="en-us_topic_0000001591736549_en-us_topic_0053740037_table31025868"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_table31025868" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row17177639"><th align="left" class="cellrowborder" valign="top" width="25.507449255074494%" id="mcps1.3.3.3.2.5.1.1"><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p49211517">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-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p26709911">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-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p16019165">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-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p22484025">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row9266704"><td class="cellrowborder" valign="top" width="25.507449255074494%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p12405580">endpoints</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p65327957">List&lt;String&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p57073170">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="45.91540845915409%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p59524076">Specifies the endpoint list. The endpoints in a list must be of the same type.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row65954639"><td class="cellrowborder" valign="top" width="25.507449255074494%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p40725534">type</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p10433982">String</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p39846231">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="45.91540845915409%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p6319248">Specifies the endpoint type, which can be <strong id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_b126583707521264">subnet</strong> or <strong id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_b191796307321264">cidr</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row56873232"><td class="cellrowborder" valign="top" width="25.507449255074494%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p43329052">name</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p19992349">String</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p8767611">No</p>
</td>
<td class="cellrowborder" valign="top" width="45.91540845915409%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p39087901">Specifies the name of the VPN endpoint group.</p>
<p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p180071901117">The name can contain 1 to 64 characters.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row16246796"><td class="cellrowborder" valign="top" width="25.507449255074494%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p40922063">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p26352844">String</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p54205609">No</p>
</td>
<td class="cellrowborder" valign="top" width="45.91540845915409%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p28578190">Specifies the project ID.</p>
<p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p1847018711119">The ID can contain up to 255 characters.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row8017921"><td class="cellrowborder" valign="top" width="25.507449255074494%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p45471841">description</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p59340514">String</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p41852331">No</p>
</td>
<td class="cellrowborder" valign="top" width="45.91540845915409%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p34595685">Provides supplementary information about the VPN endpoint group.</p>
<p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p3163113315119">The description can contain up to 255 characters.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_row1587014171172"><td class="cellrowborder" valign="top" width="25.507449255074494%" headers="mcps1.3.3.3.2.5.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p5871161710719">endpoint_group</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p178711817274">Object</p>
</td>
<td class="cellrowborder" valign="top" width="14.288571142885711%" headers="mcps1.3.3.3.2.5.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p38718171972">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="45.91540845915409%" headers="mcps1.3.3.3.2.5.1.4 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p48711317678">Specifies the endpoint group.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="note" id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_note1052123018198"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p3359125313119">Parameter <strong id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_b8390134122810">project_id</strong> is not supported.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_section64361578"><h4 class="sectiontitle">Response</h4><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p116708502015"><a href="#EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_table50787128">Table 2</a> describes the response parameters.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_table50787128"></a><a name="en-us_topic_0000001591736549_en-us_topic_0053740037_table50787128"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_table50787128" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row43130086"><th align="left" class="cellrowborder" valign="top" width="29.759999999999998%" id="mcps1.3.4.3.2.4.1.1"><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p3876045">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.79%" id="mcps1.3.4.3.2.4.1.2"><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p45524249">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.45%" id="mcps1.3.4.3.2.4.1.3"><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p50158847">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row36334825"><td class="cellrowborder" valign="top" width="29.759999999999998%" headers="mcps1.3.4.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037__Hlk477536615">description</p>
</td>
<td class="cellrowborder" valign="top" width="24.79%" headers="mcps1.3.4.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p22104370">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.45%" headers="mcps1.3.4.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p4517709">Provides supplementary information about the VPN endpoint group.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row40659381"><td class="cellrowborder" valign="top" width="29.759999999999998%" headers="mcps1.3.4.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p5075526">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="24.79%" headers="mcps1.3.4.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p8464456">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.45%" headers="mcps1.3.4.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p36267453">Specifies the project ID.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row57971626"><td class="cellrowborder" valign="top" width="29.759999999999998%" headers="mcps1.3.4.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p65190153">endpoints</p>
</td>
<td class="cellrowborder" valign="top" width="24.79%" headers="mcps1.3.4.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p45911036">List&lt;String&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="45.45%" headers="mcps1.3.4.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p37729472">Specifies the endpoint list. The endpoints in a list must be of the same type.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row4020931"><td class="cellrowborder" valign="top" width="29.759999999999998%" headers="mcps1.3.4.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p57260009">type</p>
</td>
<td class="cellrowborder" valign="top" width="24.79%" headers="mcps1.3.4.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p7549159">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.45%" headers="mcps1.3.4.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p3697038">Specifies the endpoint type, which can be <strong id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_b3923145242816">subnet</strong> or <strong id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_b12924135217280">cidr</strong>.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row33273344"><td class="cellrowborder" valign="top" width="29.759999999999998%" headers="mcps1.3.4.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p10786359">id</p>
</td>
<td class="cellrowborder" valign="top" width="24.79%" headers="mcps1.3.4.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p1279915">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.45%" headers="mcps1.3.4.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p8917608">Specifies the ID of the VPN endpoint group.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_row13149610"><td class="cellrowborder" valign="top" width="29.759999999999998%" headers="mcps1.3.4.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p58485517">name</p>
</td>
<td class="cellrowborder" valign="top" width="24.79%" headers="mcps1.3.4.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p39706416">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.45%" headers="mcps1.3.4.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_p64295127">Specifies the name of the VPN endpoint group.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_row1640285212263"><td class="cellrowborder" valign="top" width="29.759999999999998%" headers="mcps1.3.4.3.2.4.1.1 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p17177165482618">endpoint_group</p>
</td>
<td class="cellrowborder" valign="top" width="24.79%" headers="mcps1.3.4.3.2.4.1.2 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p10177185482613">Object</p>
</td>
<td class="cellrowborder" valign="top" width="45.45%" headers="mcps1.3.4.3.2.4.1.3 "><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_p171772541265">Specifies the object of the VPN endpoint group.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_section42383293"><h4 class="sectiontitle">Example</h4><ul id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_ul13354194017208"><li id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_li11354134042019">Example request<pre class="screen" id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740037_screen546501417349">POST /v2.0/vpn/endpoint-groups
{
"endpoint_group" : {
"endpoints" : [ "10.2.0.0/24", "10.3.0.0/24" ],
"type" : "cidr",
"name" : "peers"
}
}</pre>
</li></ul>
</div>
<ul id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_ul10470497202"><li id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_li44714972012">Example response<pre class="screen" id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_screen1606358102013">{
"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-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_section6578292"><h4 class="sectiontitle">Returned Values</h4><p id="EN-US_TOPIC_0000001807370560__en-us_topic_0000001591736549_en-us_topic_0053740035_p19515943486">For details, see <a href="vpn_api_1054.html#EN-US_TOPIC_0000001854089293">Common Returned Values</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="vpn_api_1047.html">VPN Endpoint Group Management</a></div>
</div>
</div>
View Git Blame Copy Permalink