文档首页> 全球加速 GA> API参考> API> IP地址组> 添加IP地址组中的IP网段
更新时间：2023-12-06 GMT+08:00
在线调试
CLI示例
查看PDF
分享

添加IP地址组中的IP网段

功能介绍

添加IP地址组中的IP网段。 该接口属于异步接口，接口返回后，后台的添加任务仍在执行；可以使用查询IP地址组详情接口查询状态，当IP地址组状态为ACTIVE时，表示条目添加完成。

调用方法

请参见如何调用API。

URI

POST /v1/ip-groups/{ip_group_id}/add-ips

表1 路径参数

参数

是否必选

参数类型

描述

ip_group_id

是

String

IP地址组ID。

最小长度：1

最大长度：36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

ip_list

是

Array of CreateIpGroupIpOption objects

IP地址组中的IP网段列表，一次最多支持添加20个条目。

数组长度：1 - 20
表4 CreateIpGroupIpOption

参数

是否必选

参数类型

描述

cidr

是

String

IP地址组中的IP网段，cidr格式。

最小长度：1

最大长度：50

description

否

String

IP地址组中的IP网段描述，取值范围：0~255个字符之间，禁止输入字符：<>。

最小长度：0

最大长度：255

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

请求示例

在IP地址组中添加IP网段127.0.0.0/24

POST https://{ga_endpoint}/v1/ip-groups/e8996cd6-28cf-4ff2-951e-fa8ac895a6cd/add-ips

{
  "ip_list" : [ {
    "cidr" : "127.0.0.0/24",
    "description" : "cidr description"
  } ]
}

响应示例

状态码： 200

操作成功

{
  "request_id" : "ac1bf54f-6a23-4074-af77-800648d25bc8"
}

状态码

状态码

描述

200

操作成功

错误码

请参见错误码。

父主题： IP地址组
分享：

    相关文档

    相关产品