Queries the total coverage data of reserved instances (RIs) or storage capacity units (SCUs).
The queried total coverage data is the same as the aggregated data displayed on the Coverage tab of the Manage Reserved Instances page in the Billing Management console.
You can call this operation to query the total coverage data of RIs or SCUs.
OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.
The operation that you want to perform. Set the value to DescribeResourceCoverageTotal.
The time granularity at which total coverage data is queried. Valid values: MONTH, DAY, and HOUR.
The type of deduction plans whose total coverage data is queried. Valid values: RI and SCU.
The beginning of the time range to query. The beginning is included in the time range. Specify the time in the format of yyyy-MM-dd HH:mm:ss.
The end of the time range to query. The end is excluded from the time range. If you do not set this parameter, the end time is the current time. Specify the time in the format of yyyy-MM-dd HH:mm:ss.
The ID of the account for which you want to query total coverage data. If you do not set this parameter, the data of the current Alibaba Cloud account and its RAM users is queried. To query the data of a RAM user, specify the ID of the RAM user.
The status code.
The returned data.
|PeriodCoverage||Array of Item||
The information about the coverage rate of deduction plans within a period.
The coverage rate of deduction plans within the specified period.
The value is in the format of yyyyMMddHH.
The information about the total coverage data of deduction plans.
The unit that is used to measure the resources deducted from deduction plans.
The total coverage rate of deduction plans.
The total amount of the resources deducted from deduction plans.
The total amount of resources consumed.
The message returned.
The ID of the request.
Indicates whether the operation was successful.
http(s)://[Endpoint]/?Action=DescribeResourceCoverageTotal &PeriodType=HOUR &ResourceType=RI &StartPeriod=2021-01-01 00:00:00 &EndPeriod=2021-01-02 00:00:00 &<Common request parameters>
Sample success responses
For a list of error codes, visit the API Error Center.