文档首页/ 弹性公网IP EIP/ API参考/ API V3/ 公共池/ 查询公网IP池类型 - ShowPublicipPoolTypes
更新时间:2025-11-20 GMT+08:00
分享

查询公网IP池类型 - ShowPublicipPoolTypes

功能介绍

查询公网IP池类型

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v3/{project_id}/eip/publicip-pool-types

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取项目ID请参见获取项目ID

最大长度:32

表2 Query参数

参数

是否必选

参数类型

描述

marker

String

  • 功能说明:分页查询起始的资源ID,为空时为查询第一页

最小长度:0

最大长度:36

limit

Integer

  • 功能说明:每页返回的资源个数

  • 取值范围:1~2000

最小值:0

最大值:2000

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

sort_key

String

  • 功能说明:排序字段,形式为“sort_key=id&sort_dir=asc”

  • 支持字段:id/name/created_at/updated_at/public_border_group

最小长度:0

最大长度:36

sort_dir

String

  • 功能说明:排序方向

  • 取值范围:

    • asc 顺序

    • desc 倒序

最小长度:0

最大长度:16

id

String

  • 功能说明:根据id过滤

最小长度:0

最大长度:36

name

String

  • 功能说明:根据name过滤

最小长度:0

最大长度:64

size

Integer

  • 功能说明:根据size过滤

最小值:0

最大值:999999

status

String

  • 功能说明:根据status过滤

最小长度:0

最大长度:36

type

String

  • 功能说明:根据type过滤

最小长度:0

最大长度:36

description

String

  • 功能说明:根据description过滤

最小长度:0

最大长度:255

public_border_group

String

  • 功能说明:根据public_border_group过滤

最小长度:0

最大长度:64

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

publicip-pool-types

PublicPoolType object

  • 功能说明:公网IP池类型对象

表4 PublicPoolType

参数

参数类型

描述

id

String

  • 功能说明:弹性公网IP池类型id

type

String

  • 功能说明:弹性公网IP池类型

请求示例

查询公网IP池类型

GET https://{Endpoint}/v3/{project_id}/eip/publicip-pools-types

响应示例

状态码:200

Get操作正常返回

{
  "publicip-pool-types" : [ {
    "id" : "3e10d228-d4c8-4319-8ae3-4e881db084b2",
    "type" : "spec_bgp"
  } ],
  "request_id" : "4a06c169-cc67-4d94-a786-2d70ef09b100"
}

状态码

状态码

描述

200

Get操作正常返回

错误码

请参见错误码

相关文档