PUT `/admin/mfa/ip-whitelist/{ip_whitelist_id}`

更新指定IP白名单规则的标签、CIDR或启用状态。需要管理员权限。

多因素认证 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`ip_whitelist_id`	`path`	`string`	是				实体ID

请求体

Schema： service-mfa/internal/handler/dto.UpdateIPWhitelistRequest

字段	类型	必填	示例	约束	描述
`cidr`	`string`	否
`enabled`	`boolean`	否
`label`	`string`	否

响应

状态	描述	Schema
200	更新成功	`service-mfa/internal/handler/dto.IPWhitelistDetailResponse`
400	参数错误	`service-core/base/dto.SimpleResponse`
401	未认证	`service-core/base/dto.SimpleResponse`
403	权限不足	`service-core/base/dto.SimpleResponse`
404	未找到	`service-core/base/dto.SimpleResponse`
500	服务器内部错误	`service-core/base/dto.SimpleResponse`

引用的 Schema

service-core/base/dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-mfa/internal/handler/dto.IPWhitelistDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-mfa/internal/handler/dto.IPWhitelistResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-mfa/internal/handler/dto.IPWhitelistResponse

字段	类型	必填	示例	约束	描述
`cidr`	`string`	否	`192.168.1.0/24`
`created_at`	`string`	否	`2026-05-15T08:00:00Z`
`enabled`	`boolean`	否	`True`
`id`	`string`	否	`wl_abc123`
`label`	`string`	否	`office network`
`tenant_id`	`string`	否	`tnt_001`

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓