doc-exports/docs/dc/api-ref/en-dc_topic_0055025315.html
Qin Ying, Fan 4a7d4f4cd8 DC API 0930 version
Reviewed-by: Kucerak, Kristian <kristian.kucerak@t-systems.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>
2022-10-06 09:33:01 +00:00

484 lines
40 KiB
HTML

<a name="en-dc_topic_0055025315"></a><a name="en-dc_topic_0055025315"></a>
<h1 class="topictitle1">Creating a Connection</h1>
<div id="body27824865"><div class="section" id="en-dc_topic_0055025315__section54540374"><h4 class="sectiontitle">Function</h4><p id="en-dc_topic_0055025315__p57902635">This API is used to create a connection.</p>
<div class="note" id="en-dc_topic_0055025315__note27041310163214"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ol id="en-dc_topic_0055025315__ol11517716143214"><li id="en-dc_topic_0055025315__li2525111673216">When you create a hosted connection that does not need to be confirmed, set <strong id="en-dc_topic_0055025315__b842352706163037">Status</strong> to <strong id="en-dc_topic_0055025315__b842352706163041">ACCEPT</strong>.</li><li id="en-dc_topic_0055025315__li854151603211">The bandwidth of a hosted connection cannot exceed that of the associated operations connection.</li></ol>
</div></div>
</div>
<div class="section" id="en-dc_topic_0055025315__section21101319"><h4 class="sectiontitle">URI</h4><p id="en-dc_topic_0055025315__p1014814366318">POST /v2.0/dcaas/direct-connects</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-dc_topic_0055025315__table7306830153125" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en-dc_topic_0055025315__row59179138153125"><th align="left" class="cellrowborder" valign="top" width="18.94%" id="mcps1.3.2.3.2.5.1.1"><p id="en-dc_topic_0055025315__p6185651415404">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.71%" id="mcps1.3.2.3.2.5.1.2"><p id="en-dc_topic_0055025315__p4432173215404">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="16.14%" id="mcps1.3.2.3.2.5.1.3"><p id="en-dc_topic_0055025315__p3329052615404">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="48.209999999999994%" id="mcps1.3.2.3.2.5.1.4"><p id="en-dc_topic_0055025315__p1217810515404">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en-dc_topic_0055025315__row37905744153125"><td class="cellrowborder" valign="top" width="18.94%" headers="mcps1.3.2.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p50466461153125">direct_connect</p>
</td>
<td class="cellrowborder" valign="top" width="16.71%" headers="mcps1.3.2.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p61251530153125">Dictionary data structure</p>
</td>
<td class="cellrowborder" valign="top" width="16.14%" headers="mcps1.3.2.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p62426879153125">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="48.209999999999994%" headers="mcps1.3.2.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p23412453153125">Specifies the <strong id="en-dc_topic_0055025315__b842352706163957">direct_connect</strong> object.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="en-dc_topic_0055025315__section31485239"><h4 class="sectiontitle">Request</h4><p id="en-dc_topic_0055025315__p21078426103641"><a href="#en-dc_topic_0055025315__table26517876">Table 2</a> lists the <strong id="en-dc_topic_0055025315__b84235270617391">direct_connect</strong> request parameters.</p>
<div class="tablenoborder"><a name="en-dc_topic_0055025315__table26517876"></a><a name="table26517876"></a><table cellpadding="4" cellspacing="0" summary="" id="en-dc_topic_0055025315__table26517876" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request parameters</caption><thead align="left"><tr id="en-dc_topic_0055025315__row40476817"><th align="left" class="cellrowborder" valign="top" width="20.82%" id="mcps1.3.3.3.2.5.1.1"><p id="en-dc_topic_0055025315__p57396781"><strong id="en-dc_topic_0055025315__b8423527069918">Parameter</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="11.26%" id="mcps1.3.3.3.2.5.1.2"><p id="en-dc_topic_0055025315__p18627652"><strong id="en-dc_topic_0055025315__b842352706165439">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="17.84%" id="mcps1.3.3.3.2.5.1.3"><p id="en-dc_topic_0055025315__p32444864"><strong id="en-dc_topic_0055025315__b842352706192549">Mandatory</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.080000000000005%" id="mcps1.3.3.3.2.5.1.4"><p id="en-dc_topic_0055025315__p10788361"><strong id="en-dc_topic_0055025315__b84235270616553">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="en-dc_topic_0055025315__row1442054"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p11555769212825">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p46548661212825">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p40193754212825">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p56409663212825">Specifies the project ID.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row56455847212711"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p60046645212825">name</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p60303421212825">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p43405365212825">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p50361529212825">Specifies the connection name.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row17304671212718"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p21811400212825">description</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p10454292212825">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p30649615212825">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p2345077921328">Provides supplementary information about the connection.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row10181252212730"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p33947790212825">port_type</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p24798963212825">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p20471702212825">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p470426021328">Specifies the type of the port used by the connection. The value can be <strong id="en-dc_topic_0055025315__b370581214151058">1G</strong> or <strong id="en-dc_topic_0055025315__b263825441151058">10G</strong>.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row12404882212734"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p17969725212825">bandwidth</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p15690831212825">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p31440261212825">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p3259456521328">Specifies the connection bandwidth in Mbit/s.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row13373700212741"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p39007376212955">location</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p2805339212955">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p43667943212955">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p859792021328">Specifies the connection access location.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row568472521295"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p35118572212955">peer_location</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p46823096212955">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p59054635212955">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p5662013921328">Specifies the physical location of the peer device accessed by the connection, specific to the street or data center name.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row938903521299"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p61193031212955">device_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p32925369212955">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p34771507212955">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p4654985521328">Specifies the gateway device ID of the connection.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row47530080212912"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p18777601212955">interface_name</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p41025697212955">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p63373303212955">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p3850248621328">Specifies the name of the interface accessed by the connection.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row57761938115652"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p48205386115652">redundant_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p5189660115752">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p17709321115752">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p2875131911580">Specifies the ID of the redundant connection using the same gateway.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row54509260212915"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p17229947212955">provider</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p61142987212955">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p65804377212955">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p2055217021328">Specifies the carrier who provides the leased line.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row62300161212918"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p43762504212955">provider_status</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p35371259212955">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p21643169212955">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p28964426203734">Specifies the status of the carrier's leased line.</p>
<p id="en-dc_topic_0055025315__p3389609721328">The value can be <strong id="en-dc_topic_0055025315__b842352706171439">ACTIVE</strong> or <strong id="en-dc_topic_0055025315__b842352706171443">DOWN</strong>.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row39647359112012"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p1555872112023">type</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p58916789112023">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p7530619112023">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p168021375614">Specifies the connection type. The value can be <strong id="en-dc_topic_0055025315__b1665063873">hosted</strong>.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row5337525611209"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p12222720112023">hosting_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p50516226112023">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p65282521112023">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p53392877112023">Specifies the ID of the operations connection on which the hosted connection is created.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row2497249511206"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p266578112023">vlan</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p21592892112023">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p4193855112023">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p4157954112023">Specifies the VLAN pre-allocated to the hosted connection.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row21368111958"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p56574156112023">charge_mode</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p19103944112023">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p3915665112023">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p68761049141015">Specifies the billing mode. The value can be <strong id="en-dc_topic_0055025315__b842352706153349">prepayment</strong>, <strong id="en-dc_topic_0055025315__b842352706153353">bandwidth</strong>, or <strong id="en-dc_topic_0055025315__b842352706153357">traffic</strong>.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row13082768154933"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p36324518154942">order_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p56604823154942">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p21587982154942">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p3796080154942">Specifies the order number of the connection.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row29968911154930"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p15879398154942">product_id</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p11162871154942">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p31777360154942">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p23829402154942">Specifies the product ID corresponding to the connection's order.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row24943363212922"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p12636115212955">status</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p19656103212955">String</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p8052318212955">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p8311016203710">Specifies the connection status.</p>
<p id="en-dc_topic_0055025315__p2927466021328">The value can be <strong id="en-dc_topic_0055025315__b84235270617169">ACTIVE</strong>, <strong id="en-dc_topic_0055025315__b842352706171613">DOWN</strong>, <strong id="en-dc_topic_0055025315__b842352706171618">BUILD</strong>, <strong id="en-dc_topic_0055025315__b842352706171622">ERROR</strong>, <strong id="en-dc_topic_0055025315__b842352706171633">PENDING_DELETE</strong>, <strong id="en-dc_topic_0055025315__b842352706231627">DELETED</strong>, <strong id="en-dc_topic_0055025315__b842352706171637">APPLY</strong>, <strong id="en-dc_topic_0055025315__b842352706171640">DENY</strong>, <strong id="en-dc_topic_0055025315__b842352706171644">PENDING_PAY</strong>, <strong id="en-dc_topic_0055025315__b842352706171648">PAID</strong>, <strong id="en-dc_topic_0055025315__b842352706231650">ORDERING</strong>, <strong id="en-dc_topic_0055025315__b84235270615185">ACCEPT,</strong> or <strong id="en-dc_topic_0055025315__b842352706231656">REJECTED</strong>.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row59943627212941"><td class="cellrowborder" valign="top" width="20.82%" headers="mcps1.3.3.3.2.5.1.1 "><p id="en-dc_topic_0055025315__p25408944212955">admin_state_up</p>
</td>
<td class="cellrowborder" valign="top" width="11.26%" headers="mcps1.3.3.3.2.5.1.2 "><p id="en-dc_topic_0055025315__p47722852212955">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="17.84%" headers="mcps1.3.3.3.2.5.1.3 "><p id="en-dc_topic_0055025315__p2012153212955">No</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.3.3.2.5.1.4 "><p id="en-dc_topic_0055025315__p29293435203715">Specifies the administrative status of the connection.</p>
<p id="en-dc_topic_0055025315__p895390621328">The value can be <strong id="en-dc_topic_0055025315__b842352706154840">true</strong> or <strong id="en-dc_topic_0055025315__b842352706154844">false</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="en-dc_topic_0055025315__section14931696"><h4 class="sectiontitle">Response</h4><p id="en-dc_topic_0055025315__p42735278143140"><a href="#en-dc_topic_0055025315__table50787760154022">Table 3</a> lists the response parameter.</p>
<div class="tablenoborder"><a name="en-dc_topic_0055025315__table50787760154022"></a><a name="table50787760154022"></a><table cellpadding="4" cellspacing="0" summary="" id="en-dc_topic_0055025315__table50787760154022" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Response parameter</caption><thead align="left"><tr id="en-dc_topic_0055025315__row48608566154022"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.4.3.2.4.1.1"><p id="en-dc_topic_0055025315__p44979764154022">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="28.000000000000004%" id="mcps1.3.4.3.2.4.1.2"><p id="en-dc_topic_0055025315__p19482271154022"><strong id="en-dc_topic_0055025315__b921998122">Type</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="42%" id="mcps1.3.4.3.2.4.1.3"><p id="en-dc_topic_0055025315__p47904218154022">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en-dc_topic_0055025315__row55036410154022"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.3.2.4.1.1 "><p id="en-dc_topic_0055025315__p28764198154022">direct_connect</p>
</td>
<td class="cellrowborder" valign="top" width="28.000000000000004%" headers="mcps1.3.4.3.2.4.1.2 "><p id="en-dc_topic_0055025315__p48198727154022">Dictionary data structure</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.3.4.3.2.4.1.3 "><p id="en-dc_topic_0055025315__p14887047154022">Specifies the <strong id="en-dc_topic_0055025315__b84235270616488">direct_connect</strong> object.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-dc_topic_0055025315__table31929956" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Description of field <strong id="en-dc_topic_0055025315__b8423527069345">direct_connect</strong></caption><thead align="left"><tr id="en-dc_topic_0055025315__row12454319"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.4.4.2.4.1.1"><p id="en-dc_topic_0055025315__p2166929">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="27%" id="mcps1.3.4.4.2.4.1.2"><p id="en-dc_topic_0055025315__p41303584">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="43%" id="mcps1.3.4.4.2.4.1.3"><p id="en-dc_topic_0055025315__p7224675">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="en-dc_topic_0055025315__row48327783"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p2618796021374">id</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p1461720021374">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p3207700921374">Specifies the connection ID.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row3324189521359"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p42330775213632">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p21800648213632">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p31253263213632">Specifies the project ID.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row66728889213524"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p54759239213632">name</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p23617166213632">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p6069654213632">Specifies the connection name.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row15439121213515"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p53086796213632">description</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p59471933213632">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p31024005213632">Provides supplementary information about the connection.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row50661489213528"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p34534799213632">port_type</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p5532130213632">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p48559645213632">Specifies the type of the port used by the connection. The value can be <strong id="en-dc_topic_0055025315__b421600484">1G</strong> or <strong id="en-dc_topic_0055025315__b669377592">10G</strong>.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row5846484213534"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p55551229213632">bandwidth</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p16783167213632">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p63052895213632">Specifies the bandwidth of the connection in Mbit/s.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row49999429213538"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p35507620213632">location</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p29337441213632">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p13353953213632">Specifies the connection access location.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row62607450213545"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p61083552213632">peer_location</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p12557904213632">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p7267427213632">Specifies the physical location of the peer device accessed by the connection, specific to the street or data center name.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row41934009213550"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p14049627213632">device_id</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p63445678213632">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p28938027213632">Specifies the gateway device ID of the connection.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row25822170213553"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p2078158213632">interface_name</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p47522281213632">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p66449147213632">Specifies the name of the interface accessed by the connection.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row5375448520281"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p4564411202825">redundant_id</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p34173036202825">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p65689804202825">Specifies the ID of the redundant connection using the same gateway.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row318971213557"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p12907438213632">provider</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p32214012213632">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p29079571213632">Specifies the carrier who provides the leased line.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row41217866213559"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p23411026145150">provider_status</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p56606343145150">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p51755739145150">Specifies the status of the carrier's leased line. The value can be <strong id="en-dc_topic_0055025315__b1340791547">ACTIVE</strong> or <strong id="en-dc_topic_0055025315__b1344542104">DOWN</strong>.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row66457087113744"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p39573682113840">type</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p51351654113840">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p469315375815">Specifies the connection type. The value can be <strong id="en-dc_topic_0055025315__b1406037749">hosted</strong>.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row65870323113739"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p29166812113840">hosting_id</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p13701604113840">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p37456908113840">Specifies the ID of the operations connection on which the hosted connection is created.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row12695056113736"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p59887593113840">vlan</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p19056878113840">Integer</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p8364989113840">Specifies the pre-allocated VLAN to the hosted connection.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row24770090113731"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p51377985113840">charge_mode</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p867286113840">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p53123906113840">Specifies the billing mode. The value can be <strong id="en-dc_topic_0055025315__b1258592319">prepayment</strong>, <strong id="en-dc_topic_0055025315__b2133849466">bandwidth</strong>, or <strong id="en-dc_topic_0055025315__b119600038">traffic</strong>.</p>
<p id="en-dc_topic_0055025315__p1329472151219">Its value is left blank by default.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row39466389113733"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p5513004113840">apply_time</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p43900170113840">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p64883444113840">Specifies the time when the connection is requested.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row43420664113728"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p55390672113840">create_time</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p57459409113840">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p40696141113840">Specifies the time when the connection is created.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row1545172521215"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p125451025111216">delete_time</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p895805311123">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p14966653201217">Specifies the time when the connection is deleted.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row61781628155015"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p61852912155018">order_id</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p44029946155018">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p43926908155018">Specifies the order number of the connection.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row4132540155011"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p11787873155018">product_id</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p15293679155018">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p14077379155018">Specifies the product ID corresponding to the connection's order.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row3470610321362"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p37955181145150">status</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p28127726145150">String</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p63582831145150">Specifies the connection status. The value can be <strong id="en-dc_topic_0055025315__b635306943">ACTIVE</strong>, <strong id="en-dc_topic_0055025315__b459278345">DOWN</strong>, <strong id="en-dc_topic_0055025315__b1610748964">BUILD</strong>, <strong id="en-dc_topic_0055025315__b254111958">ERROR</strong>, <strong id="en-dc_topic_0055025315__b573557709231737">PENDING_DELETE</strong>, <strong id="en-dc_topic_0055025315__b810642512231737">DELETED</strong>, <strong id="en-dc_topic_0055025315__b17872564231737">APPLY</strong>, <strong id="en-dc_topic_0055025315__b1765160533231737">DENY</strong>, <strong id="en-dc_topic_0055025315__b1723423809231737">PENDING_PAY</strong>, <strong id="en-dc_topic_0055025315__b733428447231737">PAID</strong>, <strong id="en-dc_topic_0055025315__b1888084103231737">ORDERING</strong>, <strong id="en-dc_topic_0055025315__b842352706151915">ACCEPT</strong>, or <strong id="en-dc_topic_0055025315__b1504845468231737">REJECTED</strong>.</p>
</td>
</tr>
<tr id="en-dc_topic_0055025315__row5737311521368"><td class="cellrowborder" valign="top" width="30%" headers="mcps1.3.4.4.2.4.1.1 "><p id="en-dc_topic_0055025315__p64345853213632">admin_state_up</p>
</td>
<td class="cellrowborder" valign="top" width="27%" headers="mcps1.3.4.4.2.4.1.2 "><p id="en-dc_topic_0055025315__p42048472213632">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.4.4.2.4.1.3 "><p id="en-dc_topic_0055025315__p21010737202946">Specifies the administrative status of the connection.</p>
<p id="en-dc_topic_0055025315__p65467559213632">The value can be <strong id="en-dc_topic_0055025315__b2472364020194">true</strong> or <strong id="en-dc_topic_0055025315__b2118616920194">false</strong>.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="en-dc_topic_0055025315__section38241653113834"><h4 class="sectiontitle">Examples</h4><ul id="en-dc_topic_0055025315__ul115651283418"><li id="en-dc_topic_0055025315__li10561712193411">Example request<pre class="screen" id="en-dc_topic_0055025315__screen37309928112646">POST /v2.0/dcaas/direct-connects
{
"direct_connect" : {
"name" : "direct connect1",
"port_type" : "10G",
"bandwidth" : 100,
"location" : "Biere",
"device_id" : "172.16.40.2",
"provider" : "OTC"
}
} </pre>
</li></ul>
</div>
<ul id="en-dc_topic_0055025315__ul11972112633419"><li id="en-dc_topic_0055025315__li2972102623411">Example response<pre class="screen" id="en-dc_topic_0055025315__screen18613164313419">{
"direct_connect" : {
"bandwidth" : 100,
"create_time": "2018-10-19 09:53:26.389556",
"port_type" : "10G",
"id" : "6ecd9cf3-ca64-46c7-863f-f2eb1b9e838a",
"apply_time": "2018-10-19 09:53:26.389556",
"peer_location": "",
"delete_time": null,
"location" : "Biere",
"provider" : "OTC"
"interface_name": "Eth-Trunk2",
"type": "standard",
"status": "BUILD",
"description" : "",
"provider_status": "ACTIVE", "order_id": "", "vlan": null,
"device_id" : "172.16.40.2",
"name" : "direct connect1",
"admin_state_up": true,
"tenant_id" : "6fbe9263116a4b68818cf1edce16bc4f",
"redundant_id": null,
"hosting_id": null,
"product_id": "",
"charge_mode": ""
}
}</pre>
</li></ul>
<div class="section" id="en-dc_topic_0055025315__section6416329132915"><h4 class="sectiontitle">Returned Value</h4><p id="en-dc_topic_0055025315__p176816317298">For details, see section <a href="en-dc_topic_0055025342.html">Common Returned Values</a>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="en-dc_topic_0055025313.html">Connection</a></div>
</div>
</div>