更新视频流
功能介绍
该接口用于更新视频流的详情,包括RTMP以及HTTP-FLV类型视频流。
- 对于GB28181设备自动关联的视频流,不能通过该接口进行更新。
- 当视频流处于ACTIVE状态时,不允许修改视频接入类型。
调试
您可以在API Explorer中调试该接口。
URI
- URI格式
PUT /v1/{project_id}/streams/{stream_name}
- 参数说明
参数
是否必选
类型
说明
project_id
是
String
项目ID,获取方法请参见获取项目ID。
stream_name
是
String
视频流名称。
请求消息
- 请求样例
PUT /v1/{project_id}/streams/streamTest { "state": "ACTIVE" }
- 参数说明
参数
是否必选
类型
说明
access_type
否
String
视频接入类型,例如HTTP-FLV、RTMP等,不区分大小写。当视频流处于ACTIVE状态时,不允许修改该项。
encode_type
否
String
视频流编码格式,当前支持H264,不区分大小写。
access_key
否
String
RTMP视频流绑定的秘钥Access Key。
url
否
String
HTTP-FLV视频流的拉流地址。
URL必须是http或https协议的合法URL。格式要求:以“http://”或“https://”开头的字符串,例如“http://xxxx.xxx”。
description
否
String
视频流的描述信息。
share_type
否
String
视频流共享类型,不区分大小写:- PRIVATE:非共享。
- PUBLIC:共享。
tag
否
Array of tag objects
一个视频流最多添加10个标签。
state
否
String
视频流状态:- ACTIVE:表示已激活。
- STOPPED:表示已停用。
响应消息
- 成功时,响应样例:
{ "result": "success" }
- 失败时,返回如下参数:
参数
说明
error_code
错误码。
error_msg
错误消息,详见错误码说明。
返回值
- 正常
- 异常
返回值
说明
400 Bad Request
请求错误。具体返回错误码请参考错误码说明。
401 Unauthorized
鉴权失败。
403 Forbidden
没有操作权限。
404 Not Found
找不到资源或没有开通服务。
500 Internal Server Error
服务内部错误。
503 Service Unavailable
服务不可用。
