doc-exports/docs/vpc/api-ref/vpc_subnet01_0002.html
Qin Ying, Fan 310d2d9eb1 VPC API 20230106 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-02-06 08:38:37 +00:00

304 lines
25 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">Name</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">Name</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">Name</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 an IPv6 subnet can be created.</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 IP address of DNS server 1 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 IP address of DNS server 2 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__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 to which the subnet belongs.</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 "><p id="vpc_subnet01_0002__p167191226171312">Specifies where the subnet is used in edge cloud scenario.</p>
<p id="vpc_subnet01_0002__p91113352131">Values:</p>
<ul id="vpc_subnet01_0002__ul39741155111314"><li id="vpc_subnet01_0002__li09751455101310"><strong id="vpc_subnet01_0002__b43235518214">center</strong>: The subnet is used in a central AZ.</li><li id="vpc_subnet01_0002__li1997519553137"><em id="vpc_subnet01_0002__i15192176021">{azId}</em>: The subnet is used in an edge AZ.</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">Name</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>The option <strong id="vpc_subnet01_0002__vpc_subnet01_0001_b18312174218176">ntp</strong> for <strong id="vpc_subnet01_0002__vpc_subnet01_0001_b2456833191713">opt_name</strong> 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 (,). The option <strong id="vpc_subnet01_0002__vpc_subnet01_0001_b1973813315213">null</strong> for <strong id="vpc_subnet01_0002__vpc_subnet01_0001_b9368121819213">opt_name</strong> 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 name configured for the subnet.</li><li id="vpc_subnet01_0002__vpc_subnet01_0001_li11343133651014">Currently, the value can only be set to <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",
"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>