调用GetSubscriptionPrice查询预付费产品价格。

API描述

1. 调用QueryProductList获取产品code,参见查询产品信息

2. 调用DescribePricingModule接口获取产品的配置参数,参见查询产品模块信息

3. 根据查询到的产品配置参数调用本接口获取预付费产品的价格。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String GetSubscriptionPrice

系统规定参数。取值:GetSubscriptionPrice。

ModuleList.N.Config String PackageCode:version_1

第n个计价模块的配置,n的取值范围为(1~50),格式:“AA:aa,BB:bb”,其中AA,BB分别为计价模块属性标识,aa,bb分别为计价模块属性的属性值。

ModuleList.N.ModuleCode String PackageCode

第n个计价模块的模块标识。

OrderType String NewOrder

订单类型。取值范围:

  • NewOrder:新购。
  • Renewal:续费。
  • Upgrade:升级。
ProductCode String ecs

产品代码,请参见阿里云产品Code速查手册

SubscriptionType String Subscription

订阅类型。取值类型:Subscription(预付费)。

ModuleList.N.ModuleStatus Integer 1

仅在订单类型为Upgrade(升级)时需要,表示此次询价模块变更状态。

取值范围:

  • 1:新增。
  • 2:变更,升级场景如果计价模块的配置发生变化需要显示指定此状态值。

默认值:1。

ModuleList.N.Tag String 213213123

仅在某些产品的的升级变配中需要,代表指定资源的标识。例如:对于磁盘的变配,用Tag标识具体磁盘对应的Id。

ServicePeriodQuantity Integer 1

服务时长。

ServicePeriodUnit String Year

服务时长单位。取值范围:

  • Year:年。
  • Month:月。
Region String cn-hangzhou

实例所属的Region ID(地域ID)。

InstanceId String i-khkjhxxxxxxxxx

指定询价的实例 ID,升级场景必须设置,用于获取实例升级前配置。

ProductType String ecs

产品类型,是否必输以具体产品的询价文档为准。

Quantity Integer 1

数量。

返回数据

名称 类型 示例值 描述
Code String InvalidConfigCod

状态码。

Data Struct

产品价格信息。

Currency String CNY

币种。取值范围:

  • CNY:人民币。
  • USD:美元。
  • JPY:日元。
DiscountPrice Float 100

折扣。

ModuleDetails Array

计价模块价格详情。

ModuleDetail
CostAfterDiscount Float 0

优惠价。

InvoiceDiscount Float 100

折扣。

ModuleCode String PackageCode

计价模块标识。

OriginalCost Float 200

原价。

UnitPrice Float 0

单价。

OriginalPrice Float 900

原价。

PromotionDetails Array

优惠详情。

PromotionDetail
PromotionDesc String test

优惠描述。

PromotionId Long 1021199213

优惠标识。

PromotionName String test

优惠名称。

Quantity Integer 1

数量。

TradePrice Float 0

优惠价。

Message String Successful

错误信息。

RequestId String 30E7066E-AE6F-4E59-AFE6-11386CE3AFA7

请求ID。

Success Boolean true

是否成功。

示例

请求示例

http(s)://[Endpoint]/?Action=GetSubscriptionPrice
&ModuleList.1.Config=PackageCode:version_1
&ModuleList.1.ModuleCode=PackageCode
&OrderType=NewOrder
&ProductCode=ecs
&SubscriptionType=Subscription
&<公共请求参数>

正常返回示例

XML 格式

<GetSubscriptionPriceResponse>
      <Data>
            <Quantity>1</Quantity>
            <DiscountPrice>900</DiscountPrice>
            <ModuleDetails>
                  <ModuleDetail>
                        <ModuleCode>ExtBandwidth</ModuleCode>
                        <UnitPrice>0</UnitPrice>
                        <CostAfterDiscount>0</CostAfterDiscount>
                        <OriginalCost>800</OriginalCost>
                        <InvoiceDiscount>800</InvoiceDiscount>
                  </ModuleDetail>
                  <ModuleDetail>
                        <ModuleCode>PackageCode</ModuleCode>
                        <UnitPrice>0</UnitPrice>
                        <CostAfterDiscount>0</CostAfterDiscount>
                        <OriginalCost>100</OriginalCost>
                        <InvoiceDiscount>100</InvoiceDiscount>
                  </ModuleDetail>
            </ModuleDetails>
            <PromotionDetails>
                  <PromotionDetail>
                        <PromotionId>1021199213</PromotionId>
                        <PromotionName></PromotionName>
                  </PromotionDetail>
            </PromotionDetails>
            <OriginalPrice>900</OriginalPrice>
            <TradePrice>0</TradePrice>
            <Currency>CNY</Currency>
      </Data>
      <RequestId>D6E068C3-25BC-455A-85FE-45F0B22ECB1F</RequestId>
      <Success>true</Success>
      <Code>Success</Code>
      <Message>Successful!</Message>
</GetSubscriptionPriceResponse>

JSON 格式

{
  "Data": {
    "Quantity": 1,
    "DiscountPrice": 900,
    "ModuleDetails": {
      "ModuleDetail": [
        {
          "ModuleCode": "ExtBandwidth",
          "UnitPrice": 0,
          "CostAfterDiscount": 0,
          "OriginalCost": 800,
          "InvoiceDiscount": 800
        },
        {
          "ModuleCode": "PackageCode",
          "UnitPrice": 0,
          "CostAfterDiscount": 0,
          "OriginalCost": 100,
          "InvoiceDiscount": 100
        }
      ]
    },
    "PromotionDetails": {
      "PromotionDetail": [
        {
          "PromotionId": 1021199213,
          "PromotionName": ""
        }
      ]
    },
    "OriginalPrice": 900,
    "TradePrice": 0,
    "Currency": "CNY"
  },
  "RequestId": "D6E068C3-25BC-455A-85FE-45F0B22ECB1F",
  "Success": true,
  "Code": "Success",
  "Message": "Successful!"
}

错误码

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