文档首页/ 弹性公网IP EIP/ API参考/ GEIP API/ 掩码限制/ 查询全域弹性公网IP段支持的掩码列表 - ListSupportMasks
更新时间：2025-10-24 GMT+08:00
查看PDF
分享

查询全域弹性公网IP段支持的掩码列表 - ListSupportMasks

功能介绍

查询全域弹性公网IP段支持的掩码列表

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

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

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

URI

GET /v3/{domain_id}/global-eip-segments/support-masks

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

最小长度：5

最大长度：32
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

每页条数

最小值：0

最大值：2000

offset

否

Integer

分页查询起始的资源序号

marker

否

String

  • 功能说明：上一页最后一条记录的ID

  • 使用说明：

    • 必须与limit一起使用

    • 输入的值必须为有效的ID值

page_reverse

否

Boolean

  • 功能说明：翻页方向

  • 取值：

    • true：查询上一页

    • false：查询下一页

fields

否

Array of strings

  • 功能说明：查询指定的字段，格式为fields=A&fields=B&fields=C&......

  • 支持的字段：

    • id

    • ip_version

    • mask

    • created_at

    • updated_at

sort_key

否

Array of strings

按照sort_key指定的字段排序

sort_dir

否

Array of strings

  • 功能说明：排序方向

  • 取值范围：asc（升序）、desc（降序）

id

否

Array of strings

根据ID过滤，支持多值查询，查询条件格式：id=xxx&id=xxx。

ip_version

否

Array of integers

根据IP版本过滤

mask

否

Array of integers

根据掩码过滤

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户的Token，如何获取用户Token请参见获取用户Token

响应参数

状态码：200

表4 响应Header参数

参数

参数类型

描述

X-Request-Id

String

本次请求编号
表5 响应Body参数

参数

参数类型

描述

request_id

String

本次请求的编号

support_masks

Array of ListSupportMasks objects

支持全域弹性公网IP段的掩码范围列表

page_info

page_info object

分页页码信息
表6 ListSupportMasks

参数

参数类型

描述

id

String

全域弹性公网IP段支持的掩码的ID

ip_version

Integer

IP版本信息，取值范围是4和6

mask

Integer

掩码长度

created_at

String

创建时间

updated_at

String

更新时间
表7 page_info

参数

参数类型

描述

next_marker

String

翻页时，作为后一页的marker取值

previous_marker

String

翻页时，作为前一页的marker取值

current_count

Integer

当前页的数据总数

请求示例

查询全域弹性公网IP段支持的掩码列表

GET https://{Endpoint}/v3/{domain_id}/global-eip-segments/support-masks

响应示例

状态码：200

OK

{
  "request_id" : "d224afc0e7add65c715707dbadd3004a",
  "support_masks" : [ {
    "created_at" : "2023-08-08T02:01:28Z",
    "updated_at" : "2023-08-08T02:01:28Z",
    "id" : "13d076eb-925f-49d5-a95a-8cbb4a27b736",
    "ip_version" : 4,
    "mask" : 26
  }, {
    "created_at" : "2023-08-10T03:31:30Z",
    "updated_at" : "2023-08-10T03:31:30Z",
    "id" : "816b91a8-076e-4a21-b3b7-473cda4c77e9",
    "ip_version" : 6,
    "mask" : 126
  } ],
  "page_info" : {
    "previous_marker" : "d224afc0e7add65c715707dbadd3004a",
    "current_count" : 2
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 掩码限制

相关文档