jancd/qiniu-developer_ShareGPT huggingface dataset:
human: 如何处理七牛云的视频监控更新实体

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 更新实体

#  更新实体

最近更新时间: 2022-12-12 11:48:34

# **描述**

本接口用于更新某个实体信息。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：PATCH
  * 接口路径：`/v1/imagelibs/{libId}/entities/{entityId}`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
libId | 是 | string | 库ID  
entityId | 是 | string | 实体ID  
  
**Body**

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

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

参数名称 | 字段类型 | 说明  
---|---|---  
name | string | 姓名  
gender | string | 性别 male 或 female  
phoneNum | string | 手机号  
certNum | string | 证件号  
addr | string | 地址  
desc | string | 备注描述  
  
# **响应参数**

响应参数与查询实体一致，请参阅**查询实体**[响应参数
__](https://developer.qiniu.io/qvs/api/12180/query-entity)

# **示例**

**请求示例**

    
    
    curl --request PATCH \
      --url http://qvs.qiniuapi.com//v1/imagelibs/xxx/entities/yyy \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{"operations":[{"op":"replace", "key":"name","value":"newName"}, {"op":"replace", "key":"addr","value":"sh"}]
    }'
    

**响应示例**

    
    
    {
      "libId": "xxx",
      "id": "yyy",
      "name": "test009",
       ....
      "createdAt": 1585104103
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 删除实体里的图片

#  删除实体里的图片

最近更新时间: 2022-12-12 11:49:09

# **描述**

本接口用于删除某个实体里已上传的图片，该接口调用后会自动更新实体的图片数组，无需再手动更新实体的图片数组。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：DELETE
  * 接口路径：`/v1/imagelibs/{libId}/entities/{entityId}/images`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
libId | 是 | string | 图像库ID  
entityId | 是 | string | 实体ID  
  
**请求 body参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
url | 是 | string | 需要删除的图片地址  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request DELETE \
      --url http://qvs.qiniuapi.com/v1/imagelibs/xxxx/entities/yyyy/images\
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --data '{
    	"url":"http://qvs.com/1.jpg"
        }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控向实体中添加新图片

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 向实体中添加新图片

#  向实体中添加新图片

最近更新时间: 2022-12-12 11:48:58

# **描述**

本接口用于向实体中添加新的图片,每个实体最多上传10张图片，该接口调用后会自动更新实体的图片数组，无需再手动更新实体的图片数组。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/imagelibs/{libId}/entities/{entityId}/images`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
libId | 是 | string | 图像库ID  
entityId | 是 | string | 实体ID  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
imageData | 是 | string | 图片的base64编码  
  
# **响应参数**

参数名称 | 字段类型 | 说明  
---|---|---  
url | string | 图片的url  
  
# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/imagelibs/xxxx/entities/yyyy/images \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"imageData":"YWRzYWRhc2Q="
    }'
    

**响应示例**

    
    
    {
      "url": asdu2wns.hd-bkt.clouddn.com/1626352621.jpg
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控图像底库列表

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 图像底库列表

#  图像底库列表

最近更新时间: 2022-12-22 11:25:49

# **描述**

本接口用于获取图像底库列表。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/imagelibs?offset=<offset>&line=<line>&match=<match>&sortBy=<sortBy>`
  * Get请求，通过`非SDK`方式调用的客户，http头部Content-Type,`要么设置为application/x-www-form-urlencoded`,`要么置空`, `要么不要携带`; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
line | 否 | integer | 一次返回多少条，最多1000,当超过1000条时，需要结合offset 循环读取。  
offset | 否 | integer | 偏移量，当需要循环读取时,初始值offset = 0, 第N次请求时offset = (N -1) * line  
sortBy | 否 | string | 默认按创建时间降序排列，sortBy由"asc/desc"和可参与排序的字段组成，其中 asc 表示升序，desc 表示降序  
match | 否 | string | 模糊匹配查询(库名称包含match串时返回)  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
items | 库数组 | 库数组  
items.id | string | 库id  
items.name | string | 库名称  
items.desc | string | 备注描述  
items.createdAt | integer | 库创建时间  
total | integer | 总数量  
  
# **示例**

**请求示例**

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

**响应示例**

    
    
    {
      "items": [
        {
          "id": "2akrars5b81f5",
          "name": "test0016",
          "desc": "this is a test",
          "createdAt": 1586850533
        },
        {
          "id": "d102sns2mwhd",
          "name": "test009",
          "createdAt": 1585104103
        }
      ],
      "total": 2
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 创建实体

#  创建实体

最近更新时间: 2022-12-12 11:48:19

# **描述**

实体隶属于图像库。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/imagelibs/{libId}/entities`

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
libId | 是 | string | 图像库ID  
  
**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
name | 是 | string | 实体所属姓名,可包含中文、字母、数字、中划线、下划线  
gender | 否 | string | 性别, 可选项为 male 或 female, 默认 male.  
phoneNum | 否 | string | 手机号  
certNum | 否 | string | 证件号  
addr | 否 | string | 地址  
desc | 否 | string | 备注  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
libId | string | 所属的库ID  
id | string | 实体id  
urls | string数组 | 实体的图片数组，实体创建后为空，可以调用添加图片接口给实体添加图片  
name | string | 实体所属姓名,可包含字母、数字、中划线、下划线  
gender | string | 性别, 可选项为 male 或 female, 默认 male.  
phoneNum | string | 手机号  
certNum | string | 证件号  
addr | string | 地址  
desc | string | 备注  
createdAt | integer | 创建时间  
  
# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com//v1/imagelibs/xxxx/entities \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"name":"test0013",
    	"desc":"this is a test"
    }'
    

**响应示例**

    
    
    {
      "libId": "xxxx",
      "id": "2akrars59hm2l",
      "name": "test0013",
      "urls": [],
      "desc": "this is a test",
      "createdAt": 1586847620
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 删除实体

#  删除实体

最近更新时间: 2022-12-12 11:48:42

# **描述**

本接口用于删除某个图像库里的实体信息。

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

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
libId | 是 | string | 图像库ID  
  
**请求 body参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
entityIds | 是 | string数组 | 需要删除的实体ID列表, 从API(实体列表)获取  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request DELETE \
      --url http://qvs.qiniuapi.com/v1/imagelibs/xxxx/entities\
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --data '{
    	"entityIds":["id1","id2"]
        }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 删除图像底库

#  删除图像底库

最近更新时间: 2022-12-12 11:48:04

# **描述**

本接口用于删除图像库，图像库里所有图片也会被一并删除

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

# **请求参数**

**请求 body参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
libIds | 是 | string数组 | 需要删除的库ID列表  
  
# **响应参数**

无

# **示例**

**请求示例**

    
    
    curl --request DELETE \
      --url http://qvs.qiniuapi.com/v1/imagelibs\
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --data '{
    	"libIds":["xxx1","yyy2"]
        }'
    

**响应示例**

    
    
    {
      "code": 200
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 查询图像底库

#  查询图像底库

最近更新时间: 2022-12-12 11:47:42

# **描述**

本接口用于获取图像底库列表。

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

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
libId | 是 | string | 图像库ID。  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
id | string | 库id  
name | string | 库名称  
desc | string | 备注描述  
createdAt | integer | 库创建时间  
  
# **示例**

**请求示例**

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

**响应示例**

    
    
    {
    
          "id": "xxxx",
          "name": "test0016",
          "desc": "this is a test",
          "createdAt": 1586850533
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 更新图像底库

#  更新图像底库

最近更新时间: 2022-12-12 11:47:55

# **描述**

本接口用于更新图像库信息。

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

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
libId | 是 | 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 | 图像库描述  
  
# **示例**

**请求示例**

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

**响应示例**

    
    
    {
      "id": "d102sns2mwhd",
      "name": "123",
      "desc": "hello",
      "createdAt": 1585104103
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 创建图像底库

#  创建图像底库

最近更新时间: 2022-12-12 11:47:49

# **描述**

图像底库是一组图像的集合, 和AI模板配合使用。 AI模板里的某些算法，需要依赖图像底库进行比对，例如人脸识别。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：POST
  * 接口路径：`/v1/imagelibs`

# **请求参数**

**Body**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
name | 是 | string | 库名称，可包含字母、数字、中划线、下划线  
desc | 否 | string | 备注  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
name | string | 库名称  
id | string | 库ID  
desc | string | 描述  
createdAt | integer | 创建时间  
  
# **示例**

**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/imagelibs \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
      --header 'content-type: application/json' \
      --data '{
    	"name":"test0013",
    	"desc":"this is a test"
    }'
    

**响应示例**

    
    
    {
      "id": "2akrars59hm2l",
      "name": "test0013",
      "desc": "this is a test",
      "createdAt": 1586847620
    }
    

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

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 模板管理相关接口
>[图像底库](https://developer.qiniu.com/qvs/api/12173/the-bottom-of-the-image-
library) > 实体列表

#  实体列表

最近更新时间: 2022-12-22 11:25:59

# **描述**

本接口用于获取图像库里的所有实体信息。

  * 接口请求域名：`qvs.qiniuapi.com`
  * 请求方式：GET
  * 接口路径：`/v1/imagelibs/{libId}/entities?offset=<offset>&line=<line>&match=<match>&sortBy=<sortBy>`
  * Get请求，通过`非SDK`方式调用的客户，http头部Content-Type,`要么设置为application/x-www-form-urlencoded`,`要么置空`, `要么不要携带`; [公共http header说明 __](https://developer.qiniu.com/qvs/6709/qvs-http-headers)

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
libId | 是 | string | 图像库ID  
line | 否 | integer | 一次返回多少条，最多1000,当超过1000条时，需要结合offset 循环读取  
offset | 否 | integer | 偏移量，当需要循环读取时,初始值offset = 0, 第N次请求时offset = (N -1) * line  
sort | 否 | string | 默认按创建时间降序排列，sort由"asc/desc"和可参与排序的字段组成，其中 asc 表示升序，desc 表示降序  
match | 否 | string | 模糊匹配查询(名称或者证件号包含{match})  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
libId | string | 库id  
name | string | 库名称  
desc | string | 备注描述  
createdAt | integer | 库创建时间  
items | 图像库里的所有实体 | 数组  
items.id | string | 实体id  
items.urls | 数组 | 实体的图像地址的数组  
items.name | string | 姓名  
items.gender | string | 性别 male 或 female  
items.phoneNum | string | 手机号  
items.certNum | string | 证件号  
items.Addr | string | 地址  
items.desc | string | 备注描述  
items.createdAt | integer | 图像创建时间  
total | integer | 总数量  
  
# **示例**

**请求示例**

    
    
    curl --request GET \
      --url http://qvs.qiniuapi.com/v1/imagelibs/xxx/entities \
      --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
    

**响应示例**

    
    
    {
      "items": [
        "libId":"xxx",
        "name":"imagelib",
        {
          "id": "2akrars5b81f5",
          "urls":["https://yyy/yy/yy"],
          "name": "test0016",
          "desc": "this is a test",
          "createdAt": 1586850533
        },
        {
          "id": "d102sns2mwhd",
          "urls":["https://ttt.com/rts"],
          "name": "test009",
          "createdAt": 1585104103
        }
      ],
      "total": 2
    }
    

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

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

#  删除模板

最近更新时间: 2020-05-06 15:31:41

# **描述**

本接口用于删除模版

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

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
templateId | 是 | string | 模版ID  
  
# **响应参数**

无

# **示例**

**请求示例**

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

**响应示例**

    
    
    {
      "code": 200
    }
    

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

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

#  更新模板

最近更新时间: 2022-03-11 15:43:42

# **描述**

本接口用于更新模版信息。

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

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
templateId | 是 | 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 | 模版描述  
bucket | string | 模版对应的对象存储的bucket  
deleteAfterDays | integer | 存储过期时间，默认永久不过期  
fileType | integer | 文件存储类型，取值：0（普通存储），1（低频存储）  
recordType | integer | 录制模式，取值：0（不录制），1（实时录制），2(按需录制)  
jpgOverwriteStatus | boolean | 开启覆盖式截图(一般用于流封面)  
recordInterval | integer | 录制文件时长，单位为秒，600~7200  
snapInterval | integer | 截图间隔，单位为秒，1~600，按需截图可以忽略  
jpgSequenceStatus | boolean | 开启实时截图  
jpgOnDemandStatus | boolean | 开启按需截图  
recordFileFormat | integer | 录制文件存储格式(多选)，范围：1(001)～7(111), 从左往右的三位二进制数分别代表MP4，FLV，M3U8；0代表不选择该格式，1代表选择；例如：2(010)代表选择FLV格式，6(110)代表选择MP4和FLV格式，1(001)代表选择M3U8格式，7(111)代表三种格式均选择  
  
# **响应参数**

响应参数与创建模板一致，请参阅**创建模板**[响应参数
__](https://developer.qiniu.io/qvs/api/6721/create-template#3)

# **示例**

**请求示例**

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

**响应示例**

    
    
    {
      "id": "d102sns2mwhd",
      "name": "test009",
      "bucket": "bucket-test1",
      "deleteAfterDays": 0,
      "templateType": 0,
      "fileType": 0,
      "recordType": 1,
      "recordFileFormat": 1,
      "tsFileNameTemplate": "record/ts/${namespaceId}/${streamId}/${startMs}-${endMs}.ts",
      "recordSnapFileNameTemplate": "record/snap/${namespaceId}/${streamId}/${startMs}.jpg",
      "jpgOverwriteStatus": false,
      "jpgSequenceStatus": false,
      "jpgOnDemandStatus": false,
      "snapInterval": 10,
      "createdAt": 1585104103,
      "updatedAt": 1586849432
    }
    

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

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

#  查询模板信息

最近更新时间: 2022-03-11 15:45:08

# **描述**

本接口用于查询模版。

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

# **请求参数**

**路径参数**

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
templateId | 是 | string | 模版ID  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
name | string | 模版名称  
desc | string | 模版描述  
bucket | string | 模版对应的对象存储的bucket  
deleteAfterDays | integer | 存储过期时间，默认永久不过期  
fileType | integer | 文件存储类型，取值：0（普通存储），1（低频存储）  
recordFileFormat | integer | 录制文件存储格式(多选)，范围：1(001)～7(111)，从左往右的三位二进制数分别代表MP4，FLV，M3U8；0代表不选择该格式，1代表选择；例如：2(010)代表选择FLV格式，6(110)代表选择MP4和FLV格式，1(001)代表选择M3U8格式，7(111)代表三种格式均选择  
templateType | integer | 模板类型，取值：0（录制模版），1（截图模版）  
recordType | integer | 录制模式，取值：0（不录制），1（实时录制），2（按需录制）  
jpgOverwriteStatus | boolean | 开启覆盖式截图(一般用于流封面)  
jpgSequenceStatus | boolean | 开启实时截图  
jpgOnDemandStatus | boolean | 开启按需截图  
tsFileNameTemplate | string | ts文件命名格式  
m3u8FileNameTemplate | string | m3u8文件命名格式  
flvFileNameTemplate | string | flv文件命名格式  
mp4FileNameTemplate | string | mp4文件命名格式  
jpgOverwriteFileNameTemplate | string | 覆盖式截图文件命名格式  
jpgSequenceFileNameTemplate | string | 实时截图文件命名格式  
recordInterval | integer | 录制文件时长，单位为秒，600~7200  
snapInterval | integer | 截图间隔，单位为秒，1~600，按需截图可以忽略  
createdAt | integer | 模板创建时间  
updatedAt | integer | 模板更新时间  
zone | string | 模板的bucket区域  
  
# **示例**

**请求示例**

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

**响应示例**

    
    
    {
      "id": "2akrars59hm2l",
      "name": "test0013",
      "desc": "this is a test",
      "bucket": "bucket-test1",
      "deleteAfterDays": 0,
      "templateType": 1,
      "fileType": 0,
      "recordType": 0,
      "recordFileFormat": 0,
      "jpgOverwriteStatus": true,
      "jpgSequenceStatus": true,
      "jpgOnDemandStatus": true,
      "jpgOverwriteFileNameTemplate": "snapshot/jpg/${namespaceId}/${streamId}.jpg",
      "jpgSequenceFileNameTemplate": "snapshot/jpg/${namespaceId}/${streamId}/${startMs}.jpg",
      "jpgOnDemandFileNameTemplate": "snapshot/jpg/${namespaceId}/${streamId}/ondemand/${startMs}.jpg",
      "createdAt": 1586847620,
      "updatedAt": 1586847620,
      "snapInterval": 5,
      "zone": "z1"
    }
    

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

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

#  更新域名信息

最近更新时间: 2022-01-14 10:43:59

# **描述**

本接口用于更新域名信息

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

# **请求参数**

**路径参数**

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

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

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

参数名称 | 字段类型 | 说明  
---|---|---  
isDefault | boolean | 是否默认域名  
  
# **响应参数**

参数名称 | 类型 | 说明  
---|---|---  
domain | Object | 域名信息  
domain.domain | string | 域名  
domain.type | string | 域名类型 “publishRtmp”:rtmp推流, “liveRtmp”: rtmp播放, “liveHls”: HLS, “liveHdl”: HDL, “liveWebrtc”: webrtc, “live”: 统一播放  
domain.cname | integer | cname  
domain.state | integer | 0: 未配置CNAME，1: 可用，2: 不可用  
domain.isDefault | boolean | 是否默认域名  
domain.createdAt | integer | 创建时间  
domain.playSecurity | object | 时间戳防盗链  
domain.playSecurity.open | boolean | 时间戳防盗链开关  
domain.playSecurity.expireAfter | integer | 时间戳过期时长，单位：秒  
domain.playSecurity.primary | string | 主KEY  
domain.playSecurity.secondary | string | 备用KEY  
domain.httpsSwitch | object | https开关  
domain.httpsSwitch.certid | string | 证书id  
domain.httpsSwitch.httpsOpen | boolean | https开关  
  
以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控删除域名

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

#  删除域名

最近更新时间: 2022-04-29 12:20:50

# **描述**

本接口用于创建域名相关信息, 仅适用于空间模式为`静态地址`的空间。

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

# **请求参数**

**路径参数**

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

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？
human: 如何处理七牛云的视频监控修改域名时间戳防盗链配置

gpt: [视频监控](https://developer.qiniu.com/qvs) > API 文档 > 域名管理相关接口 >修改域名时间戳防盗链配置

#  修改域名时间戳防盗链配置

最近更新时间: 2022-09-26 10:41:39

本接口用于修改时间戳防盗链配置

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

# **请求参数**

**路径参数**

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

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
open | 是 | boolean | 时间戳防盗链开关  
expireAfter | 是 | integer | 防盗链过期时长（单位：秒）  
primary | 是 | string | 主KEY  
secondary | 是 | string | 备用KEY  
  
**请求示例**

    
    
    curl --request POST \
      --url http://qvs.qiniuapi.com/v1/namespaces/3nm4x0vyz7xlu/domains/qvs-live-webrtc1.vs.qnlinking.com/playsecurity \
      --header 'authorization: Qiniu your_authorization_token' \
      --header 'content-type: application/json' \
      --data '{"open":true,"expireAfter":3600,"primary":"your_primary_key","secondary":"your_sencondary_key"}'
    

**响应示例**

    
    
    {"code":200}
    

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

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

#  创建域名

最近更新时间: 2022-04-29 12:21:25

# **描述**

本接口用于创建域名相关信息, 仅适用于空间模式为`静态地址`的空间。

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

# **请求参数**

**路径参数**

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

参数名称 | 必填 | 字段类型 | 说明  
---|---|---|---  
domain | 是 | string | 域名  
type | 是 | string | 类型,"publishRtmp"代表域名用于推流(`仅适用RTMP类型空间`), "live"代表域名用于播放(`适用所有类型的空间`)  
  
# **响应参数**

    
    
    {
      "code": 200
    }
    

以上内容是否对您有帮助？