All Products
Search
Document Center

CDN:BatchDescribeCdnIpInfo

Last Updated:Mar 28, 2026

Queries whether one or more IP addresses are assigned to Alibaba Cloud CDN.

Operation description

Note

The maximum number of times that each user can call this operation per second is 20.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

IpAddrList

string

Yes

The list of IP addresses to query. Separate IP addresses with commas (,). You can specify up to 20 IP addresses at a time.

Note
  • Example of an IPv4 address: 192.0.2.1

  • Example of an IPv6 address: 2001:db8:ffff:ffff:ffff:****:ffff.

111.XXX.XXX.230,47.XXX.XXX.243

Language

string

No

The language of the query results. Valid values:

  • zh (default): Simplified Chinese.

  • en: English.

Valid values:

  • en :

    en

  • zh :

    zh

en

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The ID of the request.

55ADD936-763F-5E1A-BF54-2EA3F6E94A52

IpInfoList

array<object>

The results about IP addresses returned.

object

IpAddress

string

The IP address.

111.XXX.XXX.230

IspName

string

The ISP to which the IP address belongs.

Move

Country

string

The country to which the IP address belongs.

China

Province

string

The province to which the IP address belongs.

Beijing

City

string

The city to which the IP address belongs.

Beijing

CdnIp

string

Indicates whether the IP address belongs to an Alibaba Cloud CDN point of presence (POP).

  • true

  • false

true

Examples

Success response

JSON format

{
  "RequestId": "55ADD936-763F-5E1A-BF54-2EA3F6E94A52",
  "IpInfoList": [
    {
      "IpAddress": "111.XXX.XXX.230",
      "IspName": "China Mobile",
      "Country": "China",
      "Province": "Beijing",
      "City": "Beijing",
      "CdnIp": "true"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvaildBatchIp.LengthTooLong The batchIp parameter is too long The length of the IP addresses exceeds the limit.
403 InvaildParameter The parameter you provided is invalid. The format of the domain name is invalid. Correct the format and try again.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.