禁止单路直播流推送（ForbidStream）

接口描述

• 功能1：封禁单路直播流
• 功能2：断开单路直播流，且支持立即重新推流
• 接口请求频率限制：200次/秒
• 调用方式：HTTP POST

请求参数

参数名	类型	是否必须	描述	示例
Action	String	Y	操作接口名，取值：ForbidStream	ForbidStream
Version	String	Y	版本号，取值：2017-01-01	2017-01-01
UniqueName	String	Y	域名空间	testUniquename
App	String	Y	应用名	testApp
Pubdomain	String	Y	推流域名	www.yourdomain.com
Stream	String	Y	流名	testSteam
ForbidTillUnixTime	Int	N	流恢复的时间，Unix秒级时间戳 注意：默认禁播90天，且最长支持禁播90天 传1，立即断开直播流 传-1，立即断开直播流并禁播90天	1546300800

返回参数

参数名	类型	描述
RetCode	Int	响应码。 0 成功，其他失败
RetMsg	String	响应信息描述

请求示例

POST /?Action=ForbidStream&Version=2017-01-01 HTTP/1.1
Content-Type: application/json
X-Amz-Date: YOURDATE
Authorization: AWS4-HMAC-SHA256 Credential=YOURAK/YYYYMMDD/cn-beijing-6/kls/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=SIG
Host: kls.api.ksyun.com

{
	"UniqueName" : "YOUR UNIQUENAME",
	"App" : "YOUR APP", 
	"Pubdomain" : "YOUR PUBLISH DOMAIN",
	"Stream" : "YOUR STREAM NAME"
	
}

返回示例

{
  "Data": {
    "RetCode": 0,
    "RetMsg": "success"
  }
}

错误码

为了帮您快速定位问题，云直播将错误码集中归类，请到错误码中心查看详情。