Queries the coverage summary of savings plans.


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.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeSavingsPlansCoverageTotal

The operation that you want to perform. Set the value to DescribeSavingsPlansCoverageTotal.

PeriodType String Yes HOUR

The time granularity at which coverage summary are queried. Valid values: MONTH, DAY, and HOUR.

StartPeriod String Yes 2021-07-15 00:00:00

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.

EndPeriod String No 2021-07-20 00:00:00

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.

BillOwnerId Long No 123745698925000

The ID of the account for which you want to query coverage summary. 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.

Response parameters

Parameter Type Example Description
Code String Success

The status code.

Data Struct

The return data.

PeriodCoverage Array of Item

The coverage in different periods.

Percentage Float 1

The coverage.

Period String 2021071500

The period.

The value is in the format of yyyyMMddHH.

TotalCoverage Struct

The coverage summary.

CoveragePercentage Float 1

The total coverage.

DeductAmount Float 100

The total deducted amount.

Message String Successful!

The message returned.

RequestId String 79EE7556-0CFD-44EB-9CD6-B3B526E3A85F

The ID of the request.

Success Boolean true

Indicates whether the operation was successful.


Sample requests

&StartPeriod=2021-07-15 00:00:00
&<Common request parameters>

Sample success responses

JSON format


Error codes

For a list of error codes, visit the API Error Center.