You can call the DescribeUserVipsByDomain operation to query VIP users by domain name.

Request parameters

Parameter Type Required Description
Action String  Yes The operation that you want to perform. Set this parameter to DescribeUserVipsByDomain.
DomainName String Yes. The name of the CDN domain to query VIP users for. You can specify only one domain name per request.
Available String Yes Specifies which VIP users to query. Valid values: on and off.
  • on: queries VIP users that are accessible.
  • off: queries all VIP users.

Response parameters

Parameter Type Description
DomainName String The domain name.
Vips Vip[] The IP addresses of the VIP users.
RequestID String The ID of the request.

Examples

Sample request

https://cdn.aliyuncs.com?Action=DescribeUserVipsByDomain&Available=on&DomainName=example.com&<Common request parameters>

Sample success response

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

Error code Error message HTTP status code Description
MissingParameter The specified value of parameter "DomainName" can not be empty. 400 The error message returned because the DomainName parameter is not specified.