doc-exports/docs/vpcep/api-ref/vpcep_06_0303.html
Qin Ying, Fan e1710ee7e4 VPCEP API 20240912 version
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>
2024-11-06 11:17:39 +00:00

652 lines
56 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<a name="vpcep_06_0303"></a><a name="vpcep_06_0303"></a>
<h1 class="topictitle1">Creating a VPC Endpoint</h1>
<div id="body41429793"><div class="section" id="vpcep_06_0303__section43389233"><a name="vpcep_06_0303__section43389233"></a><a name="section43389233"></a><h4 class="sectiontitle">Function</h4><p class="msonormal" id="vpcep_06_0303__p370095">This API is used to create a VPC endpoint for accessing a VPC endpoint service.</p>
<div class="note" id="vpcep_06_0303__note91020528135"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="vpcep_06_0303__p1287461961410">This API is asynchronous. If it is successfully invoked, status code <strong id="vpcep_06_0303__b20084181210555">200</strong> is returned, indicating that the request has been successfully delivered. It takes 1 to 2 minutes to create a VPC endpoint. You can view the creation result by performing operations in <a href="vpcep_06_0202.html">Querying Details About a VPC Endpoint Service</a>.</p>
</div></div>
</div>
<div class="section" id="vpcep_06_0303__section54958778"><h4 class="sectiontitle">URI</h4><p class="litext" id="vpcep_06_0303__p29977709">POST /v1/{project_id}/vpc-endpoints</p>
<div class="msonormal" id="vpcep_06_0303__p624413203159"><a href="#vpcep_06_0303__table40572397">Table 1</a> describes the parameter in this URI.
<div class="tablenoborder"><a name="vpcep_06_0303__table40572397"></a><a name="table40572397"></a><table cellpadding="4" cellspacing="0" summary="" id="vpcep_06_0303__table40572397" frame="border" border="1" rules="all"><caption><b>Table 1 </b>URI parameter</caption><thead align="left"><tr id="vpcep_06_0303__row57566450"><th align="left" class="cellrowborder" valign="top" width="32.65%" id="mcps1.3.2.3.2.2.4.1.1"><p id="vpcep_06_0303__p32370843"><strong id="vpcep_06_0303__b193009351313">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="26.529999999999998%" id="mcps1.3.2.3.2.2.4.1.2"><p id="vpcep_06_0303__p4792588"><strong id="vpcep_06_0303__b205942361039">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40.82%" id="mcps1.3.2.3.2.2.4.1.3"><p id="vpcep_06_0303__p52655342"><strong id="vpcep_06_0303__b196929379312">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpcep_06_0303__row37224296"><td class="cellrowborder" valign="top" width="32.65%" headers="mcps1.3.2.3.2.2.4.1.1 "><p id="vpcep_06_0303__p62378019">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="26.529999999999998%" headers="mcps1.3.2.3.2.2.4.1.2 "><p id="vpcep_06_0303__p19454791">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="40.82%" headers="mcps1.3.2.3.2.2.4.1.3 "><p id="vpcep_06_0303__p32334202">Specifies the project ID. For details about how to obtain the project ID, see <a href="vpcep_08_0003.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="vpcep_06_0303__section24866956"><a name="vpcep_06_0303__section24866956"></a><a name="section24866956"></a><h4 class="sectiontitle">Request</h4><ul id="vpcep_06_0303__ul423524472212"><li class="msonormal" id="vpcep_06_0303__li13235164417221">Parameter description
<div class="tablenoborder"><a name="vpcep_06_0303__table29607260"></a><a name="table29607260"></a><table cellpadding="4" cellspacing="0" summary="" id="vpcep_06_0303__table29607260" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="vpcep_06_0303__row33522038"><th align="left" class="cellrowborder" valign="top" width="20.407959204079592%" id="mcps1.3.3.2.1.1.2.5.1.1"><p id="vpcep_06_0303__p30930573"><strong id="vpcep_06_0303__b590964517320">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="18.36816318368163%" id="mcps1.3.3.2.1.1.2.5.1.2"><p id="vpcep_06_0303__p22348513"><strong id="vpcep_06_0303__b1721893441">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.328367163283673%" id="mcps1.3.3.2.1.1.2.5.1.3"><p id="vpcep_06_0303__p65399129"><strong id="vpcep_06_0303__b159017488317">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="44.89551044895511%" id="mcps1.3.3.2.1.1.2.5.1.4"><p id="vpcep_06_0303__p62838110"><strong id="vpcep_06_0303__b938132860">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpcep_06_0303__row56722135"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p31090221">subnet_id</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p35279943">No</p>
<div class="note" id="vpcep_06_0303__note26594588243"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__p466016583249">This parameter is mandatory to create an interface VPC endpoint.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p39103117">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p244375111217">Specifies the ID of the subnet in the VPC specified by <strong id="vpcep_06_0303__b270612315231">vpc_id</strong>. The ID is in UUID format</p>
<p id="vpcep_06_0303__p418516465816">For details, see response field <strong id="vpcep_06_0303__b16931153814488">id</strong> in <a href="https://docs.otc.t-systems.com/api/vpc/vpc_subnet01_0002.html" target="_blank" rel="noopener noreferrer">Querying Subnet Details</a> in the <em id="vpcep_06_0303__i1593243818487">Virtual Private Cloud API Reference</em>.</p>
<div class="note" id="vpcep_06_0303__note1510244415810"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="vpcep_06_0303__ul114411483253"><li id="vpcep_06_0303__li5262692516">This parameter is mandatory only when you create a VPC endpoint for connecting to an interface VPC endpoint service.</li><li id="vpcep_06_0303__li665614591249">The CIDR block of the VPC subnet cannot overlap with 198.19.128.0/17.</li><li id="vpcep_06_0303__li434713550244">The destination address of the custom route in the VPC route table cannot overlap with 198.19.128.0/17.</li></ul>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row52014641"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p52436422">endpoint_service_id</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p19491812">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p35332914">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p43393752">Specifies the ID of the VPC endpoint service.</p>
<p id="vpcep_06_0303__p3352101421816">You can obtain the ID of the VPC endpoint service to be connected by performing operations in <a href="vpcep_06_0302.html">Querying Basic Information About a VPC Endpoint Service</a>.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row54999452"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p25770618">vpc_id</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p7045317">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p33799780">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p53427648">Specifies the ID of the VPC where the VPC endpoint is to be created.</p>
<p id="vpcep_06_0303__p59954614198">For details, see response field <strong id="vpcep_06_0303__vpcep_06_0201_b9758154713317">id</strong> in <a href="https://docs.otc.t-systems.com/api/vpc/vpc_api01_0002.html" target="_blank" rel="noopener noreferrer">Querying VPC Details</a> in <em id="vpcep_06_0303__vpcep_06_0201_i12759144715337">Virtual Private Cloud API Reference</em>.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row11346893"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p182860438018">enable_dns</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p132868431013">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p728634315016">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p1255315192149">Specifies whether to create a private domain name.</p>
<ul id="vpcep_06_0303__ul7640194412147"><li id="vpcep_06_0303__li4640194421415"><strong id="vpcep_06_0303__b153619534467">true</strong>: A private domain name is created.</li><li id="vpcep_06_0303__li464014411145"><strong id="vpcep_06_0303__b4624258174617">false</strong>: A private domain name is not created.</li></ul>
<p id="vpcep_06_0303__p59011829135010">The default value is <strong id="vpcep_06_0303__b789259195017">false</strong>.</p>
<div class="note" id="vpcep_06_0303__note13996125195911"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__p119994525918">When a VPC endpoint for connecting to a gateway VPC endpoint service is created, no private domain name is created no matter <strong id="vpcep_06_0303__b960193116271">enable_dns</strong> is set to <strong id="vpcep_06_0303__b1156335172819">true</strong> or <strong id="vpcep_06_0303__b844393752815">false</strong>.</p>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row46314724514"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p20921314144517">tags</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p3931314204513">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p89314144458">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p18931714134517">Lists the resource tags. For details, see <a href="#vpcep_06_0303__table15695152144819">Table 3</a>.</p>
<p id="vpcep_06_0303__p1713015423394">A maximum of 20 tags can be added to each VPC endpoint.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row1487961904518"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p6869132344515">routetables</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p1386917232451">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p168691923164510">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p572035194813">Lists the IDs of route tables.</p>
<p id="vpcep_06_0303__p147211254482">If you do not specify this parameter, the route table ID of the VPC is returned.</p>
<div class="note" id="vpcep_06_0303__note122162517405"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__vpcep_06_0303_p81061157249">This parameter is available only when you create a VPC endpoint for connecting to a gateway VPC endpoint service.</p>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row1429802964411"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p159701149124410">port_ip</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p11970104919445">No</p>
<div class="note" id="vpcep_06_0303__note46630466212"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__vpcep_06_0303_p197191540171910">This parameter is mandatory only when you create a VPC endpoint for connecting to an interface VPC endpoint service.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p3970249144419">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p1197012493446">Specifies the IP address for accessing the associated VPC endpoint service.</p>
<p id="vpcep_06_0303__p1397074954416">You can specify IP addresses for accessing the associated VPC endpoint service when creating a VPC endpoint. Only IPv4 addresses are supported.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row4298229184418"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p1697064913441">whitelist</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p20970114919441">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p8970349104420">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p179701249104416">Specifies the whitelist for controlling access to the VPC endpoint.</p>
<p id="vpcep_06_0303__p697184913445">IPv4 addresses or CIDR blocks can be specified to control access when you create a VPC endpoint.</p>
<div class="note" id="vpcep_06_0303__note281416302243"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__p19814123011243">This parameter is available only when you create a VPC endpoint for connecting to an interface VPC endpoint service.</p>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row42991929124416"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p1197117499448">enable_whitelist</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p697164919446">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p2971849104416">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p327565713297">Specifies whether access control is enabled.</p>
<ul id="vpcep_06_0303__ul1234074961212"><li id="vpcep_06_0303__li1434074961216"><strong id="vpcep_06_0303__b11313153317138">true</strong>: Access control is enabled.</li><li id="vpcep_06_0303__li133401449101218"><strong id="vpcep_06_0303__b117560203339">false</strong>: Access control is disabled.</li></ul>
<p id="vpcep_06_0303__p564510511310">The default value is <strong id="vpcep_06_0303__b117672225336">false</strong>.</p>
<div class="note" id="vpcep_06_0303__note85431946172215"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__vpcep_06_0303_p197191540171910_1">This parameter is available only when you create a VPC endpoint for connecting to an interface VPC endpoint service.</p>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row11131351475"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p55829438714">specification_name</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p1458214434719">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p10582443778">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p1158216437710">Specifies the name of the VPC endpoint specifications.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row14113135777"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p577894173716">policy_statement</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p177864123711">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p207781641379">Array of <a href="#vpcep_06_0303__en-us_topic_0000001735824744_request_PolicyStatement">PolicyStatement</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p1386541165018">Specifies the policy of the gateway VPC endpoint.</p>
<p id="vpcep_06_0303__p2032620249558">This parameter is available only when you create a gateway VPC endpoint.</p>
<p id="vpcep_06_0303__p07798453712">Array length: <strong id="vpcep_06_0303__b1146091516314">010</strong></p>
<p id="vpcep_06_0303__p358294311713">Default value:</p>
<pre class="screen" id="vpcep_06_0303__screen152912211586">{
"Action": [
"obs:*:*"
],
"Resource": [
"obs:*:*:*:*/*",
"obs:*:*:*:*"
],
"Effect": "Allow"
}</pre>
</td>
</tr>
<tr id="vpcep_06_0303__row1253063352011"><td class="cellrowborder" valign="top" width="20.407959204079592%" headers="mcps1.3.3.2.1.1.2.5.1.1 "><p id="vpcep_06_0303__p1853163320202">description</p>
</td>
<td class="cellrowborder" valign="top" width="18.36816318368163%" headers="mcps1.3.3.2.1.1.2.5.1.2 "><p id="vpcep_06_0303__p15531163322013">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.328367163283673%" headers="mcps1.3.3.2.1.1.2.5.1.3 "><p id="vpcep_06_0303__p19531153319202">String</p>
</td>
<td class="cellrowborder" valign="top" width="44.89551044895511%" headers="mcps1.3.3.2.1.1.2.5.1.4 "><p id="vpcep_06_0303__p953193312205">Specifies the description of the VPC endpoint. The description can contain a maximum of 128 characters and cannot contain left angle brackets (&lt;) or right angle brackets (&gt;).</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="vpcep_06_0303__table15695152144819"></a><a name="table15695152144819"></a><table cellpadding="4" cellspacing="0" summary="" id="vpcep_06_0303__table15695152144819" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Tags parameters</caption><thead align="left"><tr id="vpcep_06_0303__vpcep_06_0201_en-us_topic_0056765542_row4410728"><th align="left" class="cellrowborder" valign="top" width="15.601560156015601%" id="mcps1.3.3.2.1.2.2.5.1.1"><p id="vpcep_06_0303__vpcep_06_0201_en-us_topic_0056765542_p21724664"><strong id="vpcep_06_0303__vpcep_06_0201_b1563612711">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.061506150615061%" id="mcps1.3.3.2.1.2.2.5.1.2"><p id="vpcep_06_0303__vpcep_06_0201_p10931647101614"><strong id="vpcep_06_0303__vpcep_06_0201_b1910063761">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.121712171217123%" id="mcps1.3.3.2.1.2.2.5.1.3"><p id="vpcep_06_0303__vpcep_06_0201_en-us_topic_0056765542_p63406242"><strong id="vpcep_06_0303__vpcep_06_0201_b1564672112114">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="52.21522152215221%" id="mcps1.3.3.2.1.2.2.5.1.4"><p id="vpcep_06_0303__vpcep_06_0201_en-us_topic_0056765542_p35632012"><strong id="vpcep_06_0303__vpcep_06_0201_b12940209153810">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpcep_06_0303__vpcep_06_0201_en-us_topic_0056765542_row511887"><td class="cellrowborder" valign="top" width="15.601560156015601%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="vpcep_06_0303__vpcep_06_0201_en-us_topic_0056765542_p41462866">key</p>
</td>
<td class="cellrowborder" valign="top" width="15.061506150615061%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="vpcep_06_0303__vpcep_06_0201_p12931547141613">No</p>
</td>
<td class="cellrowborder" valign="top" width="17.121712171217123%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="vpcep_06_0303__vpcep_06_0201_en-us_topic_0056765542_p45638969">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.21522152215221%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="vpcep_06_0303__vpcep_06_0201_p48921437201850">Specifies the tag key. A tag key contains a maximum of 36 Unicode characters. <strong id="vpcep_06_0303__vpcep_06_0201_b98331357143611">key</strong> cannot be left blank. It can contain only digits, letters, hyphens (-), underscores (_), and at signs (@).</p>
</td>
</tr>
<tr id="vpcep_06_0303__vpcep_06_0201_en-us_topic_0056765542_row51921052"><td class="cellrowborder" valign="top" width="15.601560156015601%" headers="mcps1.3.3.2.1.2.2.5.1.1 "><p id="vpcep_06_0303__vpcep_06_0201_en-us_topic_0056765542_p44855704">value</p>
</td>
<td class="cellrowborder" valign="top" width="15.061506150615061%" headers="mcps1.3.3.2.1.2.2.5.1.2 "><p id="vpcep_06_0303__vpcep_06_0201_p2093118475163">No</p>
</td>
<td class="cellrowborder" valign="top" width="17.121712171217123%" headers="mcps1.3.3.2.1.2.2.5.1.3 "><p id="vpcep_06_0303__vpcep_06_0201_en-us_topic_0056765542_p25911262">String</p>
</td>
<td class="cellrowborder" valign="top" width="52.21522152215221%" headers="mcps1.3.3.2.1.2.2.5.1.4 "><p id="vpcep_06_0303__vpcep_06_0201_p61714725112922">Specifies the tag value. A tag value contains a maximum of 43 Unicode characters and can be left blank. It can contain only digits, letters, hyphens (-), underscores (_), and at signs (@).</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="vpcep_06_0303__en-us_topic_0000001735824744_request_PolicyStatement"></a><a name="en-us_topic_0000001735824744_request_PolicyStatement"></a><table cellpadding="4" cellspacing="0" summary="" id="vpcep_06_0303__en-us_topic_0000001735824744_request_PolicyStatement" frame="border" border="1" rules="all"><caption><b>Table 4 </b>PolicyStatement</caption><thead align="left"><tr id="vpcep_06_0303__row167911443719"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.1.3.2.5.1.1"><p id="vpcep_06_0303__p879215413371"><strong id="vpcep_06_0303__b1386937477">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.1.3.2.5.1.2"><p id="vpcep_06_0303__p77931542371"><strong id="vpcep_06_0303__b158938062">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.1.3.2.5.1.3"><p id="vpcep_06_0303__p37931244378"><strong id="vpcep_06_0303__b1487012087">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.1.3.2.5.1.4"><p id="vpcep_06_0303__p207938483716"><strong id="vpcep_06_0303__b469552540">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpcep_06_0303__row27918419376"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.3.2.5.1.1 "><p id="vpcep_06_0303__p779412433717">Effect</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.3.2.5.1.2 "><p id="vpcep_06_0303__p147947410370">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.3.2.5.1.3 "><p id="vpcep_06_0303__p1379411413375">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.1.3.2.5.1.4 "><p id="vpcep_06_0303__p1879564143710">Specifies the policy effect, which can be <strong id="vpcep_06_0303__b192501820152714">Allow</strong> or <strong id="vpcep_06_0303__b155334362276">Deny</strong>.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row17911942376"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.3.2.5.1.1 "><p id="vpcep_06_0303__p17795144183711">Action</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.3.2.5.1.2 "><p id="vpcep_06_0303__p1796040376">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.3.2.5.1.3 "><p id="vpcep_06_0303__p1379613414374">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.1.3.2.5.1.4 "><p id="vpcep_06_0303__p1979616419373">Specifies OBS access permissions.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row27918483719"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.3.2.5.1.1 "><p id="vpcep_06_0303__p17971415373">Resource</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.3.2.5.1.2 "><p id="vpcep_06_0303__p379713433719">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.1.3.2.5.1.3 "><p id="vpcep_06_0303__p1979716493713">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.1.3.2.5.1.4 "><p id="vpcep_06_0303__p17982047377">Specifies the OBS object.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="vpcep_06_0303__li66252755">Example request<pre class="codeblock" id="vpcep_06_0303__codeblock8654414195220">POST https://{endpoint}/v1/{project_id}/vpc-endpoints</pre>
<p id="vpcep_06_0303__p23281810205213">Creating an interface VPC endpoint</p>
<pre class="screen" id="vpcep_06_0303__screen58092121513">{
"subnet_id": "61881173-3899-4981-a700-170253d469b6",
"endpoint_service_id": "2da0fe8f-5cb7-4d93-bb35-dc05334da1be",
"vpc_id": "d7b2bf07-1b4c-43fa-bd88-d80c6ebea140",
"tags": [
{
"key": "test2",
"value": "test2"
}
]
}</pre>
<p id="vpcep_06_0303__p99591738105720">Creating a gateway VPC endpoint</p>
<pre class="screen" id="vpcep_06_0303__screen1280431317403">{
"endpoint_service_id": "e4a21a61-f09e-41bc-b487-23d6204ae27b",
"vpc_id": "d7b2bf07-1b4c-43fa-bd88-d80c6ebea140",
"enable_dns": true,
"tags": [
{
"key": "test1",
"value": "test1"
}
],
"routetables": [
"cd7fdf2b-d964-4a4a-a169-2af1112e7d02"
]
}</pre>
</li></ul>
</div>
<div class="section" id="vpcep_06_0303__section22476016"><a name="vpcep_06_0303__section22476016"></a><a name="section22476016"></a><h4 class="sectiontitle">Response</h4><ul id="vpcep_06_0303__ul831920182233"><li class="msonormal" id="vpcep_06_0303__li1031919182239">Parameter description
<div class="tablenoborder"><a name="vpcep_06_0303__table65138754"></a><a name="table65138754"></a><table cellpadding="4" cellspacing="0" summary="" id="vpcep_06_0303__table65138754" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response parameters</caption><thead align="left"><tr id="vpcep_06_0303__row19593361"><th align="left" class="cellrowborder" valign="top" width="24.242424242424242%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="vpcep_06_0303__p43558418"><strong id="vpcep_06_0303__b937371560">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="29.292929292929294%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="vpcep_06_0303__p38570971"><strong id="vpcep_06_0303__b1076581079">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="46.464646464646464%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="vpcep_06_0303__p37240981"><strong id="vpcep_06_0303__b904630196">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpcep_06_0303__row63729512"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p61816827">id</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p41107062">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p41337730">Specifies the unique ID of the VPC endpoint.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row36495254"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p3325565">service_type</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p935369">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p20173443232">Specifies the type of the VPC endpoint service that is associated with the VPC endpoint.</p>
<ul id="vpcep_06_0303__ul649612552553"><li id="vpcep_06_0303__vpcep_06_0201_li10401049390">Gateway: VPC endpoint services of this type are configured by O&amp;M personnel. You can use them directly without the need to create one by yourselves.</li><li id="vpcep_06_0303__vpcep_06_0201_li1664631084019">Interface: VPC endpoint services of this type include cloud services configured by O&amp;M personnel and private services created by yourselves. You cannot configure these cloud services, but can use them.</li></ul>
<p id="vpcep_06_0303__p1318010403317">You can view those VPC endpoint services that are configured by operations people and are visible and accessible to all users. For detailed steps, see <a href="vpcep_06_0301.html">Querying Public VPC Endpoint Services</a>. Perform the operations in <a href="vpcep_06_0201.html">Creating a VPC Endpoint Service</a> to create an interface VPC endpoint service.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row10796023"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p2062637">status</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p32855908">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p583352918492">Specifies the connection status of the VPC endpoint.</p>
<ul id="vpcep_06_0303__ul1594515565918"><li id="vpcep_06_0303__li294525614916"><strong id="vpcep_06_0303__b173006129442">pendingAcceptance</strong>: The VPC endpoint is to be accepted.</li><li id="vpcep_06_0303__li99451566916"><strong id="vpcep_06_0303__b11729191041010">creating</strong>: The VPC endpoint is being created.</li><li id="vpcep_06_0303__li13390192512367"><strong id="vpcep_06_0303__b61642024104813">accepted</strong>: The VPC endpoint has been accepted.</li><li id="vpcep_06_0303__li185604413369"><strong id="vpcep_06_0303__b13731127124814">rejected</strong>: The VPC endpoint has been rejected.</li><li id="vpcep_06_0303__li8863182917368"><strong id="vpcep_06_0303__b10432132812486">failed</strong>: The VPC endpoint failed to be created.</li></ul>
</td>
</tr>
<tr id="vpcep_06_0303__row16105144313515"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p11324544145112">active_status</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p1832415441514">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p14324144165119">Specifies the <span id="vpcep_06_0303__text1337812195564">account</span><span id="vpcep_06_0303__text15194211569"></span> status.</p>
<ul id="vpcep_06_0303__ul15778105411011"><li id="vpcep_06_0303__li1177955461020"><strong id="vpcep_06_0303__b032665710314">arrear_frozen</strong>: frozen due to arrears</li><li id="vpcep_06_0303__li87791554101013"><strong id="vpcep_06_0303__b20281177327">verify_frozen</strong>: frozen due to lack of real-name authentication</li><li id="vpcep_06_0303__li157790547103"><strong id="vpcep_06_0303__b11229119173320">police_frozen</strong>: frozen for legal management</li><li id="vpcep_06_0303__li19779454101011"><strong id="vpcep_06_0303__b565616370335">illegal_frozen</strong>: frozen due to abuse</li><li id="vpcep_06_0303__li845017031115"><strong id="vpcep_06_0303__b14620193163420">partner_frozen</strong>: frozen for partnership</li><li id="vpcep_06_0303__li15779185412103"><strong id="vpcep_06_0303__b139731323420">active</strong>: The <span id="vpcep_06_0303__text124524485346">account</span><span id="vpcep_06_0303__text1545364811349"></span> is normal.</li></ul>
</td>
</tr>
<tr id="vpcep_06_0303__row55705628"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p15861989">endpoint_service_name</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p9752694">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p51770744">Specifies the name of the VPC endpoint service.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row63283514"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p25691048">marker_id</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p600154">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p48612537">Specifies the packet ID of the VPC endpoint.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row34859652"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p5059601">endpoint_service_id</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p7174526">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p44265715">Specifies the ID of the VPC endpoint service.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row62847121"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p57452006">enable_dns</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p23100887">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p72792580273">Specifies whether to create a private domain name.</p>
<ul id="vpcep_06_0303__ul145169269292"><li id="vpcep_06_0303__li95161626192917"><strong id="vpcep_06_0303__b5329712144718">true</strong>: A private domain name is created.</li><li id="vpcep_06_0303__li45171626102919"><strong id="vpcep_06_0303__b205965143471">false</strong>: A private domain name is not created.</li></ul>
<div class="note" id="vpcep_06_0303__note1021533535814"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__vpcep_06_0303_p119994525918">When a VPC endpoint for connecting to a gateway VPC endpoint service is created, no private domain name is created no matter <strong id="vpcep_06_0303__vpcep_06_0303_b960193116271">enable_dns</strong> is set to <strong id="vpcep_06_0303__vpcep_06_0303_b1156335172819">true</strong> or <strong id="vpcep_06_0303__vpcep_06_0303_b844393752815">false</strong>.</p>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row63331262"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p8679183214469">dns_names</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p467910327469">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p116791149101913">Specifies the domain name for accessing the associated VPC endpoint service.</p>
<div class="note" id="vpcep_06_0303__note12165173942919"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="vpcep_06_0303__ul197841631710"><li id="vpcep_06_0303__li67851638719">This parameter is available only when you create a VPC endpoint for connecting to an interface VPC endpoint service and <strong id="vpcep_06_0303__b156111926154710">enable_dns</strong> is set to <strong id="vpcep_06_0303__b56111126184717">true</strong>.</li><li id="vpcep_06_0303__li578516311718">The API for creating a VPC endpoint is asynchronous. If it is successfully invoked, status code <strong id="vpcep_06_0303__b8918374551">200</strong> is returned, indicating that the request has been successfully delivered. It takes 1 to 2 minutes to create a VPC endpoint. You can view the creation result by performing operations in <a href="vpcep_06_0202.html">Querying Details About a VPC Endpoint Service</a>.</li></ul>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row63900256"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p8538219">subnet_id</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p20507143">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p50465883">Specifies the ID of the subnet in the VPC specified by <strong id="vpcep_06_0303__b1757761010202">vpc_id</strong>. The ID is in UUID format.</p>
<div class="note" id="vpcep_06_0303__note1977123123310"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__p48629317123">This parameter is available only when you create a VPC endpoint for connecting to an interface VPC endpoint service.</p>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row55267714"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p751213210">vpc_id</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p205121639116">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p122415282419">Specifies the ID of the VPC where the VPC endpoint is to be created.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row3635902"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p26072634">created_at</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p31508570">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p22890001">Specifies the creation time of the VPC endpoint.</p>
<p id="vpcep_06_0303__p871616113394">The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row18516157"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p23413735">updated_at</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p17464402">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p27321481">Specifies the update time of the VPC endpoint.</p>
<p id="vpcep_06_0303__p181016810016">The UTC time format is used: YYYY-MM-DDTHH:MM:SSZ.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row47974230"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p60707417">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p18353753">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p10259005">Specifies the project ID. For details about how to obtain the project ID, see <a href="vpcep_08_0003.html">Obtaining a Project ID</a>.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row204491010122314"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p13103244015">tags</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p21037441512">Array of objects</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p1510414411116">Lists the resource tags. For details, see <a href="#vpcep_06_0303__table489217571060">Table 6</a>.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row4213193174716"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p165011381477">whitelist</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p450173820473">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p2538528143320">Specifies the whitelist for controlling access to the VPC endpoint.</p>
<p id="vpcep_06_0303__p386713773414">If you do not specify this parameter, an empty whitelist is returned.</p>
<div class="note" id="vpcep_06_0303__note0675183412207"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__vpcep_06_0303_p197191540171910_2">This parameter is available only when you create a VPC endpoint for connecting to an interface VPC endpoint service.</p>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row192131031144718"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p050938124710">enable_whitelist</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p85019382479">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p1458051113412">Specifies whether access control is enabled.</p>
<ul id="vpcep_06_0303__ul1998774161110"><li id="vpcep_06_0303__li1998719418116"><strong id="vpcep_06_0303__b124517882">true</strong>: Access control is enabled.</li><li id="vpcep_06_0303__li3987104110119"><strong id="vpcep_06_0303__b12134145911314">false</strong>: Access control is disabled.</li></ul>
<p id="vpcep_06_0303__p16973392358">If you do not specify this parameter, the whitelist is not enabled.</p>
<div class="note" id="vpcep_06_0303__note281717357193"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__p197191540171910">This parameter is available only when you create a VPC endpoint for connecting to an interface VPC endpoint service.</p>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row42141317475"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p9502038174719">routetables</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p650203810476">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p422280153614">Lists the IDs of route tables.</p>
<p id="vpcep_06_0303__p17737722113611">If you do not specify this parameter, the route table ID of the VPC is returned.</p>
<div class="note" id="vpcep_06_0303__note3831230133918"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpcep_06_0303__p81061157249">This parameter is available only when you create a VPC endpoint for connecting to a gateway VPC endpoint service.</p>
</div></div>
</td>
</tr>
<tr id="vpcep_06_0303__row1327317468522"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p52731546125215">specification_name</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p027354685220">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p927410461524">Specifies the name of the VPC endpoint specifications.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row1827419461523"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p12741546125216">enable_status</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p86691815583">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p6274174685214">Specifies whether to enable the endpoint.</p>
<ul id="vpcep_06_0303__ul2871132125712"><li id="vpcep_06_0303__li187143210573"><strong id="vpcep_06_0303__b31339401254">enable</strong>: The endpoint will be enabled.</li><li id="vpcep_06_0303__li18871832205714"><strong id="vpcep_06_0303__b1677513411253">disable</strong>: The endpoint will be disabled.</li></ul>
</td>
</tr>
<tr id="vpcep_06_0303__row19609427111619"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p1480392921610">policy_statement</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p4403171719">Array of <a href="#vpcep_06_0303__table132038432718">PolicyStatement</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p2401171379">Specifies the policy of the gateway VPC endpoint.</p>
<p id="vpcep_06_0303__p164081716720">This parameter is available only when you create a gateway VPC endpoint.</p>
<p id="vpcep_06_0303__p740131714716">Default value:</p>
<pre class="screen" id="vpcep_06_0303__screen14402171076">{
"Action": [
"obs:*:*"
],
"Resource": [
"obs:*:*:*:*/*",
"obs:*:*:*:*"
],
"Effect": "Allow"
}</pre>
</td>
</tr>
<tr id="vpcep_06_0303__row109265192422"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p186639235611">endpoint_pool_id</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p9758339428">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p1375873919211">(To be discarded) Specifies the ID of the cluster associated with the VPC endpoint.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row17610192791611"><td class="cellrowborder" valign="top" width="24.242424242424242%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpcep_06_0303__p58031829121617">description</p>
</td>
<td class="cellrowborder" valign="top" width="29.292929292929294%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpcep_06_0303__p2080315299162">String</p>
</td>
<td class="cellrowborder" valign="top" width="46.464646464646464%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpcep_06_0303__p58031729161612">Specifies the description of the VPC endpoint.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="vpcep_06_0303__table489217571060"></a><a name="table489217571060"></a><table cellpadding="4" cellspacing="0" summary="" id="vpcep_06_0303__table489217571060" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Tags parameters</caption><thead align="left"><tr id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_en-us_topic_0056765542_row4410728"><th align="left" class="cellrowborder" valign="top" width="18.09%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_en-us_topic_0056765542_p21724664"><strong id="vpcep_06_0303__vpcep_06_0201_b1866348132314">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_en-us_topic_0056765542_p63406242"><strong id="vpcep_06_0303__vpcep_06_0201_b616714104231">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="61.91%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_en-us_topic_0056765542_p35632012"><strong id="vpcep_06_0303__vpcep_06_0201_b163691023811">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_en-us_topic_0056765542_row511887"><td class="cellrowborder" valign="top" width="18.09%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_en-us_topic_0056765542_p41462866">key</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_en-us_topic_0056765542_p45638969">String</p>
</td>
<td class="cellrowborder" valign="top" width="61.91%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_p48921437201850">Specifies the tag key. A tag key contains a maximum of 36 Unicode characters. <strong id="vpcep_06_0303__vpcep_06_0201_b1957518572342">key</strong> cannot be left blank. It can contain only digits, letters, hyphens (-), underscores (_), and at signs (@).</p>
</td>
</tr>
<tr id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_en-us_topic_0056765542_row51921052"><td class="cellrowborder" valign="top" width="18.09%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_en-us_topic_0056765542_p44855704">value</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_en-us_topic_0056765542_p25911262">String</p>
</td>
<td class="cellrowborder" valign="top" width="61.91%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpcep_06_0303__vpcep_06_0201_vpcep_06_0201_p61714725112922">Specifies the tag value. A tag value contains a maximum of 43 Unicode characters and can be left blank. It can contain only digits, letters, hyphens (-), underscores (_), and at signs (@).</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="vpcep_06_0303__table132038432718"></a><a name="table132038432718"></a><table cellpadding="4" cellspacing="0" summary="" id="vpcep_06_0303__table132038432718" frame="border" border="1" rules="all"><caption><b>Table 7 </b>PolicyStatement</caption><thead align="left"><tr id="vpcep_06_0303__row162045431176"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.3.2.5.1.1"><p id="vpcep_06_0303__p22044434713"><strong id="vpcep_06_0303__b93396493">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.3.2.5.1.2"><p id="vpcep_06_0303__p1320454313714"><strong id="vpcep_06_0303__b1882624980">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.4.2.1.3.2.5.1.3"><p id="vpcep_06_0303__p122041543279"><strong id="vpcep_06_0303__b1602126492">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.4.2.1.3.2.5.1.4"><p id="vpcep_06_0303__p22047438720"><strong id="vpcep_06_0303__b409410473">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpcep_06_0303__row1920415431712"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.5.1.1 "><p id="vpcep_06_0303__p1820484312720">Effect</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.5.1.2 "><p id="vpcep_06_0303__p92049431979">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.5.1.3 "><p id="vpcep_06_0303__p32041043972">String</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.1.3.2.5.1.4 "><p id="vpcep_06_0303__p16204184315712">Specifies the policy effect, which can be <strong id="vpcep_06_0303__b177731642133910">Allow</strong> or <strong id="vpcep_06_0303__b1677354253910">Deny</strong>.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row17204443872"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.5.1.1 "><p id="vpcep_06_0303__p172041436710">Action</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.5.1.2 "><p id="vpcep_06_0303__p142058438710">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.5.1.3 "><p id="vpcep_06_0303__p182055431071">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.1.3.2.5.1.4 "><p id="vpcep_06_0303__p1920520432710">Specifies OBS access permissions.</p>
</td>
</tr>
<tr id="vpcep_06_0303__row820554319715"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.5.1.1 "><p id="vpcep_06_0303__p62058431715">Resource</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.5.1.2 "><p id="vpcep_06_0303__p320514431716">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.4.2.1.3.2.5.1.3 "><p id="vpcep_06_0303__p1320515430715">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.4.2.1.3.2.5.1.4 "><p id="vpcep_06_0303__p9205543270">Specifies the OBS object.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<ul id="vpcep_06_0303__ul29731038"><li id="vpcep_06_0303__li20214875"><a name="vpcep_06_0303__li20214875"></a><a name="li20214875"></a>Example response<p id="vpcep_06_0303__p074715453582"><a name="vpcep_06_0303__li20214875"></a><a name="li20214875"></a>An interface VPC endpoint has been created.</p>
<pre class="screen" id="vpcep_06_0303__screen1158781410617">{
"id": "530d6f2f-d115-4df2-8c36-32d19f3c0bbc",
"status": "creating",
"tags": [
{
"key": "test2",
"value": "test2"
}
],
"whitelist": [],
"marker_id": 201515772,
"active_status": [
"active"
],
"vpc_id": "d7b2bf07-1b4c-43fa-bd88-d80c6ebea140",
"service_type": "interface",
"project_id": "0df25bbc*****62f88c00c2959df9a",
"subnet_id": "61881173-3899-4981-a700-170253d469b6",
"enable_dns": false,
"created_at": "2024-08-23T07:37:37Z",
"updated_at": "2024-08-23T07:37:37Z",
"endpoint_service_id": "2da0fe8f-5cb7-4d93-bb35-dc05334da1be",
"endpoint_service_name": "test123",
"enable_whitelist": false,
"specification_name": "default",
"enable_status": "enable",
"description": "",
"endpoint_pool_id": "0e796c11-6cf1-484a-9b8c-f837cb925287"
}</pre>
<p id="vpcep_06_0303__p16748745115816">A gateway VPC endpoint has been created.</p>
<pre class="screen" id="vpcep_06_0303__screen2032082213507">{
"id": "093998ea-ebaa-440d-8c75-935178e4dd93",
"status": "creating",
"tags": [
{
"key": "test1",
"value": "test1"
}
],
"marker_id": 201414431,
"active_status": [
"active"
],
"vpc_id": "d7b2bf07-1b4c-43fa-bd88-d80c6ebea140",
"service_type": "gateway",
"project_id": "0df25bbc87****8c00c2959df9a",
"routetables": [
"cd7fdf2b-d964-4a4a-a169-2af1112e7d02"
],
"created_at": "2024-08-23T07:23:22Z",
"updated_at": "2024-08-23T07:23:22Z",
"endpoint_service_id": "e4a21a61-f09e-41bc-b487-23d6204ae27b"
"endpoint_service_name": "test123",
"policy_statement": [
{
"Action": [
"obs:*:*"
],
"Resource": [
"obs:*:*:*:*/*",
"obs:*:*:*:*"
],
"Effect": "Allow"
}
],
"specification_name": "default",
"enable_status": "enable",
"description": "",
"endpoint_pool_id": "d86778c4-ad4b-4abd-988e-8c2572047fe4"
}</pre>
</li></ul>
<div class="section" id="vpcep_06_0303__section8618044"><h4 class="sectiontitle">Status Codes</h4><p class="msonormal" id="vpcep_06_0303__p2791867">See <a href="vpcep_08_0001.html">Status Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="vpcep_06_0300.html">APIs for Managing VPC Endpoints</a></div>
</div>
</div>