调用CreateLivePrivateLine创建全球加速实例并绑定到直播链路。
本接口用于创建全球加速实例并绑定到直播链路,需要精确到流粒度,并指明加速的起点和终点。
QPS限制
本接口的单用户QPS限制为50次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | CreateLivePrivateLine | 系统规定参数。取值:CreateLivePrivateLine。 |
DomainName | String | 是 | demo.aliyundoc.com | 主播流域名。 |
AppName | String | 是 | live | 应用名称。 |
StreamName | String | 是 | testStream | 直播流名称。 |
VideoCenter | String | 是 | cn-shanghai | 直播中心,取值:cn-beijing、cn-shanghai、cn-shenzhen、cn-qingdao、ap-northeast-1、ap-southeast-5、eu-central-1、ap-southeast-1、ap-south-1,分别表示位于北京、上海、深圳、青岛、日本、印尼、德国、新加坡的直播中心。 |
AccelerationType | String | 是 | play | 加速类型,取值:
|
AccelerationArea | String | 是 | ap-southeast-1 | 加速通道。 |
Reuse | String | 是 | no | 是否复用已有加速通道,取值:
|
MaxBandwidth | String | 否 | 200 | 加速带宽,单位:Mbps。当Reuse为no时必填。 |
InstanceId | String | 否 | ga-bp1iovsdpf01ym9su**** | 复用的加速通道。当Reuse为yes时必填。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 7908F2FF-44F8-120F-9FD6-85AE4B6C**** | 请求ID。 |
示例
请求示例
https://live.aliyuncs.com?Action=CreateLivePrivateLine&DomainName=demo.aliyundoc.com&AppName=live&StreamName=testStream&VideoCenter=cn-shanghai&AccelerationType=play&AccelerationArea=ap-southeast-1&Reuse=no&Max_bandwidth=200&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateLivePrivateLineResponse>
<RequestId>7908F2FF-44F8-120F-9FD6-85AE4B6C19EC</RequestId>
</CreateLivePrivateLineResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "7908F2FF-44F8-120F-9FD6-85AE4B6C19EC"
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
400 | ConfigAlreadyExists | Config has already exist. | 配置已添加。 |
访问错误中心查看更多错误码。