You need to enable JavaScript to run this app.
文档中心
文档控制台
注册
智能视联

智能视联

复制全文
下载 pdf
云眸协议
DeleteHikCloudSnapshot - 删除历史截图
复制全文
下载 pdf
DeleteHikCloudSnapshot - 删除历史截图

删除单条历史截图:级联删除 TOS 对象与 Mongo 记录(TOS 删除失败不阻断)。不存在/已删除/已被 GC 清理返 NotFound.Snapshot,非本人空间返 forbidden。

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数
类型
是否必填
示例值
描述
Action
String

DeleteHikCloudSnapshot

要执行的操作,取值:DeleteHikCloudSnapshot。

Version
String

2026-07-01

API的版本,取值:2026-07-01。

Body

参数
类型
是否必填
示例值
描述
SnapshotID
String

c6b25f47-61fa-4a12-bfd9-8f5251c6fd5f

截图 ID

返回参数

本接口无特有的返回参数。更多信息请见返回结构

请求示例

POST /?Action=DeleteHikCloudSnapshot&Version=2026-07-01 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20260711T120000Z
X-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Authorization: HMAC-SHA256 Credential=AKLT********/20260711/cn-beijing/aiotvideo/request, SignedHeaders=host;x-content-sha256;x-date, Signature=****************************************

{
  "SnapshotID": "c6b25f47-61fa-4a12-bfd9-8f5251c6fd5f"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2026071120000000000000000000000000",
    "Action": "DeleteHikCloudSnapshot",
    "Version": "2026-07-01",
    "Service": "aiotvideo",
    "Region": "cn-beijing",
    "Error": null
  },
  "Result": {}
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
403
forbidden

Access denied

空间不属于当前 AccountID

404
NotFound.Snapshot

Snapshot not found

截图不存在、已删除或已被 GC 清理

500
hik_cloud_not_configured

HikCloud service not configured

服务未配置 master_key 或 TOS

最近更新时间:2026.07.31 18:01:11
这个页面对您有帮助吗?
有用
有用
无用
无用