- 服务公告
- 产品介绍
- 用户指南
- API参考
-
常见问题
- 视频接入服务支持哪些类型的视频流？
- 控制台上视频流不能预览播放怎么处理？
- RTMP类型视频流在视频预览页面的推流地址和取流地址为空，如何处理？
- 首次使用视频转储功能时，需要哪些准备工作？
- 正在转储中的视频流如果中断了，OBS上的视频片段文件会怎样？
- 转储失败时如何处理？
- VIS中访问秘钥和GB/T28181密码，两种凭证有什么区别和作用？
- GB/T28181类型设备注册失败怎么处理？
- 设备接入VIS的SIP服务器地址怎么获取？
- GB/T28181类型设备邀约失败，常见原因有哪些？
- GB/T28181类型设备邀约成功后，如果设备故障并恢复，是否需要重新注册和邀约？
- 视频流管理页面中，视频流状态和转储状态分别都有哪几种，代表什么含义？
- 取流地址是https格式的url，使用该url获取实时视频时，VIS报502错误码，常见原因有哪些？
- 使用视频流或者设备并删除资源后，为何第二天仍旧收到了扣费的话单，并进行了扣费？
- 视频流的取流地址会改变吗？
- GB/T28181设备注册成功后，无法获取到视频流的常见原因有哪些？
- 文档下载
- 通用参考
链接复制成功！
更新视频流
功能介绍
该接口用于更新视频流的详情，包括RTMP以及HTTP-FLV类型视频流。
接口约束
当视频流处于ACTIVE状态时，不允许修改视频接入类型
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v1/{project_id}/streams/{stream_name}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID，获取方法请参考获取项目ID |
|
stream_name |
是 |
String |
视频流名称 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
普通租户的token。 |
|
Authorization |
否 |
String |
使用AK/SK方式认证时必选，携带的鉴权信息。 |
|
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选，请求的发生时间。 |
|
X-Project-Id |
否 |
String |
使用AK/SK方式认证时必选，携带项目ID信息。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
视频流共享类型。
不区分大小写。 |
|
tag |
否 |
Array of StreamTag objects |
和视频流关联的标签，一个视频流最多添加10个标签。 |
|
state |
否 |
String |
视频流状态,可选值如下。
|
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
String |
处理成功时返回 |
请求示例
PUT /v1/3266392d188c47d09948b1**********/streams/streamTest
{
"state" : "ACTIVE"
}响应示例
状态码： 200
正常
{
"result" : "success"
}状态码： 400
请求错误。具体返回错误码请参考错误码说明
{
"error_msg" : "Invalid request parameter, url can not be null or empty when access type is HTTP-FLV.",
"error_code" : "VIS.0005"
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
正常 |
|
400 |
请求错误。具体返回错误码请参考错误码说明 |
