停用设备本地历史流

最近更新时间:2026-03-19 18:16:28

天翼云智能视图服务API

1. 停用设备本地历史流

接口功能介绍

本接口用于停止设备本地侧的录像文件的历史流。

接口约束

仅支持gb28181设备。

URI

PUT /devices/{DeviceId}/local/vod/streams/stopPlay

路径参数

参数是否必填参数类型说明示例下级对象
DeviceIdString设备ID。32388487739092996

Query参数

请求参数

请求头header参数

参数是否必填参数类型说明示例下级对象
AuthorizationString认证信息。CT-HMAC-SHA256 Credential=FQ01GA2RR9IJFM1PWIPR/2023-07-18/vss, SignedHeaders=content-type;host;timestamp, Signature=c6e72dffcfb2d25d276e119781e1deb6656d966702191b2bd862d1691e39394f
Content-TypeString互联网媒体类型。application/json;charset=utf-8
HostString主机。vssapi.ctyun.cn
VersionString版本。2021-11-25
TimestampString时间戳。1689643309

请求体body参数

参数是否必填参数类型说明示例下级对象
StreamNameString本地录像流名。如点播流播放地址http://vssapi.ctyun.cn/vod/1346442491779596288\_1757904633\_1757906997\_857419.flv, 则流名为1346442491779596288_1757904633_1757906997_857419。1346442491779596288_1757904633_1757906997_857419

响应参数

参数参数类型说明示例下级对象
statusCodeInteger响应状态码。200
errorString错误码,执行成功时,不返回该字段。VSS_0001
messageString响应信息。请求成功
requestIdString请求ID。362d4e78556b47129182d0881fade86b
returnObjObject响应数据,执行失败时,不返回该字段。returnObj

表 returnObj

参数参数类型说明示例下级对象
RequestIdString请求ID。b0c9ab08303842e0bb47c0215b5718b2

请求示例

请求url

PUT '/devices/1346442491779596288/local/vod/streams/stopPlay'

请求头header

{
    "Authorization": "CT-HMAC-SHA256 Credential=3GBQOX3K68SDJTHBM0WE/2023-05-06/vss, SignedHeaders=content-type;host;timestamp, Signature=ae52b98ae17b549ccce45881208333baf5b01dbb0425674ec54725a78ba18f4b",
    "Content-Type": "application/json;charset=utf-8",
    "Host": "vssapi.ctyun.cn",
    "Version": "2021-11-25",
    "Timestamp": "1683352745"
}

请求体body

{
  "StreamName":"1346442491779596288_1757904633_1757906997_490512"
}

响应示例

{
  "statusCode": 200,
  "message": "请求成功",
  "requestId": "b0c9ab08303842e0bb47c0215b5718b2",
  "returnObj": {
    "RequestId": "b0c9ab08303842e0bb47c0215b5718b2"
  }
}

状态码

请参考状态码说明。

错误码

请参考错误码说明。