最近更新时间:2024.02.29 19:30:26
首次发布时间:2023.04.12 10:53:08
如果你已经封禁某房间或用户,你可以使用 UpdateBanRoomUserRule
更新已设置的封禁规则。
你可以调用 UpdateBanRoomUserRule
接口,覆盖此前在 BanRoomUser
中设定的ForbiddenInterval
参数,对封禁时长进行更新。
在使用 UpdateBanRoomUserRule
前,你必须已经使用 BanRoomUser
对房间或用户进行了封禁。
关于调用接口的请求结构、公共参数、签名算法和返回结构,参看调用方法。
请求频率:QPS 不得超过 20。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数名称 | 数据类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateBanRoomUserRule | 接口名称。当前 API 的名称为 UpdateBanRoomUserRule 。 |
Version | String | 是 | 2020-12-01 | 接口版本。当前 API 的版本为 2020-12-01 。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
AppId | String | 是 | Your_AppId | 你的音视频应用的唯一标志 |
RoomId | String | 是 | Your_RoomId | 指定房间 ID |
UserId | String | 否 | Your_UserId | 希望封禁用户的 ID |
ForbiddenInterval | Integer | 否 | 0 | 封禁时长,单位为秒,取值范围为 [60,259290] 。若传入值为空或 0 表示允许用户重新进房。若传入值大于 0 ,且小于60 ,自动修改为60 。若传入值大于 259290 ,自动修改为259290 。 |
下表仅列出本接口特有的返回参数,公共返回参数请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
message | String | success |
POST https://rtc.volcengineapi.com?Action=UpdateBanRoomUserRule&Version=2020-12-01 { "AppId": "Your_AppId", "RoomId": "Your_RoomId", "UserId": "Your_UserId", "ForbiddenInterval": 0 }
{ "ResponseMetadata": { "RequestId": "Your_RequestId", "Action": "UpdateBanRoomUserRule", "Version": "2020-12-01", "Service": "rtc", "Region": "cn-north-1" }, "Result": { "message": "success" } }
您可访问公共错误码,获取更多错误码信息。