Help Center/ Elastic IP/ API Reference/ API V3/ Common Pools/ Querying Common Pools

Updated on 2023-03-17 GMT+08:00

View PDF

Querying Common Pools

Function

This API is used to query common pools.

URI

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

**Table 1** Path parameter
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. Minimum length: 0 Maximum length: 32

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
fields	No	String	Field. Format: "fields=id&fields=name&.." Supported fields: id, name, status, type, used, allow_share_bandwidth_types, and public_border_group. Minimum length: 0 Maximum length: 1024
name	No	String	Common pool name. Minimum length: 0 Maximum length: 36
public_border_group	No	String	Whether the common pool is in a central region or an edge site. Minimum length: 0 Maximum length: 64

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
common_pools	Array of CommonPoolDict objects	Common pool.
request_id	String	Request ID.

**Table 5** CommonPoolDict
Parameter	Type	Description
name	String	Common pool name. Minimum length: 0 Maximum length: 36
status	String	Common pool status. Minimum length: 0 Maximum length: 36
type	String	Common pool type, such as bgp and sbgp. Minimum length: 0 Maximum length: 36
used	Integer	Number of used EIPs. Minimum value: 0 Maximum value: 99999
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
id	String	Common pool ID. The parameter is not displayed by default. 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

Example Request

None

Example Response

Status code: 200

Normal response to the GET operation

{
  "common_pools" : [ {
    "name" : "5_bgp",
    "status" : "active",
    "type" : "bgp",
    "used" : 99,
    "public_border_group" : "center",
    "allow_share_bandwidth_types" : [ "share" ]
  } ],
  "request_id" : "4a06c169-cc67-4d94-a786-2d70ef09b100"
}