# 更新规则过期时间 (/zh-CN/api-reference/api-ref/rtc/update-ban-expiration) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 更新指定封禁用户权限规则的过期时间。 - OpenAPI: /openapi/rtc/channel-management.zh-CN.yaml - Operation ID: put-dev-v1-kicking-rule - Method: PUT - Path: /dev/v1/kicking-rule - Endpoint: https://api.sd-rtn.com/dev/v1/kicking-rule ## Servers - https://api.sd-rtn.com ## Authorization This endpoint requires authentication. - `Basic Auth` ## Parameters - `Content-Type` (header, optional, string) - `application/json`。表示所有请求和响应内容的格式均为 JSON。 ## Request body - `appid` (string, required) - 项目的 App ID。可通过以下方式获取: - 从声网控制台获取。 - 调用[获取所有项目信息 API](/zh-CN/api-reference/api-ref/console/list-projects),并读取响应包体中 `vendor_key` 字段的值。 - `id` (number, required) - 规则 ID。 - `time` (number) - 封禁时间,单位为分钟,取值范围为 [1,1440]。 **注意:** - 当设置的值在 `0` 到 `1` 之间时,服务端自动改设为 `1`。 - 当设置的值大于 `1440` 时,服务端自动改设为 `1440`。 - `time` 和 `time_in_seconds` 两个参数只需设置其中的一个。如果同时设置,则 `time_in_seconds` 生效;如果都不设置,服务端会自动将封禁时间设为 60 分钟,即 3600 秒。 - `time_in_seconds` (number) - 封禁时间,单位为秒,取值范围为 [10,86430]。 **注意:** - 当设置的值在 `0` 到 `10` 之间,服务端自动改设为 `10`。 - 当设置的值大于 `86430` 时,服务端自动改设为 `86430`。 - `time` 和 `time_in_seconds` 两个参数只需设置其中的一个。如果同时设置,则 `time_in_seconds` 生效;如果都不设置,服务端会自动将封禁时间设为 60 分钟,即 3600 秒。 ### Request body example ```json { "appid": "4855xxxxxxxxxxxxxxxxxxxxxxxxeae2", "id": 1953, "time": 60 } ``` ## Responses ### 200 如果状态码为 200,则请求成功。 - `status` (string) - 本次请求的状态。`success` 表示请求成功。 - `result` (object) - 请求结果。 - `result.id` (number) - 规则 ID。 - `result.ts` (string) - 该规则的过期时间(UTC 时间)。 ### 非 200 如果状态码不为 200,则请求失败。你可以参考[响应状态码](/zh-CN/realtime-media/rtc/reference/response-code)排查问题。 No schema. ## Response examples ### 200 ```json { "status": "success", "result": { "id": 1953, "ts": "2018-01-09T08:45:54.545Z" } } ```