创建全球加速实例并绑定到直播链路。
接口说明
-
本接口用于创建全球加速实例并绑定到直播链路,需要精确到流粒度,并指明加速的起点和终点。
-
AppName 与 StreamName 的名称与播流地址中的 AppName 与 StreamName 的名称对应模板才能生效。
QPS 限制
本接口的单用户 QPS 限制为 50 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
live:CreateLivePrivateLine |
*Domain
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
RegionId |
string |
否 |
地域 ID。 |
cn-shanghai |
DomainName |
string |
是 |
主播流域名。 |
demo.aliyundoc.com |
AppName |
string |
是 |
应用名称。 |
live |
StreamName |
string |
是 |
直播流名称。 |
testStream |
VideoCenter |
string |
是 |
直播中心,取值:cn-beijing、cn-shanghai、cn-shenzhen、cn-qingdao、ap-northeast-1、ap-southeast-5、eu-central-1、ap-southeast-1、ap-south-1,分别表示位于北京、上海、深圳、青岛、日本、印尼、德国、新加坡的直播中心。 |
cn-shanghai |
AccelerationType |
string |
是 |
加速类型,取值:
|
play |
AccelerationArea |
string |
是 |
加速通道。 |
ap-southeast-1 |
Reuse |
string |
是 |
是否复用已有加速通道,取值:
|
no |
MaxBandwidth |
string |
否 |
加速带宽,单位:Mbps。当 Reuse 为 no 时必填。 |
200 |
InstanceId |
string |
否 |
复用的加速通道。当 Reuse 为 yes 时必填。 |
ga-bp1iovsdpf01ym9su**** |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
返回数据。 |
||
RequestId |
string |
请求 ID。 |
7908F2FF-44F8-120F-9FD6-85AE4B6C**** |
示例
正常返回示例
JSON
格式
{
"RequestId": "7908F2FF-44F8-120F-9FD6-85AE4B6C****"
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | InvalidParam | Parameter invalid. | 输入参数不合法 |
400 | NoSpecialConfiguration | no special configuration for acceleration_area. | |
400 | ConfigAlreadyExists | Config has already exist. | |
400 | HasNoPermission | You do not have permission to create accelerator. | |
400 | PostPayNotOpen | The Accelerator PostPay service is not open. | |
400 | TryAgain | Create SLR first and please try again. | |
400 | HasNoPermisionToCreateSLR | You do not have ram:CreateServiceLinkedRole to create SLR. | |
500 | InternalError | The request processing has failed due to backend service exception. |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。