文档首页/ 弹性公网IP EIP/ API参考/ API V3/ 公共池/ 查询公网IP池详情
更新时间：2025-02-08 GMT+08:00
查看PDF
分享

查询公网IP池详情

功能介绍

查询公网IP池详情

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

最小长度：1

最大长度：32

publicip_pool_id

是

String

公网IP池ID唯一标识

最小长度：36

最大长度：36
表2 Query参数

参数

是否必选

参数类型

描述

fields

否

String
  • 功能说明：查询字段，形式为"fields=id&fields=name&..."
  • 支持字段：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/public_border_group

最小长度：0

最大长度：1024

请求参数

无

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

publicip_pool

PublicipPoolShowResp object

公网IP池详情

request_id

String

本次请求的编号
表4 PublicipPoolShowResp

参数

参数类型

描述

id

String
  • 功能说明：公网IP池id

最小长度：1

最大长度：36

name

String
  • 功能说明：公网IP池名字

最小长度：0

最大长度：64

status

String
  • 功能说明：公网IP池状态

最小长度：0

最大长度：36

type

String
  • 功能说明：类型
  • 取值范围：
    • spec_bgp：专属离散动态
    • spec_sbgp：专属离散静态

枚举值：

  • spec_bgp
  • spec_sbgp

description

String
  • 功能说明：描述

最小长度：0

最大长度：1024

project_id

String
  • 功能说明：租户id

最小长度：1

最大长度：36

size

Integer
  • 功能说明：池子大小

最小值：0

最大值：999999

used

Integer
  • 功能说明：已经使用的ip数量

最小值：0

最大值：999999

created_at

String
  • 功能说明：公网IP池创建时间

最小长度：0

最大长度：64

updated_at

String
  • 功能说明：公网IP池更新时间

最小长度：0

最大长度：64

billing_info

BillingInfoDict object

订单信息, 有订单表示包周期

public_border_group

String
  • 功能说明：中心还是边缘。公网IP池取值为center

最小长度：0

最大长度：64

shared

Boolean
  • 功能说明：是否共享

is_common

Boolean
  • 功能说明：是否公共池

tags

Array of TagsInfo objects
  • 功能说明：用户标签。（默认不显示）

enterprise_project_id

String
  • 功能说明：企业项目ID。最大长度36字节,带“-”连字符的UUID格式,或者是字符串“0”。创建弹性公网IP时,给弹性公网IP绑定企业项目ID。

最小长度：0

最大长度：36

allow_share_bandwidth_types

Array of strings
  • 功能说明：表示此publicip可以加入的共享带宽类型列表，如果为空列表，则表示该 publicip不能加入任何共享带宽
  • 约束：publicip只能加入到有该带宽类型的共享带宽中

最大长度：64
表5 BillingInfoDict

参数

参数类型

描述

order_id

String
  • 功能说明：订单信息

最小长度：0

最大长度：64

product_id

String
  • 功能说明：产品id

最小长度：0

最大长度：64
表6 TagsInfo

参数

参数类型

描述

key

String
  • 功能说明：键。同一资源的key值不能重复。

最小长度：0

最大长度：64

value

String
  • 功能说明：值列表。

最小长度：0

最大长度：256

请求示例

无

响应示例

状态码： 200

Get操作正常返回

{
  "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"
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 公共池