All Products
Search
Document Center

Expenses and Costs:QuerySavingsPlansDiscount

Last Updated:Feb 26, 2026

Queries the discount information for savings plans.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

ModuleCode

string

No

The code of the module.

instance_type

PayMode

string

Yes

The payment mode. Valid values: total: all upfront. half: partial upfront. zero: no upfront.

Valid values:

  • zero :

    0 预付

  • total :

    全预付

  • half :

    半预付

total

PageSize

integer

No

The number of entries per page.

20

SpnType

string

Yes

The type of the savings plan. Valid values: ecs: compute-optimized. universal: universal.

Valid values:

  • ecs :

    计算型

  • universal :

    通用型

universal

Locale

string

No

The language of the response.

Valid values:

  • EN :

    英文

  • ZH :

    中文

ZH

Cycle

string

Yes

The query cycle.

1:Year

PageNum

integer

No

The page number.

1

Spec

string

No

The resource type.

ecs.g6

CommodityCode

string

Yes

The commodity code.

ecs

Region

string

No

The region.

cn-hangzhou

SpnCommodityCode

string

No

The commodity code of the savings plan.

savingplan_common_public_cn

Response elements

Element

Type

Description

Example

object

The result of the request.

Message

string

The error message.

This API is not applicable for caller.

RequestId

string

The request ID.

6000EE23-274B-4E07-A697-FF2E999520A4

Data

object

The returned data.

HostId

string

The request IP address.

100.104.180.109

Items

array<object>

The list of discount information.

object

The discount details.

CommodityName

string

The product details.

云服务器ECS-按量付费

ModuleName

string

The name of the pricing module.

实例

SpnType

string

The type of the savings plan.

universal

PayMode

string

The payment mode.

  • total: All upfront

  • half: Partial upfront

  • zero: No upfront

total

Cycle

string

The query cycle.

1:Year

Region

string

The region.

张家口

RegionCode

string

The ID of the region where the instance resides. For more information, see DescribeDBInstanceAttribute.

cn-hangzhou

Spec

string

The resource type.

ecs.g6

DiscountRate

string

The official discount rate.

0.85

ContractDiscountRate

string

The contract discount rate.

0.85

Code

string

The error code.

PARAM_ERROR

Success

boolean

Indicates whether the request was successful.

true

Examples

Success response

JSON format

{
  "Message": "This API is not applicable for caller.",
  "RequestId": "6000EE23-274B-4E07-A697-FF2E999520A4",
  "Data": {
    "HostId": "100.104.180.109",
    "Items": [
      {
        "CommodityName": "云服务器ECS-按量付费",
        "ModuleName": "实例",
        "SpnType": "universal",
        "PayMode": "total",
        "Cycle": "1:Year",
        "Region": "张家口",
        "RegionCode": "cn-hangzhou",
        "Spec": "ecs.g6",
        "DiscountRate": "0.85",
        "ContractDiscountRate": "0.85"
      }
    ]
  },
  "Code": "PARAM_ERROR",
  "Success": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.