DescribePrice-阿里云帮助中心

Gets pricing for a Simple Application Server.

Operation description

Running a command does not guarantee successful execution or the expected result. Check the return value to determine the actual result.
You can query execution information from the past two weeks. The system retains a maximum of 100,000 execution records.

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

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

swas-open:DescribePrice

list

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID. You can call the ListRegions operation to query supported regions.	cn-hangzhou
CommodityType	string	Yes	The resource type. Valid value: Server	Server
PlanId	string	Yes	The plan ID. You can call the ListPlans operation to query available plans in the specified region.	swas.s1.cxxxxxx3t05
DataDiskSize	integer	No	The capacity of the data disk to attach, in GB. The value must be a multiple of 20 in the range of 0 to 16380.	20
Period	integer	No	The billing duration. Valid values: If `PriceUnit` is set to `Month`: 1 to 9. If `PriceUnit` is set to `Year`: 1 to 5. Default value: 1.	1
PriceUnit	string	No	The billing cycle. Valid values: Month Year Default value: Month.	Month
Amount	integer	No	The number of Simple Application Server instances. Valid values: 1 to 20. Default value: 1.	1
PayType	string	No	The billing method of the instance. Valid value: Prepaid: subscription	Prepaid
PromotionOptions	object	No	The promotion options.
CouponNo	string	No	The coupon code.	youhuiquan_promotion_option_id_for_blank
ActivityId	string	No
OrderType	string	No	The order type. Valid value: Buy Default value: Buy.	UPLOAD
AcceptLanguage	string	No	The response language. Valid values: zh-CN: Chinese (default) en-US: English	zh-CN

Response elements

Element	Type	Description	Example
	object	The response schema.
RequestId	string	The request ID.	30637AD6-D977-4833-A54C-CC89483E****
PriceInfo	object	The price details.
Rules	array<object>	The promotion rules.
	object	The promotion rule.
Description	string	The description of the promotion rule.	买满一年，立享官网价格xxx折扣优惠。
RuleId	integer	The rule ID.	142
Price	object	The price information.
OriginalPrice	number	The original price.	1580
DiscountPrice	number	The discount amount.	0.0
StandardPrice	number	The standard price published on the official website or specified in a direct sales contract.	899
StandardDiscountPrice	number	The promotional price based on the official website discount.	85
IsContractPromotion	boolean	Indicates whether a promotion is applied.
Currency	string	The currency. Valid values: CNY USD	CNY
TradePrice	number	The transaction price.	267.4
DetailInfos	array<object>	The detailed price information for the configuration.
	object	An entry of detailed price information for the configuration.
OriginalPrice	number	The original price.	1850
DiscountPrice	number	The discount amount.	0.0
CommodityType	string	The commodity type.	Server
TradePrice	number	The transaction price.	267.4
Coupons	array<object>	The coupons.
	object	The coupon.
IsSelected	boolean	Indicates whether the coupon is selected.
CouponNo	string	The coupon code. Default value: `youhuiquan_promotion_option_id_for_blank`.	youhuiquan_promotion_option_id_for_blank
Description	string	The description of the coupon.	OK
DiscountOff	number	The discount provided by the coupon.	20.0
OptionCode	string	The promotion ID.	*****
Name	string	The coupon name.	ACS-SWAS-GenerateRsaKeypair-windows.ps1
Promotions	array<object>	The promotions.
	object	The promotion.
Name	string	The name of the promotion.	ACS-SWAS-ResetPassword-for-linux.sh
DiscountOff	number	The discount amount of the promotion.	20.0
RuleIds	array	The promotion IDs.
	integer	The promotion ID.	a7c77d3b3e6d458996410c650ef38326

Examples

Success response

JSON format

{
  "RequestId": "30637AD6-D977-4833-A54C-CC89483E****",
  "PriceInfo": {
    "Rules": [
      {
        "Description": "买满一年，立享官网价格xxx折扣优惠。",
        "RuleId": 142
      }
    ],
    "Price": {
      "OriginalPrice": 1580,
      "DiscountPrice": 0,
      "StandardPrice": 899,
      "StandardDiscountPrice": 85,
      "IsContractPromotion": false,
      "Currency": "CNY",
      "TradePrice": 267.4,
      "DetailInfos": [
        {
          "OriginalPrice": 1850,
          "DiscountPrice": 0,
          "CommodityType": "Server",
          "TradePrice": 267.4
        }
      ],
      "Coupons": [
        {
          "IsSelected": false,
          "CouponNo": "youhuiquan_promotion_option_id_for_blank",
          "Description": "OK",
          "DiscountOff": 20,
          "OptionCode": "*****",
          "Name": "ACS-SWAS-GenerateRsaKeypair-windows.ps1"
        }
      ],
      "Promotions": [
        {
          "Name": "ACS-SWAS-ResetPassword-for-linux.sh",
          "DiscountOff": 20,
          "RuleIds": [
            0
          ]
        }
      ]
    }
  }
}

Error codes

HTTP status code	Error code	Error message	Description
400	CSS_SYSTEM_ERROR	The sales system encountered an error.	There was an error in the selling system.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.