DescribePrice - 询价

更新时间:
复制为 MD 格式

获取轻量产品价格信息

接口说明

  • 当您执行命令后,不代表命令一定成功运行,并且一定有预期的命令效果。您需要通过接口返回值查看实际执行结果,以实际输出结果为准。

  • 您可以查询最近 2 周的执行信息,执行信息的保留上限为 10 万条。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

swas-open:DescribePrice

list

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

RegionId

string

指定的轻量应用服务器实例所属的地域 ID。 您可以调用 ListRegions 查看支持的阿里云地域列表。

cn-hangzhou

CommodityType

string

资源类型,可选值:

  • Server。

Server

PlanId

string

套餐 ID。您可以调用 ListPlans 查询指定地域下的全部套餐信息。

swas.s1.cxxxxxx3t05

DataDiskSize

integer

挂载的数据盘容量大小。单位:GB。取值范围:0~16380,取值必须是 20 的整数倍。

20

Period

integer

计费时长。取值范围:

  • 当参数 PriceUnit 取值为 Month 时:1~9。

  • 当参数 PriceUnit 取值为 Year 时:1~5。

默认值:1。

1

PriceUnit

string

取值范围:

  • Month:按月计费的价格单位。

  • Year:按年计费的价格单位。

默认值:Month。

Month

Amount

integer

创建轻量应用服务器的数量。取值范围:1~20

默认值:1

1

PayType

string

实例的付费类型,取值:

  • Prepaid:预付费(包年包月)

示例值:Prepaid。

Prepaid

PromotionOptions

object

优惠选项信息。

CouponNo

string

优惠券编码。

youhuiquan_promotion_option_id_for_blank

OrderType

string

订单类型:

  • Buy

默认值:Buy。

UPLOAD

AcceptLanguage

string

返回值语言,取值:

  • zh-CN(默认值):中文。

  • en-US:英文。

zh-CN

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

Id of the request

30637AD6-D977-4833-A54C-CC89483E****

PriceInfo

object

价格详细信息。

Rules

array<object>

活动规则信息。

object

活动规则信息。

Description

string

自定义参数描述。

买满一年,立享官网价格xxx折扣优惠。

RuleId

integer

规则 ID。

142

Price

object

价格信息。

OriginalPrice

number

原价。

1580

DiscountPrice

number

折减的价格。

0.0

StandardPrice

number

官网折扣价 or 直销合同折扣价。

899

StandardDiscountPrice

number

基于官网折扣的优惠价格。

85

IsContractPromotion

boolean

是否命中优惠。

Currency

string

价格单位。可能值:

  • CNY:元

  • USD:美元

CNY

TradePrice

number

交易价格。

267.4

DetailInfos

array<object>

配置明细价格信息。

object

配置明细价格信息。

OriginalPrice

number

原价。

1850

DiscountPrice

number

折扣价。

0.0

CommodityType

string

资源名称。

Server

TradePrice

number

成交价。

267.4

Coupons

array<object>

是否选中该优惠券。

object

优惠券编号

IsSelected

boolean

是否选中该优惠券。

CouponNo

string

优惠码,默认值为:youhuiquan_promotion_option_id_for_blank

youhuiquan_promotion_option_id_for_blank

Description

string

自定义参数描述。

OK

DiscountOff

number

折扣、优惠。

20.0

OptionCode

string

优惠 id。

*****

Name

string

命令名称。

ACS-SWAS-GenerateRsaKeypair-windows.ps1

Promotions

array<object>

促销活动信息。

object

促销活动信息。

Name

string

优惠券名称。

ACS-SWAS-ResetPassword-for-linux.sh

DiscountOff

number

优惠券优惠金额。

20.0

RuleIds

array

优惠 ID。

integer

优惠 ID。

a7c77d3b3e6d458996410c650ef38326

示例

正常返回示例

JSON格式

{
  "RequestId": "30637AD6-D977-4833-A54C-CC89483E****",
  "PriceInfo": {
    "Rules": [
      {
        "Description": "买满一年,立享官网价格xxx折扣优惠。",
        "RuleId": 142
      }
    ],
    "Price": {
      "OriginalPrice": 1580,
      "DiscountPrice": 0,
      "StandardPrice": 899,
      "StandardDiscountPrice": 85,
      "IsContractPromotion": true,
      "Currency": "CNY",
      "TradePrice": 267.4,
      "DetailInfos": [
        {
          "OriginalPrice": 1850,
          "DiscountPrice": 0,
          "CommodityType": "Server",
          "TradePrice": 267.4
        }
      ],
      "Coupons": [
        {
          "IsSelected": true,
          "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
          ]
        }
      ]
    }
  }
}

错误码

HTTP status code

错误码

错误信息

描述

400 CSS_SYSTEM_ERROR The sales system encountered an error. 售卖系统出现错误。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情