forked from docs/doc-exports
Qin Ying, Fan
310d2d9eb1
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>
282 lines
27 KiB
HTML
282 lines
27 KiB
HTML
<a name="vpc_eip_0002"></a><a name="vpc_eip_0002"></a>
|
|
|
|
<h1 class="topictitle1">Querying an EIP</h1>
|
|
<div id="body42410114"><div class="section" id="vpc_eip_0002__section40040492"><h4 class="sectiontitle">Function</h4><p id="vpc_eip_0002__p12667213">This API is used to query a specific EIP.</p>
|
|
<div class="note" id="vpc_eip_0002__note1672091317360"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><div class="p" id="vpc_eip_0002__en-us_topic_0118498850_p39817577485">Note the following when you use EIPs of the Dedicated Load Balancer (<strong id="vpc_eip_0002__en-us_topic_0118498850_b1958731314398">5_gray</strong>) type:<ul id="vpc_eip_0002__en-us_topic_0118498850_ul18141507494"><li id="vpc_eip_0002__en-us_topic_0118498850_li86521438154">In <strong id="vpc_eip_0002__en-us_topic_0118498850_b126181649151714">eu-de</strong>, EIPs of the Dedicated Load Balancer (<strong id="vpc_eip_0002__en-us_topic_0118498850_b108739322183">5_gray</strong>) type cannot be assigned anymore. You can assign EIPs of the BGP (<strong id="vpc_eip_0002__en-us_topic_0118498850_b1874731121812">5_bgp</strong>) type.</li><li id="vpc_eip_0002__en-us_topic_0118498850_li1194114411236">Existing EIPs of the Dedicated Load Balancer (<strong id="vpc_eip_0002__en-us_topic_0118498850_b113526330389">5_gray</strong>) type can be bound to dedicated or shared load balancers.<ul id="vpc_eip_0002__en-us_topic_0118498850_ul2044703613155"><li id="vpc_eip_0002__en-us_topic_0118498850_li1222113518159">The EIP console cannot be used to bind EIPs to or unbind them from dedicated load balancers.</li><li id="vpc_eip_0002__en-us_topic_0118498850_li1688013347356">You can use APIs to bind EIPs to or unbind them from dedicated load balancers. For details, see <a href="https://docs.otc.t-systems.com/elastic-ip/api-ref/api_v3/eips/binding_an_eip.html" target="_blank" rel="noopener noreferrer">Binding an EIP</a> and <a href="https://docs.otc.t-systems.com/elastic-ip/api-ref/api_v3/eips/unbinding_an_eip.html" target="_blank" rel="noopener noreferrer">Unbinding an EIP</a>.</li><li id="vpc_eip_0002__en-us_topic_0118498850_li15559236131711">EIPs of this type can be bound to or unbound from shared load balancers using the EIP console or APIs.</li><li id="vpc_eip_0002__en-us_topic_0118498850_li1659819163617">You are advised to bind BGP EIPs to or unbind them from dedicated load balancers.</li></ul>
|
|
</li><li id="vpc_eip_0002__en-us_topic_0118498850_li1468695512506">Do not add EIPs of the dedicated load balancer type (<strong id="vpc_eip_0002__en-us_topic_0118498850_b354915453512">5_gray</strong>) and other types to the same shared bandwidth. Otherwise, the bandwidth limit policy will not take effect.</li></ul>
|
|
</div>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="vpc_eip_0002__section24820109"><h4 class="sectiontitle">URI</h4><p id="vpc_eip_0002__p933835161715">GET /v1/{project_id}/publicips/{publicip_id}</p>
|
|
<div class="p" id="vpc_eip_0002__p44901531163712"><a href="#vpc_eip_0002__table57982344">Table 1</a> describes the parameters.
|
|
<div class="tablenoborder"><a name="vpc_eip_0002__table57982344"></a><a name="table57982344"></a><table cellpadding="4" cellspacing="0" summary="" id="vpc_eip_0002__table57982344" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="vpc_eip_0002__row19130757"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.2.2.4.1.1"><p id="vpc_eip_0002__p6087504">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_eip_0002__p23325828">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_eip_0002__p10343879">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="vpc_eip_0002__row32547908"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.1 "><p id="vpc_eip_0002__p19134881">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_eip_0002__p6421510">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.3 "><p id="vpc_eip_0002__p10487112">Specifies the project ID. </p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row50769665"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.1 "><p id="vpc_eip_0002__p18702178">publicip_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.2 "><p id="vpc_eip_0002__p38481481">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.2.4.1.3 "><p id="vpc_eip_0002__p29992219">Specifies the unique identifier of an EIP.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="vpc_eip_0002__section22054394"><h4 class="sectiontitle">Request Message</h4><ul id="vpc_eip_0002__ul13450690"><li id="vpc_eip_0002__li54281744171719">Request parameter<p id="vpc_eip_0002__p7290172843716"><a name="vpc_eip_0002__li54281744171719"></a><a name="li54281744171719"></a>None</p>
|
|
</li><li id="vpc_eip_0002__li2887900894422">Example request<pre class="screen" id="vpc_eip_0002__screen195791196337">Get https://{Endpoint}/v1/{project_id}/publicips/{publicip_id}</pre>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="vpc_eip_0002__section64271818"><h4 class="sectiontitle">Response Message</h4><ul id="vpc_eip_0002__ul13727043"><li id="vpc_eip_0002__li7793840">Response parameter
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="vpc_eip_0002__table64961662152123" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameter</caption><thead align="left"><tr id="vpc_eip_0002__row7248731152123"><th align="left" class="cellrowborder" valign="top" width="18.34%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="vpc_eip_0002__p50276345152123">Name</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25.509999999999998%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="vpc_eip_0002__p23039456152123">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="56.15%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="vpc_eip_0002__p54256632152123">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="vpc_eip_0002__row32711048152123"><td class="cellrowborder" valign="top" width="18.34%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="vpc_eip_0002__p32349241152123">publicip</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.509999999999998%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="vpc_eip_0002__p45145628152123"><a href="#vpc_eip_0002__table3035698">publicip</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="56.15%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="vpc_eip_0002__p27820057152123">Specifies the EIP object. For details, see <a href="#vpc_eip_0002__table3035698">Table 3</a>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="vpc_eip_0002__table3035698"></a><a name="table3035698"></a><table cellpadding="4" cellspacing="0" summary="" id="vpc_eip_0002__table3035698" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Description of the <strong id="vpc_eip_0002__b9762837195611">publicip</strong> field</caption><thead align="left"><tr id="vpc_eip_0002__row64466590"><th align="left" class="cellrowborder" valign="top" width="36.046395360463954%" id="mcps1.3.4.2.1.2.2.4.1.1"><p id="vpc_eip_0002__p54411269">Name</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="27.90720927907209%" id="mcps1.3.4.2.1.2.2.4.1.2"><p id="vpc_eip_0002__p3124580518523">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="36.046395360463954%" id="mcps1.3.4.2.1.2.2.4.1.3"><p id="vpc_eip_0002__p40293226">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="vpc_eip_0002__row42525879"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p22044193">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p4788225318523">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpc_eip_0002__p44048571">Specifies the unique identifier of an EIP.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row60892825"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p33371781">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p5325729418523">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><ul id="vpc_eip_0002__ul1945793192"><li id="vpc_eip_0002__li19457911917">Specifies the EIP status.</li><li id="vpc_eip_0002__li1045149191913">Possible values are as follows:<ul id="vpc_eip_0002__ul4678228115815"><li id="vpc_eip_0002__li2061882375415"><strong id="vpc_eip_0002__b84235270610153">FREEZED</strong> (Frozen)</li><li id="vpc_eip_0002__li9516132714542"><strong id="vpc_eip_0002__b842352706181622">BIND_ERROR</strong> (Binding failed)</li><li id="vpc_eip_0002__li142101130195412"><strong id="vpc_eip_0002__b842352706181646">BINDING</strong> (Binding)</li><li id="vpc_eip_0002__li18886123225416"><strong id="vpc_eip_0002__b84235270618176">PENDING_DELETE</strong> (Releasing)</li><li id="vpc_eip_0002__li18843635415"><strong id="vpc_eip_0002__b842352706181716">PENDING_CREATE</strong> (Assigning)</li><li id="vpc_eip_0002__li1197744545418"><strong id="vpc_eip_0002__b842352706181818">PENDING_UPDATE</strong> (Updating)</li><li id="vpc_eip_0002__li1487831953011"><strong id="vpc_eip_0002__b07851056439">NOTIFYING</strong> (Assigning)</li><li id="vpc_eip_0002__li1919318493119"><strong id="vpc_eip_0002__b16710182112314">NOTIFY_DELETE</strong> (Releasing)</li><li id="vpc_eip_0002__li19952124945414"><strong id="vpc_eip_0002__b842352706181834">DOWN</strong> (Unbound)</li><li id="vpc_eip_0002__li13389115319543"><strong id="vpc_eip_0002__b84235270610164">ACTIVE</strong> (Bound)</li><li id="vpc_eip_0002__li1572075905417"><strong id="vpc_eip_0002__b842352706181859">ELB</strong> (Bound to a load balancer)</li><li id="vpc_eip_0002__li161441845132911"><strong id="vpc_eip_0002__b13716231932">VPN</strong> (Bound to a VPN)</li><li id="vpc_eip_0002__li82512401181"><strong id="vpc_eip_0002__b842352706103022">ERROR</strong> (Exceptions)</li></ul>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row17803202152320"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p09743162419">profile</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p12971231132410"><a href="#vpc_eip_0002__table66651219193417">profile</a> object</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpc_eip_0002__p169773114242">Specifies the additional parameters, including the order ID and product ID. For details, see <a href="#vpc_eip_0002__table66651219193417">Table 4</a>.</p>
|
|
<p id="vpc_eip_0002__p1407131101719">This parameter is not supported currently.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row1722212174296"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p15848707">type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p3408038918330">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><ul id="vpc_eip_0002__ul7176216121014"><li id="vpc_eip_0002__en-us_topic_0020090596_li085013408491">Specifies the EIP type.</li><li id="vpc_eip_0002__en-us_topic_0020090596_li95615391617">The value can be <strong id="vpc_eip_0002__en-us_topic_0020090596_b236112814388">5_bgp</strong> (Dynamic BGP), <strong id="vpc_eip_0002__en-us_topic_0020090596_b11267530143818">5_mailbgp</strong> (Mail BGP), or <strong id="vpc_eip_0002__en-us_topic_0020090596_b14236103853812">5_gray</strong> (Dedicated Load Balancer).</li><li id="vpc_eip_0002__en-us_topic_0020090596_li2979182764911">Constraints:<ul id="vpc_eip_0002__en-us_topic_0020090596_ul9738153015499"><li id="vpc_eip_0002__en-us_topic_0020090596_li1385054094914">The configured value must be supported by the system. </li><li id="vpc_eip_0002__en-us_topic_0020090596_li92181231912"><strong id="vpc_eip_0002__en-us_topic_0020090596_b1171628102112">publicip_id</strong> is an IPv4 port. If <strong id="vpc_eip_0002__en-us_topic_0020090596_b178642038112119">publicip_type</strong> is not specified, the default value is <strong id="vpc_eip_0002__en-us_topic_0020090596_b819152812216">5_bgp</strong>.</li></ul>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row19379155218596"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p59653533594">public_ip_address</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p139651253165911">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpc_eip_0002__p1696514537598">Specifies the obtained EIP if only IPv4 EIPs are available. Specifies the IPv4 address corresponding to the IPv6 address if IPv6 EIPs are available. IPv6 is not supported currently.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row180110932914"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p171101456172118">ip_version</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p1811012569218">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><div class="p" id="vpc_eip_0002__p1211011564217">Specifies the IP address version. The value can be <strong id="vpc_eip_0002__b842352706115744">4</strong> or <strong id="vpc_eip_0002__b842352706115748">6</strong>.<ul id="vpc_eip_0002__ul13987110227"><li id="vpc_eip_0002__li998813101125"><strong id="vpc_eip_0002__b15212202817495">4</strong>: IPv4</li><li id="vpc_eip_0002__li45811172214"><strong id="vpc_eip_0002__b3619113024916">6</strong>: IPv6 (IPv6 is not supported currently.)</li></ul>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row66070243"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p50089467">private_ip_address</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p1357258018523">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><ul id="vpc_eip_0002__ul1693412582014"><li id="vpc_eip_0002__li1993419562014">Specifies the private IP address bound to the EIP.</li><li id="vpc_eip_0002__li39348502011">This parameter is returned only if the private IP address is bound to the EIP.</li></ul>
|
|
<div class="note" id="vpc_eip_0002__note694662018562"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpc_eip_0002__p194613206564">This parameter is not displayed if the EIP is bound to a dedicated load balancer. This parameter is displayed if the EIP is bound to an ECS.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row12246230153229"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p11971849153234">port_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p2563717518523">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><ul id="vpc_eip_0002__ul420471472010"><li id="vpc_eip_0002__li4203314152011">Specifies the port ID.</li><li id="vpc_eip_0002__li820412148206">This parameter is returned only when a port is associated with the EIP.</li></ul>
|
|
<div class="note" id="vpc_eip_0002__note06322034171917"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpc_eip_0002__vpc_floatingip_0002_p515453014185">This parameter is not displayed if the EIP is bound to a dedicated load balancer. This parameter is displayed if the EIP is bound to an ECS.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row7204713"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p46710863">tenant_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p6334526618523">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpc_eip_0002__p25354291121">Specifies the project ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row55494360"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p65858198">create_time</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p3069292618523">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpc_eip_0002__p36292894">Specifies the time (UTC) when the EIP is assigned.</p>
|
|
<p id="vpc_eip_0002__p7682202016546">Format: <em id="vpc_eip_0002__i881472114480">yyyy-MM-dd HH:mm:ss</em></p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row58200593"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p16627584">bandwidth_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p309907418523">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpc_eip_0002__p3934181618641">Specifies the ID of the EIP bandwidth.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row51415138"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p3876622">bandwidth_size</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p4969847118523">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpc_eip_0002__p2365466">Specifies the bandwidth (Mbit/s).</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row21289199"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p46703582">bandwidth_share_type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p6615323718523">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><ul id="vpc_eip_0002__ul2255712095"><li id="vpc_eip_0002__li152514111893">Specifies the EIP bandwidth type.</li><li id="vpc_eip_0002__li194901613132012">The value can be <strong id="vpc_eip_0002__b732433921164019">PER</strong> or <strong id="vpc_eip_0002__b1729357023164019">WHOLE</strong>.<ul id="vpc_eip_0002__ul729412507220"><li id="vpc_eip_0002__li429475092212"><strong id="vpc_eip_0002__b842352706204716">PER</strong>: Dedicated bandwidth</li><li id="vpc_eip_0002__li529411504225"><strong id="vpc_eip_0002__b842352706204729">WHOLE</strong>: Shared bandwidth</li></ul>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row5951536918414"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p6587627918414">bandwidth_name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p3318647218414">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpc_eip_0002__p374970718414">Specifies the bandwidth name.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row7438151912404"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p979842771215">alias</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p137987278128">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpc_eip_0002__p175531744191218">Specifies the EIP name.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row1066119511342"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p19564181313543">enterprise_project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p13564413185412">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><ul id="vpc_eip_0002__ul184004104214"><li id="vpc_eip_0002__li2400141032116">Specifies the enterprise project ID. The value is <strong id="vpc_eip_0002__b16884458183812">0</strong> or a string that contains a maximum of 36 characters in UUID format with hyphens (-).</li><li id="vpc_eip_0002__li2040016104214">When assigning an EIP, you need to associate an enterprise project ID with the EIP.</li><li id="vpc_eip_0002__li5375513174417">If this parameter is not specified, the default value is <strong id="vpc_eip_0002__b01929345594">0</strong>, which indicates that the default enterprise project is used.</li></ul>
|
|
<div class="note" id="vpc_eip_0002__note19041412125118"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="vpc_eip_0002__vpc_api01_0001_p182751511487">This parameter is unsupported. Do not use it.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row0494191811246"><td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.1 "><p id="vpc_eip_0002__p1388313292268">public_border_group</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.90720927907209%" headers="mcps1.3.4.2.1.2.2.4.1.2 "><p id="vpc_eip_0002__p118831329122611">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="36.046395360463954%" headers="mcps1.3.4.2.1.2.2.4.1.3 "><p id="vpc_eip_0002__p29889336324">Specifies whether it is in a central site or an edge site.</p>
|
|
<p id="vpc_eip_0002__p20127195053611">The value can be:</p>
|
|
<ul id="vpc_eip_0002__ul1660185933618"><li id="vpc_eip_0002__vpc_sharebandwidth_0001_li761175917369">center</li><li id="vpc_eip_0002__vpc_sharebandwidth_0001_li1761759193615"><em id="vpc_eip_0002__i332885354519">Edge site name</em></li></ul>
|
|
<p id="vpc_eip_0002__p65761507386">An EIP can only be bound to a resource of the same region.</p>
|
|
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="vpc_eip_0002__table66651219193417"></a><a name="table66651219193417"></a><table cellpadding="4" cellspacing="0" summary="" id="vpc_eip_0002__table66651219193417" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Description of the <strong id="vpc_eip_0002__b13169194715536">profile</strong> field</caption><thead align="left"><tr id="vpc_eip_0002__row167319197349"><th align="left" class="cellrowborder" valign="top" width="37.35%" id="mcps1.3.4.2.1.3.2.4.1.1"><p id="vpc_eip_0002__p206761195347"><strong id="vpc_eip_0002__b3371155162638">Name</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25.3%" id="mcps1.3.4.2.1.3.2.4.1.2"><p id="vpc_eip_0002__p156812193344">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="37.35%" id="mcps1.3.4.2.1.3.2.4.1.3"><p id="vpc_eip_0002__p17684101933410">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="vpc_eip_0002__row962259102216"><td class="cellrowborder" valign="top" width="37.35%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="vpc_eip_0002__p962309182220">order_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.3%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="vpc_eip_0002__p136231597223">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37.35%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="vpc_eip_0002__p26235912225">Specifies the order ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row18686141920341"><td class="cellrowborder" valign="top" width="37.35%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="vpc_eip_0002__p11688201923418">product_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.3%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="vpc_eip_0002__p169318196347">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37.35%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="vpc_eip_0002__p149921832153419">Specifies the product ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row167161319173418"><td class="cellrowborder" valign="top" width="37.35%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="vpc_eip_0002__p5718101903412">region_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.3%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="vpc_eip_0002__p47241019143417">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37.35%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="vpc_eip_0002__p09201951174716">Specifies the region ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="vpc_eip_0002__row1472971912347"><td class="cellrowborder" valign="top" width="37.35%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="vpc_eip_0002__p187311719103415">user_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.3%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="vpc_eip_0002__p9735141923418">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37.35%" headers="mcps1.3.4.2.1.3.2.4.1.3 "><p id="vpc_eip_0002__p09931918183013">Specifies the user ID.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<ul id="vpc_eip_0002__ul6007868294430"><li id="vpc_eip_0002__li383722794430">Example response<pre class="screen" id="vpc_eip_0002__screen4102504144219">{
|
|
"publicip": {
|
|
"id": "2ec9b78d-9368-46f3-8f29-d1a95622a568",
|
|
"status": "DOWN",
|
|
"alias": "tom",
|
|
"profile": {},
|
|
"type": "5_bgp",
|
|
"public_ip_address": "161.xx.xx.12",
|
|
"tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
|
|
"private_ip_address": "192.168.10.5",
|
|
"create_time": "2015-07-16 04:32:50",
|
|
"bandwidth_id": "49c8825b-bed9-46ff-9416-704b96d876a2",
|
|
"bandwidth_share_type": "PER",
|
|
"bandwidth_size": 10, //The EIP bandwidth size is 10 Mbit/s.
|
|
"bandwidth_name": "bandwidth-test",
|
|
"enterprise_project_id":"b261ac1f-2489-4bc7-b31b-c33c3346a439",
|
|
"ip_version": 4
|
|
}
|
|
}</pre>
|
|
</li></ul>
|
|
<div class="section" id="vpc_eip_0002__section31981619"><h4 class="sectiontitle">Status Code</h4><p id="vpc_eip_0002__p18112112662914">See <a href="vpc_api_0002.html">Status Codes</a>.</p>
|
|
</div>
|
|
<div class="section" id="vpc_eip_0002__section85821649202813"><h4 class="sectiontitle">Error Code</h4><p id="vpc_eip_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_eip_0000.html">EIP</a></div>
|
|
</div>
|
|
</div>
|
|
|