DescribeDcdnUserBillHistory - Edge Security Acceleration

Queries the billing records of an Alibaba Cloud account. The maximum time range that you can specify is one month.

Operation description

Note You can call this operation up to 100 times per second per account.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
StartTime	string	Yes	The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. The minimum data granularity is 5 minutes.	2018-09-30T16:00:00Z
EndTime	string	Yes	The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. The end time must be later than the start time.	2018-10-31T16:00:00Z

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The ID of the request.	ED61C6C3-8241-4187-AAA7-5157AE175CEC
BillHistoryData	array<object>	The billing history returned.
BillHistoryDataItem	object
Dimension	string	The dimension.	vas
BillType	string	The metering method.	month_4th_day_bandwidth
BillTime	string	The beginning of the time range that was queried.	2018-09-30T17:00:00Z
BillingData	array<object>	The billable items.
BillingDataItem	object
Flow	float	The amount of network traffic. Unit: bytes.	2456
Bandwidth	float	The bandwidth. Unit: bit/s.	4839
Count	float	The number of billing entries.	205624
CdnRegion	string	The region for which the billing records are generated. Valid values: CN, OverSeas, AP1, AP2, AP3, NA, SA, EU, and MEAA.	AP1
ChargeType	string	The billing method of the disk. Valid values: StaticHttp, DynamicHttp, and DynamicHttps.	DynamicHttp

Examples

Sample success responses

JSONformat

{
  "RequestId": "ED61C6C3-8241-4187-AAA7-5157AE175CEC",
  "BillHistoryData": {
    "BillHistoryDataItem": [
      {
        "Dimension": "vas",
        "BillType": "month_4th_day_bandwidth",
        "BillTime": "2018-09-30T17:00:00Z",
        "BillingData": {
          "BillingDataItem": [
            {
              "Flow": 2456,
              "Bandwidth": 4839,
              "Count": 205624,
              "CdnRegion": "AP1",
              "ChargeType": "DynamicHttp"
            }
          ]
        }
      }
    ]
  }
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParameters	The specified parameters are invalid.	A parameter is set to an invalid value.
400	InvalidStartTime.Malformed	The specified StartTime parameter is invalid.	The format of the specified start time is invalid. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
400	InvalidEndTime.Malformed	The specified EndTime is invalid.	The format of the specified end time is invalid. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
400	InvalidEndTime.Mismatch	The specified EndTime is earlier than the StartTime.	The end time is earlier than the start time.
400	InvalidTimeSpan	The time span exceeds the limit.	The time span exceeds the limit. Configure a valid time span as described in API documentation.
400	InvalidTime.Malformed	Specified StartTime or EndTime is malformed.	The format of the specified start time or end time is invalid. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

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

Change history

Change time	Summary of changes	Operation
2023-07-04	The Error code has changed	View Change Details