sgode/virtual-private-cloud
1
0
Fork 0
forked from docs/virtual-private-cloud
Code Pull Requests Activity
virtual-private-cloud/api-ref/source/api_v3/eips/querying_eip_details.rst

163 KiB
Raw Blame History

original_name

ShowPublicipV3.html

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 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 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 3 Response body parameters
Parameter Type Description
request_id String

Request ID.

Minimum length: 0

Maximum length: 36
publicip PublicipSingleShowResp <showpublicipv3__en-us_topic_0000001542903925_en-us_topic_0000001405460350_response_publicipsingleshowresp> object EIP.
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 VnicInfo <showpublicipv3__en-us_topic_0000001542903925_en-us_topic_0000001405460350_response_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 PublicipBandwidthInfo <showpublicipv3__en-us_topic_0000001542903925_en-us_topic_0000001405460350_response_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 ProfileInfo <showpublicipv3__en-us_topic_0000001542903925_en-us_topic_0000001405460350_response_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.)
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
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
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 BandwidthInfoResp <showpublicipv3__en-us_topic_0000001542903925_en-us_topic_0000001405460350_response_bandwidthinforesp> object
  • Bandwidth bound to an EIP.
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

{
  "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 Status Codes <vpc_api_0002>.

Error Codes

See Error Codes <vpc_api_0003>.