DescribePrice - Simple Application Server - Alibaba Cloud Documentation Center

Queries the price of a Simple Application Server product.

Operation description

Running a command does not guarantee successful execution or the expected result. Check the return value to determine the actual outcome. The final output prevails.
You can query execution information from the past two weeks. A maximum of 100,000 execution records are retained.

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 ID of the region where the Simple Application Server instance resides. For more information, see ListRegions.	cn-hangzhou
CommodityType	string	Yes	The resource type. Valid value: Server	Server
PlanId	string	Yes	The plan ID. For more information, see ListPlans.	swas.s1.cxxxxxx3t05
DataDiskSize	integer	No	The size of the data disk to attach, in GB. The value must be a multiple of 20. Valid values: 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: The price is calculated by month. Year: The price is calculated by year. Default value: Month.	Month
Amount	integer	No	The number of Simple Application Server instances to create. Valid values: 1 to 20. Default value: 1.	1
PayType	string	No	The billing method of the instance. Valid value: Prepaid: subscription Example: Prepaid.	Prepaid
PromotionOptions	object	No	The promotion options.
CouponNo	string	No	The coupon code.	youhuiquan_promotion_option_id_for_blank
OrderType	string	No	The order type. Valid value: Buy Default value: Buy.	UPLOAD
AcceptLanguage	string	No	The language of the response. Valid values: zh-CN (Default): Chinese. 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	Description of the custom parameter.	买满一年，立享官网价格xxx折扣优惠。
RuleId	integer	The rule ID.	142
Price	object	The price information.
OriginalPrice	number	The original price.	1580
DiscountPrice	number	The discounted price.	0.0
StandardPrice	number	The price after applying the official website discount or the direct sales contract discount.	899
StandardDiscountPrice	number	The promotional price reflecting the official website's 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	The detailed price information for the configuration.
OriginalPrice	number	The original price.	1850
DiscountPrice	number	The discounted price.	0.0
CommodityType	string	The resource name.	Server
TradePrice	number	The transaction price.	267.4
Coupons	array<object>	Indicates whether this coupon is selected.
	object	The ID of the coupon.
IsSelected	boolean	Indicates whether the coupon is selected.
CouponNo	string	The coupon code. The default value is `youhuiquan_promotion_option_id_for_blank`.	youhuiquan_promotion_option_id_for_blank
Description	string	The description.	OK
DiscountOff	number	The discount.	20.0
OptionCode	string	The promotion ID.	*****
Name	string	The command name.	ACS-SWAS-GenerateRsaKeypair-windows.ps1
Promotions	array<object>	The promotions.
	object	The promotion.
Name	string	The coupon name.	ACS-SWAS-ResetPassword-for-linux.sh
DiscountOff	number	The discount amount of the coupon.	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.