功能介绍

该接口用于更新视频流的详情，包括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	错误消息，详见错误码说明。

返回值

• 正常

  200

• 异常

  返回值	说明
  400 Bad Request	请求错误。具体返回错误码请参考错误码说明。
  401 Unauthorized	鉴权失败。
  403 Forbidden	没有操作权限。
  404 Not Found	找不到资源或没有开通服务。
  500 Internal Server Error	服务内部错误。
  503 Service Unavailable	服务不可用。