调用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 | 区域类型,取值:
|
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 |
后台发生未知错误。 |