Queries virtual IP addresses of CDN edge nodes by domain name.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeUserVipsByDomain |
The operation that you want to perform. Set the value to DescribeUserVipsByDomain. |
DomainName | String | Yes | example.com |
The accelerated domain name. You can specify only one domain name. |
Available | String | No | on |
Specifies whether to query the virtual IP addresses of only healthy CDN edge nodes. Valid values: Valid values:
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
DomainName | String | example.com |
The domain name. |
RequestId | String | 820E7900-5CA9-4AEF-B0DD-20ED5F64BE55 |
The ID of the request. |
Vips | List | 122.72.xxx.xxx |
A list of virtual IP addresses. |
Examples
Sample requests
http(s)://cdn.aliyuncs.com/?Action=DescribeUserVipsByDomain
&DomainName=example.com
&Available=on
&<Common request parameters>
Sample success responses
XML
format
<DescribeUserVipsByDomainResponse>
<Vips>
<Vip>122.72.xxx.xxx</Vip>
<Vip>119.14.xxx.xxx</Vip>
<Vip>221.13.xxx.xxx</Vip>
<Vip>124.95.xxx.xxx</Vip>
<Vip>58.211.xxx.xxx</Vip>
</Vips>
<RequestId>820E7900-5CA9-4AEF-B0DD-20ED5F64BE55</RequestId>
<DomainName>example.com</DomainName>
</DescribeUserVipsByDomainResponse>
JSON
format
{
"Vips": {
"Vip": [
"122.72.xxx.xxx",
"119.14.xxx.xxx",
"221.13.xxx.xxx",
"124.95.xxx.xxx",
"58.211.xxx.xxx"
]
},
"RequestId": "820E7900-5CA9-4AEF-B0DD-20ED5F64BE55",
"DomainName": "example.com"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | MissingParameter | The specified value of parameter "DomainName" can not be empty. | The error message returned because the DomainName parameter is not set. |
400 | IllegalOperation | Illegal domain operate is not permitted. | The error message returned because the specified operation is invalid. |
For a list of error codes, visit the API Error Center.