DescribePrice - Simple Application Server - Alibaba Cloud Documentation Center

Retrieves the pricing information of a Simple Application Server product.

Operation description

After you run a command, the command is not guaranteed to succeed or produce the expected results. Check the actual execution result based on the response.
You can query execution information from the last 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 region ID of the specified Simple Application Server instance. You can call ListRegions to query the list of supported Alibaba Cloud regions.	cn-hangzhou
CommodityType	string	Yes	The resource type. Valid values: Server.	Server
PlanId	string	No	The plan ID. You can call ListPlans to query all plans in a specified region.	swas.s1.cxxxxxx3t05
DataDiskSize	integer	No	The size of the attached data cloud disk. Unit: GB. Valid values: 0 to 16380. The value must be a multiple of 20.	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	Valid values: Month: The price unit for monthly billing. Year: The price unit for yearly billing. 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 values: Prepaid: subscription. Example value: Prepaid.	Prepaid
PromotionOptions	object	No	The promotion option information.
CouponNo	string	No	The coupon code.	youhuiquan_promotion_option_id_for_blank
ActivityId	string	No
OrderType	string	No	The order type. Valid values: Buy Default value: Buy.	UPLOAD
AcceptLanguage	string	No	The language of the response. Valid values: zh-CN (default): Chinese. en-US: English.	zh-CN
InstanceId	string	No

Response elements

Element	Type	Description	Example
	object	Schema of Response
RequestId	string	Id of the request	30637AD6-D977-4833-A54C-CC89483E****
PriceInfo	object	The price details.
Rules	array<object>	The promotion rule information.
	object	The promotion rule information.
Description	string	The description of the custom parameter.	Purchase for one year and enjoy an xxx discount off the official website price
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 discounted price on the official website or the discounted price based on 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 unit. Valid values: CNY: Chinese Yuan. USD: US Dollar.	CNY
TradePrice	number	The transaction price.	267.4
DetailInfos	array<object>	The detailed pricing information for each configuration.
	array<object>	The detailed pricing information for each configuration.
OriginalPrice	number	The original price.	1850
DiscountPrice	number	The discount price.	0.0
CommodityType	string	The resource name.	Server
TradePrice	number	The transaction price.	267.4
Promotions	array<object>
	object
Name	string
DiscountOff	number		0
RuleId	integer		0
Coupons	array<object>	Indicates whether the coupon is selected.
	object	The coupon code.
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 custom parameter.	OK
DiscountOff	number	The discount amount.	20.0
OptionCode	string	The promotion ID.	*****
Name	string	The command name.	ACS-SWAS-GenerateRsaKeypair-windows.ps1
Promotions	array<object>	The promotion information.
	object	The promotion information.
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 ID.
	integer	The promotion ID.	a7c77d3b3e6d458996410c650ef38326

Examples

Success response

JSON format

{
  "RequestId": "30637AD6-D977-4833-A54C-CC89483E****",
  "PriceInfo": {
    "Rules": [
      {
        "Description": "Purchase for one year and enjoy an xxx discount off the official website price",
        "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,
          "Promotions": [
            {
              "Name": "",
              "DiscountOff": 0,
              "RuleId": 0
            }
          ]
        }
      ],
      "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.