All Products
Search
Document Center

CDN:DescribeL2VipsByDomain

Last Updated:Jul 05, 2024

Queries the virtual IP addresses (VIPs) of L2 CDN points of presence (POPs) for a specific domain name.

Operation description

  • This operation is available only to users whose daily peak bandwidth value is higher than 1 Gbit/s. If you meet this requirement, you can submit a ticket to apply for permissions to use this operation.
  • You can call this operation up to 40 times per second per account.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DomainNamestringYes

The accelerated domain name. You can specify only one domain name in each request.

example.com

Response parameters

ParameterTypeDescriptionExample
object
DomainNamestring

The domain name.

example.com
RequestIdstring

The ID of the request.

16A96B9A-F203-4EC5-8E43-CB92E68F4CD8
Vipsarray

The list of VIPs.

string

The VIP.

1.1.1.1/25

Examples

Sample success responses

JSONformat

{
  "DomainName": "example.com",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  "Vips": {
    "Vip": [
      "1.1.1.1/25"
    ]
  }
}

Error codes

HTTP status codeError codeError message
400IllegalOperationIllegal domain operate is not permitted.
400SingleRequest.OverLimitA maximum of 1 DomainName is supported for each request.
403SystemBusyThe system is busy, please try again later.

For a list of error codes, visit the Service error codes.