Checks whether a specified IP address belongs to an Alibaba Cloud CDN node.

QPS limit

You can call this operation up to 30 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limit on an API operation in ApsaraVideo Live.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeLiveIpInfo

The operation that you want to perform. Set the value to DescribeLiveIpInfo.

IP String Yes 192.168.0.1

The IP address that you want to check. You can specify only one IP address in each call.

Response parameters

Parameter Type Example Description
IspEname String telecom

The English name of the Internet service provider (ISP).

RequestId String 1B1D0EE7-9559-489D-BC4E-279495EB8FB8

The ID of the request.

RegionEname String China-Guizhou-guiyang

The English name of the region.

ISP String 电信

The Chinese name of the ISP.

Region String 中国-贵州省-贵阳市

The Chinese name of the region.

Examples

Sample request

http(s)://live.aliyuncs.com/?Action=DescribeLiveIpInfo
&IP=192.168.0.1
&Common request parameters

Sample success responses

XML format 

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

<DescribeLiveIpInfoResponse>
    <RegionEname>China-Guizhou-guiyang</RegionEname>
    <Region>中国-贵州省-贵阳市</Region>
    <IspEname>telecom</IspEname>
    <RequestId>1B1D0EE7-9559-489D-BC4E-279495EB8FB8</RequestId>
    <ISP>电信</ISP>
</DescribeLiveIpInfoResponse>

JSON format 

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

{
  "RegionEname" : "China-Guizhou-guiyang",
  "Region" : "中国-贵州省-贵阳市",
  "IspEname" : "telecom",
  "RequestId" : "1B1D0EE7-9559-489D-BC4E-279495EB8FB8",
  "ISP" : "电信"
}

Error codes

For a list of error codes, visit the API Error Center.