:original_name: ShowPublicipV3.html .. _ShowPublicipV3: Querying EIP Details ==================== Function -------- This API is used to query EIP details. (This API is not supported in **eu-nl**.) URI --- GET /v3/{project_id}/eip/publicips/{publicip_id} .. table:: **Table 1** Path parameters +-----------------+-----------------+-----------------+------------------------+ | Parameter | Mandatory | Type | Description | +=================+=================+=================+========================+ | project_id | Yes | String | Project ID. | | | | | | | | | | Minimum length: **0** | | | | | | | | | | Maximum length: **32** | +-----------------+-----------------+-----------------+------------------------+ | publicip_id | Yes | String | EIP ID. | | | | | | | | | | Minimum length: **0** | | | | | | | | | | Maximum length: **36** | +-----------------+-----------------+-----------------+------------------------+ .. table:: **Table 2** Query parameter +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=================+=================+=================+=======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ | fields | No | Array | - Field. Format: "fields=id&fields=owner&..." | | | | | - Supported fields: **id**, **project_id**, **ip_version**, **type**, **public_ip_address**, **public_ipv6_address**, **network_type**, **status**, **description**, **created_at**, **updated_at**, **vnic**, **bandwidth**, **associate_instance_type**, **associate_instance_id**, **lock_status**, **billing_info**, **tags**, **enterprise_project_id**, **publicip_pool_name**, **allow_share_bandwidth_types**, **alias**, **publicip_pool_id**, and **public_border_group**. | +-----------------+-----------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ Request Parameter ----------------- None Response Parameters ------------------- **Status code: 200** .. table:: **Table 3** Response body parameters +-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ | Parameter | Type | Description | +=======================+==================================================================================================================================================+========================+ | request_id | String | Request ID. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ | publicip | :ref:`PublicipSingleShowResp ` object | EIP. | +-----------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+------------------------+ .. _showpublicipv3__en-us_topic_0000001542903925_en-us_topic_0000001405460350_response_publicipsingleshowresp: .. table:: **Table 4** PublicipSingleShowResp +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Type | Description | +=============================+================================================================================================================================================+============================================================================================================================================================================================================================================================================================================+ | id | String | - Unique ID of the EIP. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | project_id | String | - Project ID. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **32** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | ip_version | Integer | - IP address version. | | | | - The value can be: | | | | | | | | - **4**: IPv4 EIP | | | | - **6**: IPv6 EIP | | | | | | | | Enumerated values: | | | | | | | | - **4** | | | | - **6** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | public_ip_address | String | - EIP or IPv6 port address. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | public_ipv6_address | String | - Obtained EIP if IPv6 EIPs are available. This parameter does not exist if only IPv4 EIPs are available. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | network_type | String | - Network type of an EIP. This parameter is discarded and is not displayed by default. It is inherited by **publicip_pool_name**. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | status | String | - EIP status. | | | | - The value can be: | | | | | | | | - **FREEZED** (Frozen) | | | | - **BIND_ERROR** (Binding failed) | | | | - **BINDING** (Binding) | | | | - **PENDING_DELETE** (Releasing) | | | | - **PENDING_CREATE** (Assigning) | | | | - **NOTIFYING** | | | | - **NOTIFY_DELETE** | | | | - **PENDING_UPDATE** (Updating) | | | | - **DOWN** (Unbound) | | | | - **ACTIVE** (Bound) | | | | - **ELB** (Bound to a load balancer) | | | | - **VPN** (Bound to a VPN) | | | | - **ERROR** | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | | | | | | | | Enumerated values: | | | | | | | | - **FREEZED** | | | | - **BIND_ERROR** | | | | - **BINDING** | | | | - **PENDING_DELETE** | | | | - **PENDING_CREATE** | | | | - **NOTIFYING** | | | | - **NOTIFY_DELETE** | | | | - **PENDING_UPDATE** | | | | - **DOWN** | | | | - **ACTIVE** | | | | - **ELB** | | | | - **VPN** | | | | - **ERROR** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | description | String | - Supplementary information about the EIP. | | | | - This is customized by users and is not perceived by the system. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **256** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | public_border_group | String | - Whether the resource is in a central region or an edge site. | | | | - The value can be **center** or an edge site name. | | | | - This resource can only be associated with an EIP of the same region. | | | | | | | | Minimum length: **1** | | | | | | | | Maximum length: **64** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | created_at | String | - Time (UTC) when an EIP is assigned. | | | | - Format: *yyyy-MM-ddTHH:mm:ssZ* | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | updated_at | String | - Time (UTC) when an EIP is updated. | | | | - Format: *yyyy-MM-ddTHH:mm:ssZ* | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | type | String | - EIP type. | | | | | | | | Minimum length: **1** | | | | | | | | Maximum length: **36** | | | | | | | | Enumerated values: | | | | | | | | - **EIP** | | | | - **DUALSTACK** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | vnic | :ref:`VnicInfo ` object | - Port information of the instance with an EIP bound. | | | | - If the instance with an EIP bound does not depend on a port, the value is **null**. | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | bandwidth | :ref:`PublicipBandwidthInfo ` object | Bandwidth bound to an EIP. | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | enterprise_project_id | String | Enterprise project ID. The value is **0** or a string that contains a maximum of 36 characters in UUID format with hyphens (-). This is the ID of the enterprise project that you associate with the EIP when you assign the EIP. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | billing_info | String | - Order information of an EIP. | | | | - This parameter is left empty for pay-per-use resources. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **256** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | lock_status | String | - Frozen status of an EIP. | | | | - The metadata type indicates that the EIP is frozen due to arrears or abuse. | | | | - The value can be: | | | | | | | | - **police** | | | | - **locked** | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | associate_instance_type | String | - Type of the instance bound with an EIP. | | | | - The value can be: | | | | | | | | - **PORT** | | | | - **NATGW** | | | | - **ELB** | | | | - **ELBV1** | | | | - **VPN** | | | | - **null** | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | | | | | | | | Enumerated values: | | | | | | | | - **PORT** | | | | - **NATGW** | | | | - **ELB** | | | | - **ELBV1** | | | | - **VPN** | | | | - **null** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | associate_instance_id | String | - ID of the instance bound with an EIP. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | publicip_pool_id | String | - ID of the network that an EIP belongs to. It is the network ID corresponding to **publicip_pool_name**. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | publicip_pool_name | String | - Network type of an EIP, including public EIP pool (for example, **5_bgp** or **5_sbgp**) and dedicated EIP pool. | | | | - For details about the dedicated EIP pool, see the APIs about **publcip_pool**. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | alias | String | - EIP name. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | profile | :ref:`ProfileInfo ` object | - EIP and metadata. (The parameter is not displayed by default.) | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | fake_network_type | Boolean | - Whether an EIP can change its BGP type. If the value is **true**, the EIP can change its BGP type. If the value is **false**, the EIP cannot change its BGP type. (The parameter is not displayed by default.) | | | | | | | | Enumerated values: | | | | | | | | - **true** | | | | - **false** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | tags | Array of strings | - User tag. (The parameter is not displayed by default.) | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | associate_instance_metadata | String | - Record the upper-level ownership of an instance. For example, if **associate_instance_type** is set to **PORT**, this parameter records the **device_id** and **device_owner** information of the port. (This parameter only records information in limited scenarios and is not displayed by default.) | | | | | | | | Minimum length: **1** | | | | | | | | Maximum length: **64** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | associate_mode | String | - Passthrough mode. The parameter is displayed only after the passthrough mode is enabled. | | | | | | | | Minimum length: **1** | | | | | | | | Maximum length: **36** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | allow_share_bandwidth_types | Array of strings | - Types of the shared bandwidth that an EIP can be added to. If this parameter is left blank, the EIP cannot be added to any shared bandwidth. | | | | - The EIP can be added only to the shared bandwidth of these types. | | | | | | | | Maximum length: **64** | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | cascade_delete_by_instance | Boolean | - Whether an EIP can be released together with its instance. (The parameter is not displayed by default.) | +-----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _showpublicipv3__en-us_topic_0000001542903925_en-us_topic_0000001405460350_response_vnicinfo: .. table:: **Table 5** VnicInfo +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | Parameter | Type | Description | +=======================+=======================+===============================================================================+ | private_ip_address | String | - Private IP address. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | device_id | String | - ID of the device that a port belongs to. | | | | - The system automatically sets this parameter. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | device_owner | String | - Device that the port belongs to. | | | | - The value can be: | | | | | | | | - **network:dhcp** | | | | - **network:VIP_PORT** | | | | - **network:router_interface_distributed** | | | | - **network:router_centralized_snat** | | | | | | | | - The system automatically sets this parameter. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | vpc_id | String | - VPC ID. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | port_id | String | - Port ID. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | port_profile | String | - Port profile. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **256** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | mac | String | - Port MAC address. | | | | - The system automatically sets this parameter. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | vtep | String | - VTEP IP address. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | vni | String | - VXLAN ID. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | instance_id | String | - ID of the instance that the port belongs to, for example, RDS instance ID. | | | | - The system automatically sets this parameter. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ | instance_type | String | - Type of the instance that the port belongs to, for example, RDS. | | | | - The system automatically sets this parameter. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+-------------------------------------------------------------------------------+ .. _showpublicipv3__en-us_topic_0000001542903925_en-us_topic_0000001405460350_response_publicipbandwidthinfo: .. table:: **Table 6** PublicipBandwidthInfo +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------+ | Parameter | Type | Description | +=======================+=======================+========================================================================================================================+ | id | String | - Bandwidth ID. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------+ | size | Integer | - Bandwidth size. | | | | - The value ranges from 5 Mbit/s to 2000 Mbit/s by default. | | | | | | | | Minimum value: **0** | | | | | | | | Maximum value: **99999** | +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------+ | share_type | String | - Whether the bandwidth is shared or dedicated. | | | | - The value can be: | | | | | | | | - **PER**: Dedicated bandwidth | | | | - **WHOLE**: Shared bandwidth | | | | | | | | - IPv6 addresses do not support bandwidth whose type is **WHOLE**. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------+ | charge_mode | String | - Whether the billing is based on traffic or bandwidth. | | | | - The value can be: | | | | | | | | - **bandwidth**: billed by bandwidth | | | | - **traffic**: billed by traffic | | | | - **95peak_plus**: billed by 95th percentile bandwidth (enhanced) | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------+ | name | String | - Bandwidth name. | | | | - The value can contain 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and periods (.). | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------+ | billing_info | String | - Billing information. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **256** | +-----------------------+-----------------------+------------------------------------------------------------------------------------------------------------------------+ .. _showpublicipv3__en-us_topic_0000001542903925_en-us_topic_0000001405460350_response_profileinfo: .. table:: **Table 7** ProfileInfo +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Type | Description | +=======================+========================================================================================================================================+===================================================================================================================================================================================+ | local_network_port | String | - **port_id** in the **5**\ *\_xxx* network (for example, **5_bgp**) of an EIP. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | standalone | Boolean | - Whether an EIP is assigned together with a VM. If the value is **true**, the EIP is assigned independently. If the value is **false**, the EIP is assigned together with a VM. | +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | notify_status | String | - EIP assigning status. This parameter is only for internal use of the EIP service. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | | | | | | | | Enumerated values: | | | | | | | | - **PENDING_CREATE** | | | | - **PENDING_UPDATE** | | | | - **NOTIFYING** | | | | - **NOTIFYED** | | | | - **NOTIFY_DELETE** | +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | create_time | String | - Time when an EIP is assigned. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **64** | +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | fake_network_type | Boolean | - Whether an EIP can change its BGP type. If the value is **true**, the EIP can change its BGP type. If the value is **false**, the EIP cannot change its BGP type. | | | | | | | | Enumerated values: | | | | | | | | - **true** | | | | - **false** | +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | create_source | String | - Type of the resource purchased together with an EIP. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | | | | | | | | Enumerated value: | | | | | | | | - **ecs** | +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | ecs_id | String | - ID of the ECS purchased together with an EIP. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | lock_status | String | - Lock status of an EIP, for example, **POLICE** (abuse), **LOCKED** (common issues), **ARREAR** (in arrears), and **DELABLE** (can be deleted). | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | freezed_status | String | - EIP frozen status. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | | | | | | | | Enumerated values: | | | | | | | | - **FREEZED** | | | | - **UNFREEZED** | +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | bandwith_info | :ref:`BandwidthInfoResp ` object | - Bandwidth bound to an EIP. | +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _showpublicipv3__en-us_topic_0000001542903925_en-us_topic_0000001405460350_response_bandwidthinforesp: .. table:: **Table 8** BandwidthInfoResp +-----------------------+-----------------------+-----------------------------+ | Parameter | Type | Description | +=======================+=======================+=============================+ | bandwidth_name | String | - Bandwidth name. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **256** | +-----------------------+-----------------------+-----------------------------+ | bandwidth_number | Integer | - Bandwidth size (Mbit/s). | | | | | | | | Minimum value: **0** | | | | | | | | Maximum value: **99999** | +-----------------------+-----------------------+-----------------------------+ | bandwidth_type | String | - Bandwidth type. | | | | | | | | Enumerated values: | | | | | | | | - **PER** | | | | - **WHOLE** | +-----------------------+-----------------------+-----------------------------+ | bandwidth_id | String | - Bandwidth ID. | | | | | | | | Minimum length: **0** | | | | | | | | Maximum length: **36** | +-----------------------+-----------------------+-----------------------------+ Example Request --------------- None Example Response ---------------- **Status code: 200** Normal response to the GET operation .. code-block:: { "publicip" : { "created_at" : "2022-03-17T09:46:22Z", "updated_at" : "2022-03-30T02:46:04Z", "lock_status" : null, "allow_share_bandwidth_types" : [ "bgp", "sbgp", "share", "share_yidongdanxian", "share_youxuan" ], "id" : "006343a1-32bf-4361-958a-efd158153dd0", "alias" : null, "project_id" : "060576787a80d5762fa2c00f07ddfcf4", "ip_version" : 4, "public_ip_address" : "88.88.1.141", "public_ipv6_address" : null, "status" : "DOWN", "description" : "", "enterprise_project_id" : "0", "billing_info" : null, "type" : "EIP", "vnic" : { "private_ip_address" : "172.16.1.235", "device_id" : "", "device_owner" : "", "vpc_id" : "1c30f428-9741-48b2-a788-0b2f359705eb", "port_id" : "22d3576d-c042-4f3d-8c7c-1330a2724627", "mac" : "fa:16:3e:3a:22:66", "vtep" : null, "vni" : null, "instance_id" : "", "instance_type" : "", "port_profile" : null }, "bandwidth" : { "id" : "149ff19b-5de4-4436-958f-2eca39952e93", "size" : 100, "share_type" : "PER", "charge_mode" : "traffic", "name" : "bandwidth-xym-br-eqos", "billing_info" : "" }, "associate_instance_type" : "PORT", "associate_instance_id" : "22d3576d-c042-4f3d-8c7c-1330a2724627", "publicip_pool_id" : "9af5f2e5-1765-4b86-b342-ece52e785c8b", "publicip_pool_name" : "5_union", "public_border_group" : "center", "tags" : [ "key=value" ] }, "request_id" : "ce1a33a85d2e105040497a21bbe58c26" } Status Codes ------------ See :ref:`Status Codes `. Error Codes ----------- See :ref:`Error Codes `.