All Products
Search
Document Center

Cloud Firewall:DescribePostpayTrafficTotal

Last Updated:Sep 02, 2024

Queries the total volume of traffic that is billed based on the pay-as-you-go billing method, including all firewalls within the current account.

Operation description

You can call this operation to query statistics of the current Cloud Firewall from the date of purchase.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
yundun-cloudfirewall:DescribePostpayTrafficTotalget
  • All Resources
    *
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
LangstringNo

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

  • zh (default): Chinese
  • en: English
zh

Response parameters

ParameterTypeDescriptionExample
object
TotalAssetslong

The total number of assets protected all types of firewalls.

132
RequestIdstring

The ID of the request.

826B6280-9704-5643-97B1-6B47AC3F027A
TotalTrafficlong

The total volume of traffic. If you use Cloud Firewall that uses the subscription billing method, this parameter indicates the total volume of burstable protected traffic. Unit: bytes.

2320274874426
TotalNatAssetslong

The total number of assets protected by NAT firewalls.

1
TotalNatTrafficlong

The total traffic for NAT firewalls. If you use Cloud Firewall that uses the subscription billing method, this parameter indicates the total volume of burstable protected traffic on the NAT boundary. Unit: bytes.

560646279
TotalVpcAssetslong

The total number of assets protected by virtual private cloud (VPC) firewalls.

3
TotalVpcTrafficlong

The total traffic for VPC firewalls. If you use Cloud Firewall that uses the subscription billing method, this parameter indicates the total volume of burstable protected traffic on the VPC boundary. Unit: bytes.

2320274874426
TotalInternetAssetslong

The total number of assets protected by the Internet firewall.

128
TotalInternetTrafficlong

The total traffic for the Internet firewall. If you use Cloud Firewall that uses the subscription billing method, this parameter indicates the total volume of burstable protected traffic on the Internet boundary. Unit: bytes.

2320274874426
TotalBillTrafficlong

The volume of burstable protected traffic for which fees are generated. Unit: bytes.

2320274874426

Examples

Sample success responses

JSONformat

{
  "TotalAssets": 132,
  "RequestId": "826B6280-9704-5643-97B1-6B47AC3F027A",
  "TotalTraffic": 2320274874426,
  "TotalNatAssets": 1,
  "TotalNatTraffic": 560646279,
  "TotalVpcAssets": 3,
  "TotalVpcTraffic": 2320274874426,
  "TotalInternetAssets": 128,
  "TotalInternetTraffic": 2320274874426,
  "TotalBillTraffic": 2320274874426
}

Error codes

HTTP status codeError codeError messageDescription
400ErrorAliUidAliuid invalid.The aliuid is invalid.
400ErrorNotPostpayUsernot Postpay User.Non-pay-as-you-go Users.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-08-29API Description Update. The Error code has changedView Change Details
2024-06-05The response structure of the API has changedView Change Details