调用OpenLiveShift为指定域名(应用、直播流)开启时移服务。

使用说明

时移和延迟转码目前暂不能同时配置。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String OpenLiveShift

系统规定参数。取值:

OpenLiveShift

DomainName String example.com

播流域名。

RegionId String cn-shanghai

地域ID。

AppName String liveApp****

直播流所属应用名称。支持通配符*,代表该域名下所有的AppName。

StreamName String liveStream****

直播流流名称。支持通配符*,代表该AppName下所有的StreamName。

Duration Integer 3

HLS的ts切片的长度。单位:秒。

Vision Integer 10

表示数据保留时长。默认保留7天,单位:天。

IgnoreTranscode Boolean true

是否忽略对应转码流生成时移。取值:

  • true:转码流不生成时移。
  • false:转码流生成时移。

默认选择为true。

返回数据

名称 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=OpenLiveShift
&DomainName=example.com
&<公共请求参数>

正常返回示例

XML格式

<OpenLiveShiftResponse>
      <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</OpenLiveShiftResponse>

JSON格式

{
    "OpenLiveShiftResponse": {
        "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
    }
}

错误码

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

特殊错误码

错误代码

描述

HTTP 状态码

语义

InvalidParam

param error

400

用户参数错误。

InvalidDataNotFound

data not found

404

用户数据未找到。