forked from docs/doc-exports
263 lines
27 KiB
HTML
263 lines
27 KiB
HTML
<a name="elb_zq_jt_0003"></a><a name="elb_zq_jt_0003"></a>
|
|
|
|
<h1 class="topictitle1">Querying Details of a Listener</h1>
|
|
<h4 class="sectiontitle">Function</h4><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0049139641_p26992952">This API is used to query details about a listener using its ID.</p>
|
|
|
|
<h4 class="sectiontitle">URI</h4><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0049139641_p46411882344">GET /v2.0/lbaas/listeners/{listener_id}</p>
|
|
|
|
|
|
<table cellpadding="4" cellspacing="0" summary="" id="elb_zq_jt_0003__en-us_topic_0096561540_table154765473473" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="elb_zq_jt_0003__en-us_topic_0096561540_row251511470478"><th align="left" class="cellrowborder" valign="top" width="14.000000000000002%" id="mcps1.3.3.2.5.1.1"><p id="elb_zq_jt_0003__en-us_topic_0096561540_p1151618474475">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="10%" id="mcps1.3.3.2.5.1.2"><p id="elb_zq_jt_0003__en-us_topic_0096561540_p5516144724717">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33%" id="mcps1.3.3.2.5.1.3"><p id="elb_zq_jt_0003__en-us_topic_0096561540_p5516164784711">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="43%" id="mcps1.3.3.2.5.1.4"><p id="elb_zq_jt_0003__en-us_topic_0096561540_p6516184717476">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="elb_zq_jt_0003__en-us_topic_0096561540_row751634716478"><td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.2.5.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_p13516174764715">listener_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.3.2.5.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_p8516847144719">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33%" headers="mcps1.3.3.2.5.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_p1871353355117">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43%" headers="mcps1.3.3.2.5.1.4 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_p165161147164711">Specifies the listener ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<h4 class="sectiontitle">Request</h4><p id="elb_zq_jt_0003__en-us_topic_0096561540_p7386191035510">None</p>
|
|
|
|
<h4 class="sectiontitle">Response</h4>
|
|
<table cellpadding="4" cellspacing="0" summary="" id="elb_zq_jt_0003__en-us_topic_0096561540_table47901746151717" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameters</caption><thead align="left"><tr id="elb_zq_jt_0003__en-us_topic_0096561540_row0791124610170"><th align="left" class="cellrowborder" valign="top" width="13.861386138613863%" id="mcps1.3.5.2.2.4.1.1"><p id="elb_zq_jt_0003__en-us_topic_0096561540_p379194618173">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="10.891089108910892%" id="mcps1.3.5.2.2.4.1.2"><p id="elb_zq_jt_0003__en-us_topic_0096561540_p6791124617173">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="75.24752475247524%" id="mcps1.3.5.2.2.4.1.3"><p id="elb_zq_jt_0003__en-us_topic_0096561540_p11791446191715">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="elb_zq_jt_0003__en-us_topic_0096561540_row0792184681720"><td class="cellrowborder" valign="top" width="13.861386138613863%" headers="mcps1.3.5.2.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_p1879219462172">listener</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="10.891089108910892%" headers="mcps1.3.5.2.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_p167924467178">Object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="75.24752475247524%" headers="mcps1.3.5.2.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_p6792246151717">Lists the listeners. For details, see <a href="#elb_zq_jt_0003__en-us_topic_0096561540_table7513153305114">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
|
|
<a name="elb_zq_jt_0003__en-us_topic_0096561540_table7513153305114"></a><a name="en-us_topic_0096561540_table7513153305114"></a><table cellpadding="4" cellspacing="0" summary="" id="elb_zq_jt_0003__en-us_topic_0096561540_table7513153305114" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b1649080039">listeners</strong> parameter description</caption><thead align="left"><tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row34671725195410"><th align="left" class="cellrowborder" valign="top" width="16%" id="mcps1.3.5.3.2.4.1.1"><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p946792525418">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="14.000000000000002%" id="mcps1.3.5.3.2.4.1.2"><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p8467142519541">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="70%" id="mcps1.3.5.3.2.4.1.3"><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p104671125165411">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row12467122519549"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p8467425205419">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p3467192515543">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p9467132535416">Specifies the listener ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row124679252544"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p44682025175413">tenant_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p146811253546">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p19468192515548">Specifies the ID of the project where the listener is used.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row746816255547"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p184683251549">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p1046842519548">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p44681425125418">Specifies the listener name.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row1046812512541"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p546862545411">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p154685252543">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p14468172517540">Provides supplementary information about the listener.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row1046832595418"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p17468125125414">protocol</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p746811255546">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p201601841193216">Specifies the protocol used by the listener.</p>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p0300344103218">The value can be <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b103871119189">TCP</strong>, <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b1038921117183">HTTP</strong>, <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b183906115182">UDP</strong>, or <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b193911311181810">TERMINATED_HTTPS</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row1346912520548"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p144691225205414">protocol_port</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p446952515416">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p18323468323">Specifies the port used by the listener.</p>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p7688104743213">The port number ranges from 1 to 65535.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row1546932511547"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p19469202585413">loadbalancers</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p546911258548">Array</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p16788191994017">Specifies the ID of the associated load balancer. For details, see <a href="elb_zq_jt_0001.html#elb_zq_jt_0001__en-us_topic_0096561542_table17641175071912">Table 6</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row16469625125411"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p3469112575415">connection_limit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p144691725185411">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p636816504321">Specifies the maximum number of connections.</p>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p17992184321313">The value ranges from <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b1262188182">-1</strong> to <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b182018161820">2147483647</strong>. The default value is <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b780161918188">-1</strong>, indicating that there is no restriction on the maximum number of connections.</p>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p8758551203215">This parameter is reserved.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row44691325175419"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p446922525410">admin_state_up</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p3469102512549">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p257371723315">Specifies the administrative status of the listener.</p>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p1794055920316">This parameter is reserved. The value can be <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b1437913531122">true</strong> or <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b0380553171215">false</strong>.</p>
|
|
<ul id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_ul118694033910"><li id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_li1786915015393"><strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b578855417125">true</strong>: The load balancer is enabled.</li><li id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_li1031815323916"><strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b6300115620122">false</strong>: The load balancer is disabled.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row155261945821"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p149771721230">http2_enable</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p149775217319">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p483792111330">Specifies whether to use HTTP/2.</p>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p183584202475">The value can be <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b53581020204716">true</strong> or <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b93584201473">false</strong>.</p>
|
|
<ul id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_ul2055452614479"><li id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_li1555319262479"><strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b155372615476">true</strong>: HTTP/2 is used.</li><li id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_li9669928124716"><strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b366918288476">false</strong>: HTTP/2 is not used.</li></ul>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p3519192712331">This parameter is valid only when the protocol used by the listener is set to <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b167901226151113">TERMINATED_HTTPS</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row1547012555419"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p20470112585411">default_pool_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p9470525195410">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p3466142973313">Specifies the ID of the associated backend server group.</p>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p149661432143316">If a request does not match the forwarding policy, the request is forwarded to the default backend server group for processing. If the value is <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b125951581919">null</strong>, the listener has no default backend server group.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row94701258544"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p114701625185416">default_tls_container_ref</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p194705259542">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p8103123513337">Specifies the ID of the server certificate used by the listener. For details, see <a href="elb_zq_zs_0000.html#elb_zq_zs_0000">Certificate</a>.</p>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p15749173783317">This parameter is mandatory when <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b771517531197">protocol</strong> is set to <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b11716753181920">TERMINATED_HTTPS</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row174701325205420"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p347010254548">client_ca_tls_container_ref</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p4470825185414">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p1867105844415">Specifies the ID of the CA certificate used by the listener. For details, see <a href="elb_zq_zs_0000.html#elb_zq_zs_0000">Certificate</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row1947122517545"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p1247117256543">sni_container_refs</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p7471172515547">Array</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p33961341163319">Lists the IDs of SNI certificates (server certificates with a domain name) used by the listener.</p>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p8259184619337">If the parameter value is an empty list, the SNI feature is disabled.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row18840123882117"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p38408381214">tags</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p12840538162110">Array</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p19840203842114">Tags the listener.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row109815596568"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p18781627124910">created_at</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p18781627204916">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p15848951122220">Specifies the time when the listener was created. The UTC time is in <em id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_i1017723733015">YYYY-MM-DDTHH:MM:SS</em> format.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row122703319572"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p1541843114495">updated_at</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p1810172112506">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p341843144919">Specifies the time when the listener was updated. The UTC time is in <em id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_i12883301256">YYYY-MM-DDTHH:MM:SS</em> format.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row674511497493"><td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.5.3.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p15804713184311">tls_ciphers_policy</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.5.3.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p78041413134319">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.5.3.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p546123425013">Specifies the security policy used by the listener. This parameter is valid only when the protocol used by the listener is set to <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b156051134122510">TERMINATED_HTTPS</strong>.</p>
|
|
<p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p3241114918325">The value can be <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b18364926031">tls-1-0-inherit</strong>, <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b13885173792519">tls-1-0</strong>, <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b15887123752517">tls-1-1</strong>, <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b9887123742520">tls-1-2</strong>, or <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b13889133713252">tls-1-2-strict</strong>, and the default value is <strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b2088953792517">tls-1-0</strong>. For details of cipher suites for each security policy, see <a href="elb_zq_jt_0001.html#elb_zq_jt_0001__en-us_topic_0096561542_table1247813103533">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
|
|
<table cellpadding="4" cellspacing="0" summary="" id="elb_zq_jt_0003__en-us_topic_0096561540_table17641175071912" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_b637553141620">loadbalancers</strong> parameter description</caption><thead align="left"><tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row17642135018199"><th align="left" class="cellrowborder" valign="top" width="25.290000000000003%" id="mcps1.3.5.4.2.4.1.1"><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p564295010190">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="21.13%" id="mcps1.3.5.4.2.4.1.2"><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p126421250191912">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="53.580000000000005%" id="mcps1.3.5.4.2.4.1.3"><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p11642205012199">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_row664275021919"><td class="cellrowborder" valign="top" width="25.290000000000003%" headers="mcps1.3.5.4.2.4.1.1 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p464219506196">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="21.13%" headers="mcps1.3.5.4.2.4.1.2 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p156423501195">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.580000000000005%" headers="mcps1.3.5.4.2.4.1.3 "><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561542_p164210502197">Specifies the ID of the associated load balancer.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
|
|
<h4 class="sectiontitle">Example Request</h4><ul id="elb_zq_jt_0003__en-us_topic_0096561540_ul1972419373"><li id="elb_zq_jt_0003__en-us_topic_0096561540_li99024103714">Example request: Viewing details of a listener<pre class="screen" id="elb_zq_jt_0003__en-us_topic_0096561540_screen953510003815">GET https://{Endpoint}/v2.0/lbaas/listeners/09e64049-2ab0-4763-a8c5-f4207875dc3e</pre>
|
|
</li></ul>
|
|
|
|
<h4 class="sectiontitle">Example Response</h4><ul id="elb_zq_jt_0003__en-us_topic_0096561540_ul88581218152813"><li id="elb_zq_jt_0003__en-us_topic_0096561540_li1385861872817">Example response<pre class="screen" id="elb_zq_jt_0003__en-us_topic_0096561540_screen58582188286">{
|
|
"listener": {
|
|
"protocol_port": 8000,
|
|
"protocol": "TCP",
|
|
"description": "",
|
|
"client_ca_tls_container_ref": null,
|
|
"default_tls_container_ref": null,
|
|
"admin_state_up": true,
|
|
"http2_enable": false,
|
|
"loadbalancers": [
|
|
{
|
|
"id": "3d77894d-2ffe-4411-ac0a-0d57689779b8"
|
|
}
|
|
],
|
|
"tenant_id": "1867112d054b427e808cc6096d8193a1",
|
|
"sni_container_refs": [],
|
|
"connection_limit": -1,
|
|
"default_pool_id": "b7e53dbd-62ab-4505-a280-5c066078a5c9",
|
|
"id": "09e64049-2ab0-4763-a8c5-f4207875dc3e",
|
|
"tags": [],
|
|
"name": "listener-2",
|
|
"tls_ciphers_policy": null,
|
|
"created_at": "2018-07-25T01:54:13",
|
|
"updated_at": "2018-07-25T01:54:14"
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
|
|
<h4 class="sectiontitle">Status Code</h4><p id="elb_zq_jt_0003__en-us_topic_0096561540_en-us_topic_0096561531_en-us_topic_0049139631_p12358762">For details, see <a href="elb_gc_0002.html">HTTP Status Codes of Shared Load Balancers</a>.</p>
|
|
|
|
|
|
|
|
|
|
<strong>Parent topic:</strong> <a href="elb_zq_jt_0000.html">Listener</a>
|
|
|
|
|
|
|