PUT `/billing/alerts/{alert_id}`

修改已有用量告警规则的阈值、通知渠道或状态。支持部分更新，未传递的字段保持原值。

计费服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`alert_id`	`path`	`string`	是				告警ID

请求体

Schema： service-billing/internal/handler/dto.UpdateUsageAlertRequest

字段	类型	必填	示例	约束	描述
`name`	`string`	否
`notification_channels`	`string`	否
`resource_type`	`string`	否
`status`	`string`	否
`threshold_percent`	`integer`	否

响应

状态	描述	Schema
200	用量告警更新成功	`service-billing/internal/handler/dto.UsageAlertDetailResponse`
400	请求参数错误	`object`
401	未授权	`object`
404	告警不存在	`object`
500	服务器内部错误	`object`

引用的 Schema

service-billing/internal/handler/dto.UsageAlertDetailResponse

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

service-billing/internal/handler/dto.UsageAlertResponse

字段	类型	必填	示例	约束	描述
`app_id`	`string`	否	`app_001`
`created_at`	`string`	否	`2026-05-01T00:00:00Z`
`id`	`string`	否	`ua_001`
`last_triggered_at`	`string`	否	`2026-05-10T08:00:00Z`
`name`	`string`	否	`API调用量告警`
`notification_channels`	`string`	否	`email,in_app`
`resource_type`	`string`	否	`api_calls`
`status`	`string`	否	`active`
`tenant_id`	`string`	否	`tnt_xyz789`
`threshold_percent`	`integer`	否	`80`
`updated_at`	`string`	否	`2026-05-05T10:00:00Z`

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