Retrieves a list of assets that access domain names through a VPC firewall.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| Lang |
string |
No |
The language of the content within the request and response. Valid values:
|
zh |
| StartTime |
string |
Yes |
The start time. The value is a Unix timestamp that is accurate to the second. |
1656664560 |
| EndTime |
string |
Yes |
The end time. The value is a Unix timestamp that is accurate to the second. |
1656750960 |
| PageSize |
string |
No |
The number of entries to return on each page. |
10 |
| CurrentPage |
string |
No |
The current page number. |
1 |
| IP |
string |
No |
The IP address of the asset. |
47.92.x.x |
| Domain |
string |
No |
The domain name. |
www.****.com |
| Sort |
string |
No |
The sort order. Valid values: `asc`, `desc`. |
desc |
| Order |
string |
No |
The field to sort by. Default value: TotalBytes. Valid values: TotalBytes: Sorts by total traffic. SessionCount: Sorts by the number of sessions. |
SessionCount |
| VpcId |
string |
No |
The VPC where the asset resides. |
vpc-m5ewlqkuf7orclr1**** |
| IsAITraffic |
string |
No |
Specifies whether to count only the traffic that is used to access AI services. |
true |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| TotalCount |
integer |
The total number of entries returned. |
132 |
| RequestId |
string |
The ID of the request. |
C5BE1AA4-934A-5085-89CC-9AD1CAC3**** |
| DataList |
array<object> |
The returned data. |
|
|
object |
The data list. |
||
| IP |
string |
The IP address of the asset. |
a.com |
| VpcId |
string |
The VPC where the asset resides. |
a.com |
| TotalBytes |
integer |
The total traffic in bytes. |
253023143 |
| SessionCount |
integer |
The number of sessions. |
12 |
| IpsHitCnt |
integer |
The number of intrusion prevention system (IPS) hits. |
10 |
| VpcName |
string |
The name of the VPC where the asset resides. |
vpc-bp1mos0vhefmx5ah6**** |
Examples
Success response
JSON format
{
"TotalCount": 132,
"RequestId": "C5BE1AA4-934A-5085-89CC-9AD1CAC3****",
"DataList": [
{
"IP": "a.com",
"VpcId": "a.com",
"TotalBytes": 253023143,
"SessionCount": 12,
"IpsHitCnt": 10,
"VpcName": "vpc-bp1mos0vhefmx5ah6****"
}
]
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ErrorAliUid | Aliuid invalid. | The aliuid is invalid. |
| 400 | ErrorTimeError | The time is invalid. | The time is invalid. |
| 400 | ErrorDBSelectError | A database select error occurred. | The error message returned because an internal error has occurred in querying the database. |
| 400 | ErrorIntervalError | The interval is invalid. | The interval is invalid. |
| 400 | ErrorIpFormat | The IP address is invalid. | The IP address is invalid. |
| 400 | ErrorSecuritySuggest | The security suggest is invalid. | The security suggest is invalid. |
| 400 | ErrorSortError | The sort is invalid. | The sort is invalid. |
| 400 | ErrorOrderFailed | The order is invalid. | The order is invalid. |
| 400 | ErrorPageNo | Either page number or page size is invalid. | Either page number or page size is invalid. |
| 400 | ErrorDomainName | The domain name is invalid. | The domain name is invalid. |
| 400 | ErrorDataTypeError | The data type is invalid. | The data type is invalid. |
| 400 | ErrorMarshalJSON | internal error. | Internal error. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.