You can call this operation to perform queries on Anti-DDoS Pro instances.

Request parameters

Name Type Required Description
InstanceIds String No The array of IDs of Anti-DDoS Pro instances represented as a JSON string. Exact match is supported. For example, ["ddoscoo-cn-XXXX1", "ddoscoo-cn-XXXX2"].
Note If this parameter is specified, Ip or Remark is not needed.
Ip String No The IP addresses of Anti-DDoS Pro instances. Exact match is supported.
Note If this parameter is specified, InstanceIds or Remark is not needed.
Remark String No The remarks on the Anti-DDoS Pro instances. Fuzzy match is supported.
Note If this parameter is specified, InstanceIds or Ip is not needed.
PageNo Integer Yes The number of the starting page returned in the query result. Minimum value: 1.
PageSize Integer Yes The number of result records per page. Maximum value: 50.

Response parameters

Name Type Description
Total Integer The total number of Anti-DDoS Pro instances.
Instances Instance The list of Anti-DDoS Pro instances. For more information, see instance.
RequestId String The GUID generated by Alibaba Cloud for the request.
Table 1. instance
Name Type Description
InstanceId String The ID of the Anti-DDoS Pro instance.
Remark String The remark on the Anti-DDoS Pro instance. Maximum length: 500 bytes.
Status Integer The subscription status of the Anti-DDoS Pro instance.
  • 1: Indicates that the subscription of the instance is valid.
  • 2: Indicates that the subscription of the instance has expired.
  • 3: Indicates that the instance has been released.
ExpireTime Long The timestamp when the subscription of the instance expires. Unit: milliseconds.
GmtCreate Long The timestamp when the instance was created. Unit: milliseconds.

Examples

Sample requests 
{
  "InstanceIds": "[\"0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc\",\"0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc\"]",
  "PageNo": 1,
  "PageSize": 1
}
Sample responses 
{
  "Total": 1,
  "Instances": [
    {
      "InstanceId": "0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc",
      "Remark": "xxx",
      "Status": 1,
      "ExpireTime": 20384032,
      "GmtCreate": 2308402384
    }
  ],
  "RequestId": "0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc"
}