全部产品
Search
文档中心

视频直播:查询可选的全球加速链路起点

更新时间:Oct 10, 2023

调用DescribeLivePrivateLineAreas查询可选的全球加速链路起点。

使用说明

在调用CreateLivePrivateLine前,您可以调用该接口查询可选的全球加速区域,即加速链路起点。

QPS限制

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

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String DescribeLivePrivateLineAreas

系统规定参数。取值:DescribeLivePrivateLineAreas

DomainName String demo.aliyundoc.com

主播流域名。

返回数据

名称

类型

示例值

描述

RequestId String C4865B85-664B-19D3-BB16-C62FB83C8226

请求ID。

LiveAreasList Array of LiveArea

区域详情列表。

LiveArea
RegionType String domestic

区域类型,取值:

  • domestic:中国大陆。
  • overseas:除中国大陆以外的国家和地区。
Regions Array of Region

区域列表。

Region
RegionId String cn-shenzhen

区域ID。

LocalName String 深圳

区域名。

示例

请求示例

https://live.aliyuncs.com?Action=DescribeLivePrivateLineAreas&DomainName=demo.aliyundoc.com&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLivePrivateLineAreasResponse>
    <RequestId>C4865B85-664B-19D3-BB16-C62FB83C8226</RequestId>
    <LiveAreasList>
        <LiveArea>
            <RegionType>domestic</RegionType>
            <Regions>
                <Region>
                    <LocalName>深圳</LocalName>
                    <RegionId>cn-shenzhen</RegionId>
                </Region>
            </Regions>
        </LiveArea>
        <LiveArea>
            <RegionType>overseas</RegionType>
            <Regions>
                <Region>
                    <LocalName>新加坡</LocalName>
                    <RegionId>ap-southeast-1</RegionId>
                </Region>
            </Regions>
        </LiveArea>
    </LiveAreasList>
</DescribeLivePrivateLineAreasResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C4865B85-664B-19D3-BB16-C62FB83C8226",
  "LiveAreasList" : {
    "LiveArea" : [ {
      "RegionType" : "domestic",
      "Regions" : {
        "Region" : [ {
          "LocalName" : "深圳",
          "RegionId" : "cn-shenzhen"
        } ]
      }
    }, {
      "RegionType" : "overseas",
      "Regions" : {
        "Region" : [ {
          "LocalName" : "新加坡",
          "RegionId" : "ap-southeast-1"
        } ]
      }
    } ]
  }
}

错误码

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

特殊错误码

错误代码

描述

HTTP状态码

语义

InvalidDomain.NotFound

The domain provided does not exist in our records.

404

当前账户下未查到域名。

InvalidParam

Parameter invalid.

400

参数错误。

InternalError

The request processing has failed due to some unknown error.

500

后台发生未知错误。