云服务器内容精选

  • 请求示例 创建直播截图配置。 POST https://{endpoint}/v1/{project_id}/stream/snapshot { "domain" : "play.example.huawei.com", "app_name" : "live", "time_interval" : 5, "object_write_mode" : 1, "obs_location" : { "bucket" : "cls-test", "location" : "region1", "object" : "/ffff/aa/" } }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token,使用Token鉴权方式时必填。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必填,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填,携带项目ID信息。 表3 请求Body参数 参数 是否必选 参数类型 描述 domain 是 String 直播推流 域名 app_name 是 String 应用名称 auth_key 否 String 回调鉴权密钥值 长度范围:[32-128] 若需要使用回调鉴权功能,请配置鉴权密钥,否则,留空即可。 time_interval 是 Integer 截图频率 取值范围:[5-3600] 单位:秒 object_write_mode 是 Integer 在OBS桶存储截图的方式: 0:全保存模式,截图文件名中含时间戳,每条流的所有截图文件均会保存在存储对象里。示例:snapshot/{domain}/{app_name}/{stream_name}/{UnixTimestamp}.jpg 1:覆盖模式,截图文件名不含时间戳,每条流只保存最新的截图文件,新的截图文件会覆盖原来的截图文件。示例:snapshot/{domain}/{app_name}/{stream_name}.jpg obs_location 是 ObsFileAddr object OBS存储位置信息 call_back_enable 否 String 是否启用回调通知 on:启用。 off:不启用。 call_back_url 否 String 通知服务器地址,必须是合法的URL且携带协议,协议支持http和https。截图完成后直播服务会向此地址推送截图状态信息。 表4 ObsFileAddr 参数 是否必选 参数类型 描述 bucket 是 String OBS的bucket名称 location 是 String OBS Bucket所在的区域,且必须保持与使用的直播服务区域保持一致。 object 是 String OBS对象路径,遵守OSS Object定义 当用于指示input时,需要指定到具体对象 当用于指示output时,只需指定到截图结果期望存放的路径