# 查询全域弹性公网IP段支持的掩码列表 - ListSupportMasks #### 功能介绍 查询全域弹性公网IP段支持的掩码列表。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/GEIP/doc?api=ListSupportMasks)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-eip/eip_apipermission_0000.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /v3/{domain_id}/global-eip-segments/support-masks 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | domain_id | 是 | String | - 租户账号ID，获取租户账号ID请参见[租户账号ID](https://support.huaweicloud.com/api-iam/iam_17_0002.html) 最小长度：**5** 最大长度：**32** | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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](https://support.huaweicloud.com/api-iam/iam_30_0001.html#iam_30_0001__li195948474711) | #### 响应参数 **状态码：200** 表4响应Header参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | X-Request-Id | String | 本次请求编号 | 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | request_id | String | 本次请求的编号 | | support_masks | Array of [ListSupportMasks] objects | 支持全域弹性公网IP段的掩码范围列表 | | page_info | [page_info] object | 分页页码信息 | 表6ListSupportMasks | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 全域弹性公网IP段支持的掩码的ID | | ip_version | Integer | IP版本信息，取值范围是4和6 | | mask | Integer | 掩码长度 | | created_at | String | 创建时间 | | updated_at | String | 更新时间 | 表7page_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** ``` { "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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-eip/ErrorCode.html)。