調用OpenLiveShift為指定域名(應用、直播流)開啟時移服務。
使用說明
時移和延遲轉碼目前暫不能同時配置。
QPS限制
本接口的單用戶QPS限制為10次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | OpenLiveShift | 系統規定參數。取值:OpenLiveShift。 |
DomainName | String | 是 | example.com | 播流域名。 |
AppName | String | 否 | liveApp**** | 直播流所屬應用名稱。支持通配符*,代表該域名下所有的AppName。 |
StreamName | String | 否 | liveStream**** | 直播流流名稱。支持通配符*,代表該AppName下所有的StreamName。 |
Duration | Integer | 否 | 3 | HLS的ts切片的長度。單位:秒。 |
Vision | Integer | 否 | 10 | 表示數據保留時長。默認保留7天,單位:天。 |
IgnoreTranscode | Boolean | 否 | true | 是否忽略對應轉碼流生成時移。取值:
默認選擇為true。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 | 請求ID。 |
示例
請求示例
http(s)://live.aliyuncs.com/?Action=OpenLiveShift
&DomainName=example.com
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<OpenLiveShiftResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</OpenLiveShiftResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
特殊錯誤碼
錯誤代碼 |
描述 |
HTTP 狀態碼 |
語義 |
InvalidParam |
param error |
400 |
用戶參數錯誤。 |
InvalidDataNotFound |
data not found |
404 |
用戶數據未找到。 |
文檔內容是否對您有幫助?