调用CreateStreamSnapshot触发按需截图_视图计算(VECS)-阿里云帮助中心

对指定流，按需创建新的截图。

接口说明

说明需要预先在绑定的截图模板中启用按需截图功能。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
vs:CreateStreamSnapshot	create	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
Id	string	是	流 ID。	323*****997-cn-qingdao
Location	string	否	截图方式。取值范围： center（云端截图）（默认） device（设备截图）	device

返回参数

名称	类型	描述	示例值
	object
OssObject	string	截图文件的 Object。	photos/live/340200*****100049/ondemand-1639126601767.jpg
RequestId	string	请求 ID。	BEA5625F-8FCF-48F4-851B-CA63946DA664
Width	long	图片宽度。	1280
Height	long	图片高度。	720
Url	string	截图文件的 URL。	http://examplebucket.oss-***.aliyuncs.com/photos/live/340200***100049/ondemand-1639126601767.jpg
Timestamp	long	截图时间戳。	1639126601767
OssBucket	string	截图文件的 Bucket。	examplebucket
Format	string	图片格式。	jpg
OssEndpoint	string	截图文件的 OSS Endpoint。	oss-cn-qingdao.aliyuncs.com
Id	string	流 ID。	323*****997-cn-qingdao

示例

正常返回示例

JSON格式

{
  "OssObject": "photos/live/340200*****100049/ondemand-1639126601767.jpg",
  "RequestId": "BEA5625F-8FCF-48F4-851B-CA63946DA664",
  "Width": 1280,
  "Height": 720,
  "Url": "http://examplebucket.oss-*****.aliyuncs.com/photos/live/340200*****100049/ondemand-1639126601767.jpg",
  "Timestamp": 1639126601767,
  "OssBucket": "examplebucket",
  "Format": "jpg",
  "OssEndpoint": "oss-cn-qingdao.aliyuncs.com",
  "Id": "323*****997-cn-qingdao"
}

错误码

访问错误中心查看更多错误码。