All Products
Search
Document Center

Cloud Firewall:DescribeVpcFirewallTrafficAssetList

Last Updated:Jan 09, 2026

Retrieves a list of assets that access domain names through a VPC firewall.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

Lang

string

No

The language of the content within the request and response. Valid values:

  • zh (default): Chinese

  • en: English

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.