调用SetAuditSecurityIp设置审核安全IP。
使用说明
当视频状态为审核中(Checking)或屏蔽(Blocked)状态时,只有来自审核安全IP的请求才可以播放。
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SetAuditSecurityIp |
系统规定参数。取值:SetAuditSecurityIp。 |
SecurityGroupName | String | 否 | Default |
审核安全组名称。默认值为:Default。最多支持10个安全分组。 |
Ips | String | 是 | 192.168.0.1 |
审核安全IP列表。每个分组最多支持100个,多个IP使用英文逗号(,)隔开,格式如下:
|
OperateMode | String | 否 | Cover |
操作方式,取值范围:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 25818875-5F78-4AF6-D7393642CA58**** |
请求ID。 |
示例
请求示例
http(s)://vod.cn-shanghai.aliyuncs.com/?Action=SetAuditSecurityIp
&SecurityGroupName=Default
&Ips=192.168.0.1
&OperateMode=Cover
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SetAuditSecurityIpResponse>
<RequestId>25818875-5F78-4AF6-D7393642CA58****</RequestId>
</SetAuditSecurityIpResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "25818875-5F78-4AF6-D7393642CA58****"
}
错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
错误代码 | 错误信息 | HTTP状态码 | 说明 |
---|---|---|---|
IpsIsEmpty | The specified “Ips” can not be empty. | 400 | Ips不允许为空。 |
IpsExceededMax | The specified Ips count has exceeded 100. | 403 | 添加的IP个数超过限制,每个分组最多支持100个。 |
SecurityIpGroupExceededMax | The audit security group count has exceeded 10. | 403 | 审核安全IP分组个数超过限制。 |
SDK示例
建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见: