Files
doc-exports/docs/vpc/api-ref/vpc_subnet01_0002.html
fanqinying 05458809ab VPC API 20250121 version
Reviewed-by: Szirovicza Gergő <a94652429@noreply.gitea.eco.tsi-dev.otc-service.com>
Reviewed-by: Sarda, Priya <prsarda@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-authored-by: fanqinying <fanqinying@huawei.com>
Co-committed-by: fanqinying <fanqinying@huawei.com>
2025-09-11 14:33:55 +00:00

311 lines
26 KiB
HTML

<a name="vpc_subnet01_0002"></a><a name="vpc_subnet01_0002"></a>
<h1 class="topictitle1">Querying Subnet Details</h1>
<div id="body55429698"><div class="section" id="vpc_subnet01_0002__section6925935"><h4 class="sectiontitle">Function</h4><p id="vpc_subnet01_0002__p60620523">This API is used to query details about a subnet.</p>
</div>
<div class="section" id="vpc_subnet01_0002__section62333418"><h4 class="sectiontitle">URI</h4><p id="vpc_subnet01_0002__p16726143754718">GET /v1/{project_id}/subnets/{subnet_id}</p>
<div class="p" id="vpc_subnet01_0002__p15858537173615"><a href="#vpc_subnet01_0002__table61566768">Table 1</a> describes the parameters.
<div class="tablenoborder"><a name="vpc_subnet01_0002__table61566768"></a><a name="table61566768"></a><table cellpadding="4" cellspacing="0" summary="" id="vpc_subnet01_0002__table61566768" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="vpc_subnet01_0002__row44407631"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.2.2.4.1.1"><p id="vpc_subnet01_0002__p40248354">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.2.2.4.1.2"><p id="vpc_subnet01_0002__p38891250">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.2.2.4.1.3"><p id="vpc_subnet01_0002__p63183526">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_subnet01_0002__row17591975"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.1 "><p id="vpc_subnet01_0002__p15663836">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.2 "><p id="vpc_subnet01_0002__p60811181">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.3 "><p id="vpc_subnet01_0002__p10487112">Specifies the project ID. </p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row39501348"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.1 "><p id="vpc_subnet01_0002__p45492604">subnet_id</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.2 "><p id="vpc_subnet01_0002__p61022284">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.3 "><p id="vpc_subnet01_0002__p7468532194319">Specifies the subnet ID, which uniquely identifies the subnet.</p>
<p id="vpc_subnet01_0002__p43857981">If you use the management console, the value of this parameter is the <strong id="vpc_subnet01_0002__b195522519461">Network ID</strong> value.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="vpc_subnet01_0002__section24129853"><h4 class="sectiontitle">Request Parameters</h4><p id="vpc_subnet01_0002__p26561567203841">None</p>
</div>
<div class="section" id="vpc_subnet01_0002__section116721481452"><h4 class="sectiontitle">Example Request</h4><pre class="screen" id="vpc_subnet01_0002__screen45353676143832">GET https://{Endpoint}/v1/{project_id}/subnets/4779ab1c-7c1a-44b1-a02e-93dfc361b32d</pre>
</div>
<div class="section" id="vpc_subnet01_0002__section15842089"><h4 class="sectiontitle">Response Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="vpc_subnet01_0002__table6005374015751" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameter</caption><thead align="left"><tr id="vpc_subnet01_0002__row4874046215751"><th align="left" class="cellrowborder" valign="top" width="18.34%" id="mcps1.3.5.2.2.4.1.1"><p id="vpc_subnet01_0002__p5566332215751">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="24.84%" id="mcps1.3.5.2.2.4.1.2"><p id="vpc_subnet01_0002__p62309715751">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="56.82000000000001%" id="mcps1.3.5.2.2.4.1.3"><p id="vpc_subnet01_0002__p5047090715751">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_subnet01_0002__row6161169015751"><td class="cellrowborder" valign="top" width="18.34%" headers="mcps1.3.5.2.2.4.1.1 "><p id="vpc_subnet01_0002__p2449098915751">subnet</p>
</td>
<td class="cellrowborder" valign="top" width="24.84%" headers="mcps1.3.5.2.2.4.1.2 "><p id="vpc_subnet01_0002__p2676232115751"><a href="#vpc_subnet01_0002__table6614597017585">subnet</a> object</p>
</td>
<td class="cellrowborder" valign="top" width="56.82000000000001%" headers="mcps1.3.5.2.2.4.1.3 "><p id="vpc_subnet01_0002__p4816174615751">Specifies the <a href="#vpc_subnet01_0002__table6614597017585">subnet objects</a>.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="vpc_subnet01_0002__table6614597017585"></a><a name="table6614597017585"></a><table cellpadding="4" cellspacing="0" summary="" id="vpc_subnet01_0002__table6614597017585" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="vpc_subnet01_0002__b8564191915417">subnet</strong> objects</caption><thead align="left"><tr id="vpc_subnet01_0002__row5931021317585"><th align="left" class="cellrowborder" valign="top" width="28.95%" id="mcps1.3.5.3.2.4.1.1"><p id="vpc_subnet01_0002__p3939794017585">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.950000000000003%" id="mcps1.3.5.3.2.4.1.2"><p id="vpc_subnet01_0002__p5365431717585">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.1%" id="mcps1.3.5.3.2.4.1.3"><p id="vpc_subnet01_0002__p5103239017585">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_subnet01_0002__row3998288717585"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p1738840917585">id</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p28481417585">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p2306998617585">Specifies a resource ID in UUID format.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row630328217585"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p4080382917585">name</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p1666748117585">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><ul id="vpc_subnet01_0002__ul23311559134110"><li id="vpc_subnet01_0002__li10331195974115">Specifies the subnet name.</li><li id="vpc_subnet01_0002__li13332135944118">The value can contain 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and periods (.).</li></ul>
</td>
</tr>
<tr id="vpc_subnet01_0002__row098813447294"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p6644346112914">description</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p1964416468296">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><ul id="vpc_subnet01_0002__ul237215542179"><li id="vpc_subnet01_0002__li19372754181713">Provides supplementary information about the subnet.</li><li id="vpc_subnet01_0002__li13372125412173">The value can contain no more than 255 characters and cannot contain angle brackets (&lt; or &gt;).</li></ul>
</td>
</tr>
<tr id="vpc_subnet01_0002__row388956217585"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p4661911217585">cidr</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p5290705517585">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p5761304717585">Specifies the subnet CIDR block.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row4875537617585"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p5687141217585">gateway_ip</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p805358517585">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p4836063417585">Specifies the subnet gateway address.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row6892913192919"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p5555172210292">ipv6_enable</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p4555172262916">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p455512223299">Specifies whether IPv6 is enabled.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row1153062020297"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p4555182242915">cidr_v6</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p05555229293">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p369345672910">Specifies the IPv6 subnet CIDR block. If the subnet is an IPv4 subnet, this parameter is not returned.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row20317161718297"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p13555122213297">gateway_ip_v6</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p7555112210299">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p18693155612296">Specifies the IPv6 subnet gateway. If the subnet is an IPv4 subnet, this parameter is not returned.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row3259252617585"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p2274892917585">dhcp_enable</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p561056817585">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p5180286017585">Specifies whether DHCP is enabled for the subnet.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row6357256317585"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p4910399917585">primary_dns</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p4879619717585">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p6017790317585">Specifies the primary IP address of DNS server on the subnet.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row473021817585"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p4760336917585">secondary_dns</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p105619417585">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p1844285917585">Specifies the standby IP address of DNS server on the subnet.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row5602880311213"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p4203922911213">dnsList</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p195587511213">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p2420815811213">Specifies the IP address list of DNS servers on the subnet.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row3176800317585"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p2307142317585">availability_zone</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p4112332617585">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p4265512017585">Identifies the AZ that the subnet belongs to. The value of this parameter is the AZ specified when the subnet is created and does not limit the usage scope of the subnet.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row4835176717585"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p2417901817585">vpc_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p6029773217585">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p5227810517585">Specifies the ID of the VPC that the subnet belongs to.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row74090317585"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p6001314817585">status</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p1856038817585">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><ul id="vpc_subnet01_0002__ul756817571315"><li id="vpc_subnet01_0002__li13201524194619">Specifies the status of the subnet.</li><li id="vpc_subnet01_0002__li18201524114619">The value can be <strong id="vpc_subnet01_0002__b1524152318567">ACTIVE</strong>, <strong id="vpc_subnet01_0002__b1752432310569">UNKNOWN</strong>, or <strong id="vpc_subnet01_0002__b13524223125620">ERROR</strong>.<ul id="vpc_subnet01_0002__ul83391032184614"><li id="vpc_subnet01_0002__li175681357183117"><strong id="vpc_subnet01_0002__b1876155814493">ACTIVE</strong>: indicates that the subnet has been associated with a VPC.</li><li id="vpc_subnet01_0002__li5568157103111"><strong id="vpc_subnet01_0002__b149656185015">UNKNOWN</strong>: indicates that the subnet has not been associated with a VPC.</li><li id="vpc_subnet01_0002__li85681932326"><strong id="vpc_subnet01_0002__b842352706151734">ERROR</strong>: indicates that the subnet is abnormal.</li></ul>
</li></ul>
</td>
</tr>
<tr id="vpc_subnet01_0002__row21291622105956"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p442246351103">neutron_network_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p462170191103">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p525910351103">Specifies the ID of the corresponding network (OpenStack Neutron API).</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row136513311102"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p197036161103">neutron_subnet_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p237568301103">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p452550761103">Specifies the ID of the corresponding subnet (OpenStack Neutron API).</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row7548849133011"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p114118445203">neutron_subnet_id_v6</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p241144422016">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p15679191053014">Specifies the ID of the IPv6 subnet (OpenStack Neutron API). If the subnet is an IPv4 subnet, this parameter is not returned.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row776211348365"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p5714303263">extra_dhcp_opts</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p01223042610">Array of <a href="#vpc_subnet01_0002__table019517383270">extra_dhcp_opt</a> objects</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p111573015263">Specifies the NTP server address configured for the subnet. For details, see <a href="#vpc_subnet01_0002__table019517383270">Table 4</a>.</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row20503707196"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p83661745101212">scope</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p4366945181218">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><ul id="vpc_subnet01_0002__ul39741155111314"><li id="vpc_subnet01_0002__li12262025338">Specifies where the subnet is used in edge cloud scenario.</li><li id="vpc_subnet01_0002__li299516311931">Range:<ul id="vpc_subnet01_0002__ul14629144011310"><li id="vpc_subnet01_0002__li1462944017310"><strong id="vpc_subnet01_0002__b43235518214">center</strong>: The subnet is used in a central AZ.</li><li id="vpc_subnet01_0002__li178642815317"><em id="vpc_subnet01_0002__i358711311583">{publicBorderGroup}</em>: The subnet is used in a public border group. The public border group limits the usage scope of a subnet but can have multiple edge AZs associated. You can obtain the AZs by the API for Listing AZs.</li></ul>
</li></ul>
</td>
</tr>
<tr id="vpc_subnet01_0002__row1497671412415"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p8425113511211">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p1342543532116">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><p id="vpc_subnet01_0002__p9425143519213">Project ID</p>
</td>
</tr>
<tr id="vpc_subnet01_0002__row997611141641"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p106711441172119">created_at</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p867112418216">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><ul id="vpc_subnet01_0002__ul13463133512"><li id="vpc_subnet01_0002__li114610173513">Specifies the time (UTC) when the subnet is created.</li><li id="vpc_subnet01_0002__li84711133511">Format: <em id="vpc_subnet01_0002__i10364543171614">yyyy-MM-ddTHH:mm:ss</em></li></ul>
</td>
</tr>
<tr id="vpc_subnet01_0002__row209763141842"><td class="cellrowborder" valign="top" width="28.95%" headers="mcps1.3.5.3.2.4.1.1 "><p id="vpc_subnet01_0002__p96711541192118">updated_at</p>
</td>
<td class="cellrowborder" valign="top" width="19.950000000000003%" headers="mcps1.3.5.3.2.4.1.2 "><p id="vpc_subnet01_0002__p1467116412217">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.1%" headers="mcps1.3.5.3.2.4.1.3 "><ul id="vpc_subnet01_0002__ul9899124133520"><li id="vpc_subnet01_0002__li128991544351">Specifies the time (UTC) when the subnet is updated.</li><li id="vpc_subnet01_0002__li989913413351">Format: <em id="vpc_subnet01_0002__i736810139170">yyyy-MM-ddTHH:mm:ss</em></li></ul>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><a name="vpc_subnet01_0002__table019517383270"></a><a name="table019517383270"></a><table cellpadding="4" cellspacing="0" summary="" id="vpc_subnet01_0002__table019517383270" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="vpc_subnet01_0002__vpc_subnet01_0001_b842352706165741">extra_dhcp_opt</strong> object</caption><thead align="left"><tr id="vpc_subnet01_0002__vpc_subnet01_0001_row1806141418109"><th align="left" class="cellrowborder" valign="top" width="21.740000000000002%" id="mcps1.3.5.4.2.5.1.1"><p id="vpc_subnet01_0002__vpc_subnet01_0001_p1948182811017"><strong id="vpc_subnet01_0002__vpc_subnet01_0001_b842352706195711">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.17%" id="mcps1.3.5.4.2.5.1.2"><p id="vpc_subnet01_0002__vpc_subnet01_0001_p19515288107">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.619999999999997%" id="mcps1.3.5.4.2.5.1.3"><p id="vpc_subnet01_0002__vpc_subnet01_0001_p755202861014">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="45.47%" id="mcps1.3.5.4.2.5.1.4"><p id="vpc_subnet01_0002__vpc_subnet01_0001_p66018281105"><strong id="vpc_subnet01_0002__vpc_subnet01_0001_b1716215324573">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_subnet01_0002__vpc_subnet01_0001_row19806161420105"><td class="cellrowborder" valign="top" width="21.740000000000002%" headers="mcps1.3.5.4.2.5.1.1 "><p id="vpc_subnet01_0002__vpc_subnet01_0001_p1834323611017">opt_value</p>
</td>
<td class="cellrowborder" valign="top" width="16.17%" headers="mcps1.3.5.4.2.5.1.2 "><p id="vpc_subnet01_0002__vpc_subnet01_0001_p1034310368108">No</p>
</td>
<td class="cellrowborder" valign="top" width="16.619999999999997%" headers="mcps1.3.5.4.2.5.1.3 "><p id="vpc_subnet01_0002__vpc_subnet01_0001_p15343163651014">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.47%" headers="mcps1.3.5.4.2.5.1.4 "><ul id="vpc_subnet01_0002__vpc_subnet01_0001_ul1734314363102"><li id="vpc_subnet01_0002__vpc_subnet01_0001_li2034343671010">Specifies the NTP server address configured for the subnet.</li><li id="vpc_subnet01_0002__vpc_subnet01_0001_li12343183661011">Constraints:<p id="vpc_subnet01_0002__vpc_subnet01_0001_p1984274292214"><a name="vpc_subnet01_0002__vpc_subnet01_0001_li12343183661011"></a><a name="vpc_subnet01_0001_li12343183661011"></a>If <strong id="vpc_subnet01_0002__vpc_subnet01_0001_b1854816203119">opt_name</strong> is set to <strong id="vpc_subnet01_0002__vpc_subnet01_0001_b18312174218176">ntp</strong>, the value indicates the NTP server configured for the subnet. Currently, only IPv4 addresses are supported. A maximum of four IP addresses can be configured, and each address must be unique. Multiple IP addresses must be separated using commas (,). If <strong id="vpc_subnet01_0002__vpc_subnet01_0001_b104061248161117">opt_name</strong> is set to <strong id="vpc_subnet01_0002__vpc_subnet01_0001_b1973813315213">null</strong>, the value indicates that no NTP server is configured for the subnet. The parameter value cannot be an empty string.</p>
</li></ul>
</td>
</tr>
<tr id="vpc_subnet01_0002__vpc_subnet01_0001_row48061714191011"><td class="cellrowborder" valign="top" width="21.740000000000002%" headers="mcps1.3.5.4.2.5.1.1 "><p id="vpc_subnet01_0002__vpc_subnet01_0001_p33437363104">opt_name</p>
</td>
<td class="cellrowborder" valign="top" width="16.17%" headers="mcps1.3.5.4.2.5.1.2 "><p id="vpc_subnet01_0002__vpc_subnet01_0001_p1634393613106">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="16.619999999999997%" headers="mcps1.3.5.4.2.5.1.3 "><p id="vpc_subnet01_0002__vpc_subnet01_0001_p14343113613104">String</p>
</td>
<td class="cellrowborder" valign="top" width="45.47%" headers="mcps1.3.5.4.2.5.1.4 "><ul id="vpc_subnet01_0002__vpc_subnet01_0001_ul1934353641010"><li id="vpc_subnet01_0002__vpc_subnet01_0001_li1534373631020">Specifies the NTP server address configured for the subnet.</li><li id="vpc_subnet01_0002__vpc_subnet01_0001_li11343133651014">Currently, the value can be <strong id="vpc_subnet01_0002__vpc_subnet01_0001_b185618261310">ntp</strong>.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="vpc_subnet01_0002__section11349247513"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="vpc_subnet01_0002__screen16413155512812">{
"subnet": {
"id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
"name": "subnet",
"description": "",
"cidr": "192.168.20.0/24",
"dnsList": [
"114.xx.xx.114",
"114.xx.xx.115"
],
"status": "ACTIVE",
"vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85",
"gateway_ip": "192.168.20.1",
"ipv6_enable": false,
"dhcp_enable": true,
"primary_dns": "114.xx.xx.114",
"secondary_dns": "114.xx.xx.115",
"availability_zone": "aa-bb-cc",
"neutron_network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
"neutron_subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
"extra_dhcp_opts": [
{
"opt_value": "10.100.0.33,10.100.0.34",
"opt_name": "ntp"
}
],
"tenant_id": "087679f0aa80d32a2f4ec0172f5e902b",
"created_at": "2022-12-15T02:42:07",
"updated_at": "2022-12-15T02:42:07"
}
}</pre>
</div>
<div class="section" id="vpc_subnet01_0002__section31981619"><h4 class="sectiontitle">Status Code</h4><p id="vpc_subnet01_0002__p18112112662914">See <a href="vpc_api_0002.html">Status Codes</a>.</p>
</div>
<div class="section" id="vpc_subnet01_0002__section85821649202813"><h4 class="sectiontitle">Error Code</h4><p id="vpc_subnet01_0002__p7233105282813">See <a href="vpc_api_0003.html">Error Codes</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="vpc_subnet01_0000.html">Subnet</a></div>
</div>
</div>