---
title: "创建IP组"
method: POST
path: "/api/v1/ip-groups"
tags: ["IP组管理"]
---

# 创建IP组

`POST /api/v1/ip-groups`

创建一个新的IP地址组，用于后续IP规则匹配

## Request body

- DtoIPGroupCreateRequest — 创建IP组的请求参数
  - `items` string[], required — IP地址或CIDR列表
  - `name` string, required — IP组名称

## Response `200`

IP组创建成功

- object — 成功的API响应标准格式
  - `code` integer
  - `data` ModelIPGroup — IP地址组信息，包含组名和IP地址列表
    - `id` string — 组唯一标识符
    - `items` string[] — IP地址或CIDR列表
    - `name` string — 组名称
  - `message` string
  - `requestId` string
  - `success` boolean
  - `timestamp` string

## Other responses

- `400` — 请求参数错误
- `401` — 未授权访问
- `403` — 禁止访问
- `409` — IP组名称已存在
- `500` — 服务器内部错误

---

[API](https://skmtc.net/labring/apis/ruiqi-waf-api.md) · [All operations](https://skmtc.net/labring/apis/ruiqi-waf-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/labring/ruiqi-waf-api/versions/aaacd7e06a88/schema)