All Products
Search
Document Center

ENS:DescribeBandwitdhByInternetChargeType

Last Updated:Mar 12, 2024

Queries the metering method for the bandwidth.

Debugging

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

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
StartTimestringYes

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.
  • If the value of the seconds place is not 00, the start time is automatically set to the next minute.
2021-11-15T16:00:00Z
EndTimestringYes

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.
  • If the value of the seconds place is not 00, the start time is automatically set to the next minute.
2022-01-18T09:39:54Z
IspstringNo

The Internet service provider (ISP). Valid values:

  • cmcc: China Mobile
  • telecom: China Telecom
  • unicom: China Unicom
  • multiCarrier: multi-line ISP
unicom
EnsRegionIdstringNo

The region ID of the instance.

cn-hangzhou-cbn-2

Response parameters

ParameterTypeDescriptionExample
object
BandwidthValuelong

The bandwidth. Unit: bit/s.

123
InternetChargeTypestring

The metering method. Valid values:

  • BandwidthByDay: Pay by daily peak bandwidth
  • 95BandwidthByMonth: Pay by monthly 95th percentile bandwidth
  • PayByBandwidth4thMonth: Pay by monthly fourth peak bandwidth
  • PayByBandwidth: Pay by fixed bandwidth

You can specify only one metering method for network usage and cannot overwrite the existing metering method.

95BandwidthByMonth
RequestIdstring

The ID of the request. This parameter is a common parameter. Each request has a unique ID. You can use the ID to troubleshoot issues.

08027633-8501-5A36-B90D-F7C38B5EC75D
TimeStampstring

The timestamp. The time follows the ISO 8601 standard. The time is displayed in UTC. Example: 2016-10-20T04:00:00Z.

2019-10-12T05:45:00Z

Examples

Sample success responses

JSONformat

{
  "BandwidthValue": 123,
  "InternetChargeType": "95BandwidthByMonth",
  "RequestId": "08027633-8501-5A36-B90D-F7C38B5EC75D",
  "TimeStamp": "2019-10-12T05:45:00Z"
}

Error codes

HTTP status codeError codeError messageDescription
400NoPermissionPermission denied.-
400InvalidParameter.%sThe specified field %s invalid. Please check it again.-
400InsufficientEipCapacityInsufficient EIP inventory under the specified territory.-
400CallInterfaceCall Interface Happen Error.An error occurred when you call the operation.

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

Change history

Change timeSummary of changesOperation
2023-12-21API Description Update. The Error code has changed. The request parameters of the API has changedsee changesets
Change itemChange content
API DescriptionAPI Description Update.
Error CodesThe Error code has changed.
    Error Codes 400 change
Input ParametersThe request parameters of the API has changed.
    delete Input Parameters: Version