jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的视频监控截图模板

gpt: [视频监控](https://developer.qiniu.com/qvs) > 使用文档 > 使用指南 >模板管理 >截图模板

#  截图模板

最近更新时间: 2021-11-29 15:39:07

如需进行云端截图时，可按照需求场景创建对应的截图模板并进行模板的绑定操作即可。

# **使用说明**

  1. 模版可应用于空间级别和流级别。同一个模版可以与多个空间绑定。流级别的模版优先级高于空间。
  2. 模板最终生效的都在流维度上，如需截图功能需要先进行截图模版的创建和绑定，流接入后触发模板工作。
  3. 将模板与空间或流绑定时，模板中bucket所属的存储区域需要和“视频监控”中空间的服务区域保持一致，故创建模板时需要根据模板将要作用的空间，选择与空间服务区域一致的存储区域的bucket。

# **添加模板**

### **操作说明**

1.登录[七牛开发者平台
__](https://sso.qiniu.com/?client_id=PIapUKqa3u6S24H868BelwrG0OFu8dS7AxVQ8oz8HznLXhgrl2BnjaO9cs9LzxK2&redirect_url=https:%2F%2Fportal.qiniu.com%2Fapi%2Fgaea%2Fsso%2Fsignin%3Fredirect%3D%252Fcreate)。

2.选择**视频监控** 产品，进入产品控制台，选择**模板管理** ，进入模板管理页面，选择**截图模板** 。  
3.点击**添加截图模板** ，创建新的截图模板  
![](https://dn-odum9helk.qbox.me/FofngGgNYf-Zmyx78nsZyOc-BdkS)  
![](https://dn-odum9helk.qbox.me/FqVVv9CrJ8frXhabftujIUEd0Gjv)

**配置项说明**

配置项 | 说明  
---|---  
模板名称 | 模版名称，格式为 1 ~ 100个字符，可包含小写字母、数字、中划线  
截图频率 | 支持 1-21600 秒  
截图方式 | 可选项为实时截图、覆盖式截图、按需截图。   
（1）实时截图：每张截图文件都独立存储，不覆盖。  
（2）覆盖式截图：只保留最新一张截图，每次截图覆盖上一张截图，名称和地址保持不变，常用作视频封面。  
（3）按需截图：只有当调用启动截图接口时才会进行截图。  
存储空间 | 选择录制的视频文件存储的空间，目前只支持华北、华东、华南三个区域，创建模板时需要根据模板将要作用的空间，选择与空间服务区域一致的存储区域的bucket。  
文件生命周期 | 录制的视频文件存储的周期  
文件存储类型 | 选择录制的视频文件存储的存储类型，可选项为普通存储和[低频存储 __](https://developer.qiniu.com/kodo/manual/3737/infrequent-storage)  
  
# **绑定截图模板**

模板可以绑定到空间上也可以绑定到对应的视频流上，绑定到空间上对空间下所有视频流生效，绑定到视频流上只对此路流生效。

### **操作说明**

**1.绑定到空间**  
1.1选择**视频监控** 产品，进入产品控制台，选择**空间管理** ，进入空间列表页面，选择对应的空间点击**配置** ，进入空间详情页面。  
1.2空间详情页面中选择**模板配置** ，点击**编辑** 进行配置如下图所示：  
![1.png](https://dn-odum9helk.qbox.me/FlbU5Ve7bmlYtvfq0ro1KQQ_jELU)  
**2.绑定到流**  
2.1选择**视频监控** 产品，进入产品控制台，选择**视频流管理** ，进入视频流列表页面，选择对应的视频流点击**管理** ，进入流管理页面。  
2.2空间管理页面中选择**基本信息** ，点击**编辑** 进行配置如下图所示：  
![2.png](https://dn-odum9helk.qbox.me/FsDnlHSb5mQ_N28A79IISJ9f6NxT)

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控HTTP Headers

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 调用方式 >HTTP Headers

#  HTTP Headers

最近更新时间: 2022-08-08 11:30:06

# **公共请求头**

名称 | 类型 | 是否必填 | 示例值 | 说明  
---|---|---|---|---  
Host  | String | 是 | qvs.qiniuapi.com | 服务地址  
Authorization | String | 是 | QiniuToken | 验证请求合法性的认证信息。认证不通过时，会收到401错误码。格式为`Authorization: Qiniu xx:xx`。 建议使用服务端接入SDK，[java版本SDK __](https://developer.qiniu.com/qvs/6923/qvs-java-sdk)或者其他版本，sdk已经封装了鉴权机制；如果客户自行计算该字段，可以参考[鉴权机制 __](https://developer.qiniu.io/qvs/6713/authentication)  
Content-Type | String | 否 |  | 一. http body为空时，例如Get请求, Content-Type有3种选择  
1\. `不`携带Content-Type  
2.设置为`空`  
3.设置为`application/x-www-form-urlencoded`;  
二. http body 不为空时，例如Post或者Patch等,Content-Type设置为application/json  
  
# **公共响应头**

名称 | 说明 | 示例值  
---|---|---  
Content-Length  | 请求或响应内容长度，单位`字节`。 | 例如 `Content-Length: 299`。  
Content-Type | 请求或响应内容的 MIME 类型。 | 例如 `Content-Type: application/json`。  
X-Reqid | 上传请求的唯一 ID。通过该 ID 可快速定位用户请求的相关日志。在联系技术支持时提供该 ID 可快速解决问题。 | 例如 `X-Reqid: BlcAAAFP_Hx-RfkU`。  
Date | 服务器端响应时间。 | 例如 `Date: Wed, 22 Nov 2017 01:52:39 GMT`。  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控鉴权机制

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 调用方式 >鉴权机制

#  鉴权机制

最近更新时间: 2023-03-28 16:38:47

鉴权机制用于QVS服务的授权，通过授权客户端，使其具备访问服务的能力。访问 API 需要带一个合法的凭证。不带凭证或带非法凭证的请求将返回 HTTP 错误码
401，代表认证失败。

每一个API请求均需在 HTTP 请求头部增加一个 Authorization 字段，形式如下：

    
    
    Authorization: <QiniuToken>
    

`<QiniuToken>`:管理凭证，用于鉴权。

**管理凭证计算方式：**

    
    
    // 构造待签名的 Data
    // 1. 添加 Path
    data = "<Method> <Path>"
    // 2. 添加 Query，前提: Query 存在且不为空
    if "<RawQuery>" != "" {
            data += "?<RawQuery>"
    }
    // 3. 添加 Host
    data += "\nHost: <Host>"
    // 4. 添加 Content-Type，前提: Content-Type 存在且不为空
    if "<Content-Type>" != "" {
            data += "\nContent-Type: <Content-Type>"
    }
    // 5. 添加回车
    data += "\n\n"
    // 6. 添加 Body，前提: Content-Length 存在且 Body 不为空，同时 Content-Type 存在且不为空或 "application/octet-stream"
    bodyOK := "<Content-Length>" != "" && "<Body>" != ""
    contentTypeOK := "<Content-Type>" != "" && "<Content-Type>" != "application/octet-stream"
    if bodyOK && contentTypeOK {
            data += "<Body>"
    }
    // 计算 HMAC-SHA1 签名，并对签名结果做 URL 安全的 Base64 编码
    sign = hmac_sha1(data, "Your_Secret_Key")
    encodedSign = urlsafe_base64_encode(sign)  
    // 将 Qiniu 标识与 AccessKey、encodedSign 拼接得到管理凭证
    <QiniuToken> = "Qiniu " + "Your_Access_Key" + ":" + encodedSign
    

[URL 安全的 Base64 编码 __](https://developer.qiniu.com/kodo/manual/1231/appendix)  
**python 计算Authorization管理凭证示例：**

    
    
    以[获取流地址](https://developer.qiniu.com/qvs/6800/static-model)为例
    
    import hmac
    import base64
    import hashlib
    
    // 拼接规则
    //data=方法+" "+接口路径+"\nHost: "+ "qvs.qiniuapi.com" + "\nContent-Type: "+"application/json\n\n"+"json body"
    
    // 具体实现
    
    # -*- coding:utf-8 -*-
    
    import hmac
    import base64
    import hashlib
    #具体实现 python2
    data = "POST"+ " " + "/v1/namespaces/2xenzw32d1rf9/streams/31011500991180001471_34020000001320000001/domain" + \
    "\nHost: " + "qvs.qiniuapi.com" + \
    "\nContent-Type: " + "application/json" + "\n\n" + \
    '{"domain":"qvs-live-hls.cpgroup.cn","domainType":"liveHls"}'
    accessKey = '替换成自己的accessKey'
    secretKey = '替换成自己的secretKey'
    sign = hmac.new(secretKey, data, hashlib.sha1).digest()
    encodedSign = base64.urlsafe_b64encode(sign)
    authorization = 'Qiniu ' + accessKey + ':' + encodedSign
    print(authorization)
    
    

**API请求示例：**

    
    
    GET /v1/apps/test/devices/dGVzdGRldmljZTE= HTTP/1.1
    Host: linking.qiniuapi.com
    Authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=
    Content-Type: application/json
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控请求结构

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 调用方式 >请求结构

#  请求结构

最近更新时间: 2022-08-03 16:19:43

# **服务地址**

API服务域名: `http(s)://qvs.qiniuapi.com`

# **通信协议**

支持通过 HTTP 或 HTTPS 进行通信，为了更高的安全性，建议使用 HTTPS 发送API请求。

# **字符编码**

请求及返回结果都使用 UTF-8 字符集进行编码。

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控删除空间

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 空间管理相关接口 >删除空间

#  删除空间

最近更新时间: 2020-05-06 15:28:51

# **描述**

本接口用于删除空间

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：DELETE
  * 接口路径：`/v1/namespaces/{namespaceId}`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request DELETE \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrars3nkw3s \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控更新空间

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 空间管理相关接口 >更新空间

#  更新空间

最近更新时间: 2023-04-13 10:27:05

# **描述**

本接口用于更新空间信息

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：PATCH
  * 接口路径：`/v1/namespaces/{namespaceId}`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
operations | 是 | op数组 | op集合，详见： _表一_  
  
_表一：_ OP集合参数

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
operations.key | 是 | string | 要修改的参数  
operations.op | 是 | string | op操作(目前支持replace和delete)  
operations.value | 是 | object | 要修改的参数对应的value(当op为delete的时候可以忽略)  
  
_表二：_ 可编辑参数说明

参数名称 | 字段类型 | 说明  
---|---|---  
name | string | 空间名称  
desc | string | 空间描述  
callBack | string | 回调地址  
hlsLowLatency | boolean | HLS低延时开关  
authMode | string | 鉴权模式，noUrlAuth：不开启鉴权，expiryAuth：开启url过期鉴权  
authExpire | integer | 当鉴权模式为expiryAuth的鉴权过期时间  
recordTemplateId | string | 录制模版ID  
snapshotTemplateId | string | 截图模版ID  
aiTemplateId | string | AI模版ID  
recordTemplateApplyAll | boolean | 空间模版是否应用到全局  
snapshotTemplateApplyAll | boolean | 截图模版是否应用到全局  
aiTemplateApplyAll | boolean | ai模版是否应用到全局  
onDemandPull | boolean | 按需拉流开关  
retryInterval | integer | 空间接入类型为"主动拉流"时，拉流中断重连间隔  
retryCount | integer | 空间接入类型为"主动拉流"时，拉流中断重连次数  
rtpAudio | boolean | 是否开启音频  
rtpAudioTranscode | boolean | 是否开启音频转码  
  
# **响应参数**

与创建空间接口响应内容一致，请参阅创建空间[响应参数 __](https://developer.qiniu.io/qvs/api/6726/create-
namespace#3)

# **示例**

**请求示例**

    
    
    curl --request PATCH \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrars3vpsxa \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{"operations":[{"key":"recordTemplateApplyAll","op":"replace","value":true}]
    }'
    

**响应示例**

    
    
    {
      "id": "2akrars3vpsxa",
      "name": "test001238",
      "domains": [
        "qiniu.com"
      ],
      "accessType": "rtmp",
      "urlMode": 1,
      "hlsLowLatency": false,
    	""
      "zone": "z0",
      "createdAt": 1586764022,
      "updatedAt": 1586780381,
      "recordTemplateId": "2akrarrzr7rh5",
      "recordTemplateApplyAll": true,
      "snapshotTemplateApplyAll": false,
      "disabled": false,
    	"onDemandPull": false,
    	"authMode": "expiryAuth",
    	"authExpire": 86400
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控查询空间信息

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 空间管理相关接口 >查询空间信息

#  查询空间信息

最近更新时间: 2023-12-22 15:11:47

# **描述**

本接口用于查询空间信息

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
id | string | 空间ID  
name | string | 空间名称  
domains | string数组 | 静态类型（域名方式）接入时的域名信息  
accessType | string | 接入类型,三种接入类型中的一种(rtmp,gb28181,pull,onvif)  
~~rtmpUrlType~~(废弃,请使用urlMode) | integer | 推拉流地址计算方式，1:static（域名方式）, 2:dynamic（API动态获取）  
urlMode | integer | 推拉流地址计算方式，1:static（域名方式）, 2:dynamic（API动态获取）  
callBack | string | 回调地址  
zone | string | zone为服务区域, 可根据流媒体实时处理、视频录制、截图的存储需求选择对应的区域, 可选项为z0, z1, z2, 默认为z0. z0表示华东, z1表示华北、z2表示华南  
hlsLowLatency | boolean | HLS低延时开关  
recordTemplateId | string | 录制模版ID  
snapshotTemplateId | string | 截图模版ID  
aiTemplateId | string | AI模版ID  
recordTemplateApplyAll | boolean | 空间模版是否应用到全局  
snapshotTemplateApplyAll | boolean | 截图模版是否应用到全局  
aiTemplateApplyAll | boolean | AI模版是否应用到全局  
disabled | boolean | 空间是否被禁用  
deviceCount | integer | 接入设备的数量  
streamCount | integer | 空间中流的数量  
onlineStreamCount | integer | 空间中在线流数量  
disabledStreamCount | integer | 空间中禁用流数量  
sipAddrs | sip信息数组 | sip信息数组, 建议:`同一个空间设备量较大时，可从该数组中随机选取地址，而不是固定一个`  
sipAddrs.sipServerId | string | accessType为gb28181时sip服务器地址，地址前10位为对应sip域  
sipAddrs.sipServerIP | string | accessType为gb28181时sip服务器IP  
sipAddrs.sipServerPort | string数组 | accessType为gb28181时sip服务器端口  
createdAt | integer | 空间创建时间  
updatedAt | integer | 空间更新时间  
retryInterval | integer | accessType为"pull",即主动拉流时，代表拉流中断重连间隔，单位为秒  
retryCount | integer | accessType为"pull",即主动拉流时，代表拉流中断重连次数，单位为次  
rtpAudio | boolean | 是否开启音频  
rtpAudioTranscode | boolean | 是否开启音频转码  
desc | string | 空间描述信息  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/namespaces/2akrars3nkw3s \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "id": "2akrars3nkw3s",
      "name": "test001235",
      "domains": [
        "qiniu.com"
      ],
      "accessType": "rtmp",
      "urlMode": 1,
      "zone": "z0",
      "hlsLowLatency": false,
      "createdAt": 1586750356,
      "updatedAt": 1586750356,
      "recordTemplateId": "2akrarrzr7rh5",
      "recordTemplateApplyAll": false,
      "snapshotTemplateApplyAll": false,
      "disabled": false,
      "streamCount":2,
      "onlineStreamCount":1,
      "disabledStreamCount":1
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控禁用空间

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 空间管理相关接口 >禁用空间

#  禁用空间

最近更新时间: 2020-05-06 15:29:13

# **描述**

本接口用于禁用空间

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespacesId}/disabled`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespacesId | 是 | string | 空间ID  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/disabled \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控启用空间

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 空间管理相关接口 >启用空间

#  启用空间

最近更新时间: 2020-05-06 15:29:18

# **描述**

本接口用于启用空间

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespacesId}/enabled`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespacesId | 是 | string | 空间ID  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/enabled \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控使用流接口必读

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >使用流接口必读

#  使用流接口必读

最近更新时间: 2023-07-07 19:09:16

**一.流id规则**  
1.空间类型`gb28181`:设备类型为摄像头,流ID就是`设备国标ID`;设备类型是NVR(平台类型),流ID为`设备国标ID_通道国标ID`  
2.空间类型为`rtmp`或者`主动拉流`:流ID就是`流名称`  
3.空间类型为`onvif`,流ID就是`onvif设备ID`  
4.对于录像回放，空间类型`gb28181`,设备类型为摄像头时，流ID格式为`设备国标ID_history_开始时间戳_结束时间戳`；当设备类型为平台时，流ID格式为`设备国标ID_通道ID_history_开始时间戳_结束时间戳`；假设目前有一个NVR国标ID为31011500991320020874，通道ID为34020000001310000001，希望观看2022-12-12
00:00:00到2022-12-12
23:59:59时间段内的录像，则流ID为:`31011500991320020874_34020000001310000001_history_1671638400_1671724799`，通过请求此接口可以获取到回放的流地址。注意这里的时间戳指的是unix时间戳，单位秒。

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控重置流状态

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >重置流状态

#  重置流状态

最近更新时间: 2022-09-29 15:35:15

# **描述**

本接口用于重置视频流的状态为`离线`

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/resets`
  * 使用场景：流实际离线了(设备没有推流),由于异常原因,获取的流状态却是在线状态,此时可通过本接口重置流为`离线`状态。
  * 本接口不能被其他接口替代，只用于上面的异常情况使用

**请求 body参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
streamIds | 是 | string数组 | 需要重置的流id列表  
  
# **响应参数**

200 ok

# **示例**

**请求示例**

    
    
    curl --request POST \
      --url 'qvs.qiniuapi.com/v1/namespaces/2akrarrzns76w/streams/resets' \
      --header 'authorization: Qiniu xxxx:xxx'
    --data '{
    	"streamIds":["111", "222"]
     }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控创建流

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >创建流

#  创建流

最近更新时间: 2022-12-12 12:05:11

# **描述**

本接口用于创建流（用于接入类型`非gb28181`的空间）

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/namespaces/{namespaceId}/streams`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
streamId | 是 | string | 流名称, 流名称在空间中唯一，可包含 字母、数字、中划线、下划线；1 ~ 100 个字符长；创建后将不可修改  
desc | 否 | string | 关于流的描述信息  
recordTemplateId | 否 | string | 录制模版ID，配置流维度的录制模板，默认从空间继承  
snapshotTemplateId | 否 | string | 截图模版ID，配置流维度的截图模板，默认从空间继承  
aiTemplateId | 否 | string | AI模版ID，配置流维度的AI模板，默认从空间继承  
pullType | 否 | string | 主动拉流模式的空间下，流的接入类型。rtsp/rtmp/http-flv/hls/other 拉流  
pullAddr | 否 | string | 主动拉流模式的空间下，拉流地址  
pullVideoModel | 否 | integer | 主动拉流模式的空间下，0代表视频源为实时流 1代表视频源为点播内容或静态文件  
rtspModel | 否 | integer | 主动拉流模式的空间下，当拉流地址为rtsp时 0:代表udp拉流,1:代表tcp拉流。默认为0即udp  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
streamId | string | 流名称（流ID）  
desc | string | 描述  
nsId | string | 所属的空间ID  
nsName | string | 所属的空间名称  
recordTemplateId | string | 录制模版ID  
snapshotTemplateId | string | 截图模版ID  
aiTemplateId | string | AI模版ID  
disabled | boolean | 流是否被禁用  
lastPushedAt | integer | 最后一次推流时间,0:表示流从创建开始尚未进行过推流操作  
status | bool | 流是否在线  
pullType | string | 主动拉流模式的空间下，流的接入类型。rtsp/rtmp/http-flv/hls/other 拉流  
pullAddr | string | 主动拉流模式的空间下，拉流地址  
createdAt | integer | 流创建时间  
updatedAt | integer | 流更新时间  
  
# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"streamId":"device009",
    	"recordTemplateId":"d102sns2mwhd"
    }'
    

**响应示例**

    
    
    {
      "streamId": "device009",
      "nsId": "d102sni9zryu",
      "nsName": "test009",
      "recordTemplateId": "d102sns2mwhd",
      "snapshotTemplateId": "",
      "aiTemplateId": "",
      "createdAt": 1586832470,
      "updatedAt": 1586832470,
      "status": false,
      "disabled": false,
      "lastPushedAt": 0
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控删除流

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >删除流

#  删除流

最近更新时间: 2022-05-20 12:29:39

# **描述**

本接口用于删除流

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：DELETE
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request DELETE \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device009 \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      code:200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控更新流

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >更新流

#  更新流

最近更新时间: 2022-05-20 12:29:30

# **描述**

本接口用于更新流信息

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：PATCH
  * 接口路径：`/v1/namespaces/{namespacesId}/streams/{streamId}`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 流ID  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
operations | 是 | op数组 | op集合，详见： _表一_  
  
_表一：_ OP集合参数

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
operations.key | 是 | string | 要修改的参数  
operations.op | 是 | string | op操作(目前支持replace和delete)  
operations.value | 是 | object | 要修改的参数对应的value(当op为delete的时候可以忽略)  
  
_表二：_ 可编辑参数说明

参数名称 | 字段类型 | 说明  
---|---|---  
desc | string | 流描述  
recordTemplateId | string | 录制模版ID  
snapshotTemplateId | string | 截图模版ID  
diabled | boolean | 流是否被禁用  
pullAddr | string | 主动拉流模式的空间下，拉流地址  
  
# **响应参数**

与创建流接口响应内容一致，请参阅创建流[响应参数 __](https://developer.qiniu.io/qvs/api/6734/create-
flow#3)

# **示例**

**请求示例**

    
    
    curl --request PATCH \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device009 \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{"operations":[{"key":"recordTemplateId","op":"replace","value":"d102sns2mwhd"}]
    }'
    

**响应示例**

    
    
    {
      "streamId": "device009",
      "nsId": "d102sni9zryu",
      "nsName": "test009",
      "recordTemplateId": "d102sns2mwhd",
      "snapshotTemplateId": "",
      "createdAt": 1586832470,
      "updatedAt": 1586832470,
      "status": false,
      "disabled": false,
      "lastPushedAt": 0
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控查询流信息

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >查询流信息

#  查询流信息

最近更新时间: 2022-12-12 12:05:17

# **描述**

本接口用于查询流信息。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/namespaces/{namespaceId}/streams/{streamId}`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
namespaceId | 是 | string | 空间ID  
streamId | 是 | string | 空间为`gb28181`:设备类型为摄像头,流ID就是`设备国标ID`;设备类型是NVR(平台类型),流ID为`设备国标ID_通道国标ID`  
空间类型为`rtmp`或者`主动拉流`:流ID就是`流名称`  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
streamId | string | 流ID  
desc | string | 描述  
nsId | string | 所属空间ID  
nsName | string | 所属空间名称  
recordTemplateId | string | 录制模版ID，默认从空间继承  
snapshotTemplateId | string | 截图模版ID，默认从空间继承  
aiTemplateId | string | AI模版ID，默认从空间继承  
disabled | boolean | 流是否被禁用  
lastPushedAt | integer | 最后一次推流时间，0:表示流从创建开始尚未进行过推流操作  
pullType | string | 主动拉流模式的空间下，流的接入类型。rtsp/rtmp/http-flv/hls/other 拉流  
pullAddr | string | 主动拉流模式的空间下，拉流地址  
pullVideoModel | integer | 0:直播 1:点播  
rtspModel | integer | rtsp传输协议。 0:udp 1:tcp  
status | bool | 流是否在线  
userCount | integer | 在线观看人数(只有在流在线的时候才会出现)  
clientIp | string | 推流端IP(只有在流在线的时候才会出现)  
audioFrameRate | integer | 直播流的实时音频帧率(只有在流在线的时候才会出现)  
bitRate | integer | 直播流的实时码率(只有在流在线的时候才会出现)  
videoFrameRate | integer | 直播流的实时视频帧率(只有在流在线的时候才会出现)  
createdAt | integer | 流创建时间  
updatedAt | integer | 流更新时间  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device009 \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "streamId": "device009",
      "nsId": "d102sni9zryu",
      "nsName": "test009",
      "recordTemplateId": "d102sns2mwhd",
      "snapshotTemplateId": "",
      "aiTemplateId": "",
      "createdAt": 1586832470,
      "updatedAt": 1586832470,
      "status": false,
      "disabled": false,
      "lastPushedAt": 0
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控获取流地址

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 流管理相关接口 >获取流地址

#  获取流地址

最近更新时间: 2022-05-20 13:53:01

# **获取流地址**

创建空间时时，需要选择是`静态地址`模式或`动态地址`模式，请根据空间设置的模式选择对应的接口获取流地址。

模式 | 说明  
---|---  
静态地址 | qvs域名系统用于实时的视频推流或播放,与客户在对象存储里配置的域名(视频回看)是独立的。   
通过配置域名的方式接入，流地址既可以通过api获取,在不开启时间戳防盗链时,`地址是固定的, 也可以自行拼装`。  
拼装格式:  
1.rtmp，推流和播放格式:“rtmp://推流或播放域名:2045/空间id/流id”。  
2.hls,http格式"http://播放域名:1240/空间id/流id.m3u8",https格式"https://播放域名:447/空间id/流id.m3u8"。  
3.flv,http格式
“http://播放域名:1240/空间id/流id.flv”,https格式"https://播放域名:447/空间id/流id.flv"。  
4.webrtc, http环境
“webrtc://播放域名:1240/空间id/流id”,https环境"webrtc://播放域名:447/空间id/流id"。  
5.[流id规则 __](https://developer.qiniu.com/qvs/11878/use-the-stream-interface-
is-required)  
6.`https`环境播放实时视频流 需要2个条件,
1:提供域名,配置cname解析,[`如何配置cname?`__](https://developer.qiniu.com/qvs/8746/configure-
cname)2.在qvs的域名管理界面,为该域名配置https证书。[`如何配置https证书?`__](https://developer.qiniu.com/qvs/6925/qvs-
https-configuration)  
7.看不到域名配置管理界面?那是因为`新建空间`时,`模式`选择了动态地址,怎么办?
需要客户重建一个新空间，选择`静态地址`。客户如果不想新建空间时,需要提工单,我们在后台为客户转换空间模式.  
  
动态地址 | 无需配置域名，流地址全部为IP形式，需通过API获取实时的流地址。  
适用场景：  
1.测试阶段，快速验证。  
2.不想配置域名，能接受流地址通过API获取。  
3\. http的播放环境。如果是`https`环境,`务必`使用上面的`静态地址`  
**动态接入`不支持https`环境中播放, IP`不`固定，必须通过API获取最新流地址**  
  
以上内容是否对您有帮助？