Help Center/ Elastic IP/ API Reference/ API V3/ Common Pools/ Querying EIP Pool Details
Updated on 2023-03-17 GMT+08:00

Querying EIP Pool Details

Function

This API is used to query EIP pool details.

URI

GET /v3/{project_id}/eip/publicip-pools/{publicip_pool_id}

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID.

Minimum length: 1

Maximum length: 32

publicip_pool_id

Yes

String

EIP pool ID, which uniquely identifies the EIP pool.

Minimum length: 36

Maximum length: 36

Table 2 Query parameter

Parameter

Mandatory

Type

Description

fields

No

String

  • Field. Format: "fields=id&fields=name&..."
  • Supported fields: id, name, size, used, project_id, status, billing_info, created_at, updated_at, type, shared, is_common, description, tags, enterprise_project_id, allow_share_bandwidth_types, and public_border_group.

Minimum length: 0

Maximum length: 1024

Request Parameter

Table 3 Request header parameter

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token. The token can be obtained by calling the IAM API used for obtaining a user token. The value of X-Subject-Token in the response header is the user token.

Minimum length: 0

Maximum length: 4096

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

publicip_pool

PublicipPoolShowResp object

EIP pool details.

request_id

String

Request ID.

Table 5 PublicipPoolShowResp

Parameter

Type

Description

id

String

  • EIP pool ID.

Minimum length: 1

Maximum length: 36

name

String

  • EIP pool name.

Minimum length: 0

Maximum length: 64

status

String

  • EIP pool status.

Minimum length: 0

Maximum length: 36

type

String

  • EIP pool type.
  • The value can be:
    • spec_bgp: Dynamic
    • spec_sbgp: Static

Enumerated values:

  • spec_bgp
  • spec_sbgp

description

String

  • Supplementary information about the EIP pool.

Minimum length: 0

Maximum length: 1024

project_id

String

  • Tenant ID.

Minimum length: 1

Maximum length: 36

size

Integer

  • EIP pool size.

Minimum value: 0

Maximum value: 999999

used

Integer

  • Number of used EIPs.

Minimum value: 0

Maximum value: 999999

created_at

String

  • Time when an EIP pool is assigned.

Minimum length: 0

Maximum length: 64

updated_at

String

  • Time when an EIP pool is updated.

Minimum length: 0

Maximum length: 64

billing_info

BillingInfoDict object

Order information, which is available only for yearly/monthly resources.

public_border_group

String

  • Whether the EIP pool is in a central region or an edge site. The value can be center.

Minimum length: 0

Maximum length: 64

shared

Boolean

  • Whether the EIP pool is shared.

is_common

Boolean

  • Whether the EIP pool is a common pool.

tags

Array of TagsInfo objects

  • User tag. (The parameter is not displayed by default.)

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

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

Table 6 BillingInfoDict

Parameter

Type

Description

order_id

String

  • Order information.

Minimum length: 0

Maximum length: 64

product_id

String

  • Product ID.

Minimum length: 0

Maximum length: 64

Table 7 TagsInfo

Parameter

Type

Description

key

String

  • Key. The tag key of a resource must be unique.

Minimum length: 0

Maximum length: 64

value

String

  • Values.

Minimum length: 0

Maximum length: 256

Example Request

None

Example Response

Status code: 200

Normal response to the GET operation

{
  "publicip_pool" : {
    "id" : "f588ccfa-8750-4d7c-bf5d-2ede24414706",
    "name" : "test_pool_xxx",
    "status" : "active",
    "shared" : true,
    "is_common" : false,
    "enterprise_project_id" : 0,
    "type" : "spec_bgp",
    "project_id" : "8b7e35ad379141fc9df3e178bd64f55c",
    "size" : 100,
    "used" : 20,
    "billing_info" : {
      "order_id" : "CS20081917179HW3H",
      "product_id" : "00301-335034-0--0"
    },
    "created_at" : "2020-07-17T09:25:53Z",
    "updated_at" : "2020-07-17T09:25:53Z",
    "description" : "test",
    "public_border_group" : "center",
    "allow_share_bandwidth_types" : [ "share" ]
  },
  "request_id" : "4a06c169-cc67-4d94-a786-2d70ef09b100"
}

Status Codes

See Status Codes.

Error Codes

See Error Codes.