BlockObject - URL封禁

更新时间: 2024-12-26 16:45:05

对指定URL禁止访问。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
SiteIdlong

站点 ID,可通过调用 ListSites 接口获取。

123456****
Typestring

类型,取值:

  • block:封禁。
  • unblock:解封。
block
Contentarray

封禁内容。

string

URL。

http://a.com/1.jpg
Maxageinteger

拦截生效时间(单位为秒,当类型为封禁时指定)。

864000
Extensionstring

延长封禁时长,取值为 2year(封禁时长为两年)。

2year

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

0AEDAF20-4DDF-4165-8750-47FF9C1929C9
TaskIdstring

任务 ID,当您创建封禁任务时,会返回任务 ID。

15940956620

示例

正常返回示例

JSON格式

{
  "RequestId": "0AEDAF20-4DDF-4165-8750-47FF9C1929C9",
  "TaskId": "15940956620"
}

错误码

HTTP status code错误码错误信息描述
400MissingTimeParameterThe StartTime and EndTime must be both specified.请同时提供开始时间和结束时间。
400InvalidEndTime.MismatchThe specified EndTime is earlier than the StartTime.您填入的结束时间早于开始时间,请检查后重试。
400DomainNameOverLimitA maximum of 500 domains are supported for each request.一次最多只支持500个域名,请减少域名重新请求。
400InvalidTimeThe query time cannot exceed the last 3 days.查询时间不能超过最近3天。
400MissingParameter.ObjectTypeThe ObjectType parameter is required if DomainName or ObjectType is specified.请填写ObjectType参数。
400InvalidStationParameterThe specified Station is invalid.指定的节点参数无效。
400TooManyRequestsToo many requests.Please try again later.请求过于频繁,请稍后重试。
400InvalidTaskId.MalformedThe specified taskId is invalid.指定的任务ID无效。
400InvalidParameters.InvalidUrlsThe specified urls are invalid.请求的URL参数无效。
400InvalidParametersThe specified parameters are invalid.参数非法。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-09-24OpenAPI 错误码发生变更查看变更详情
上一篇: 内容封禁 下一篇: SSL/TLS