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

API描述

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

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

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

调试

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

请求参数

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

系统规定参数。取值:GetSubscriptionPrice

ServicePeriodUnit String Year

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

  • Year:年。
  • Month:月。
SubscriptionType String Subscription

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

ProductCode String ecs

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

OrderType String NewOrder

订单类型。取值范围:

  • NewOrder:新购。
  • Renewal:续费。
  • Upgrade:升级。
ServicePeriodQuantity Integer 1

服务时长。

ProductType String ecs

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

Region String cn-hangzhou

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

InstanceId String i-khkjhxxxxxxxxx

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

Quantity Integer 1

数量。

ModuleList.N.ModuleStatus Integer 1

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

取值范围:

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

默认值:1。

ModuleList.N.ModuleCode String PackageCode

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

ModuleList.N.Tag String 213213123

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

ModuleList.N.Config String PackageCode:version_1

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

返回数据

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

状态码。

Message String Successful

错误信息。

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

请求ID。

Success Boolean true

是否成功。

Data Object

产品价格信息。

OriginalPrice Float 900

原价。

DiscountPrice Float 100

折扣。

Currency String CNY

币种。取值范围:

  • CNY:人民币。
  • USD:美元。
  • JPY:日元。
Quantity Integer 1

数量。

TradePrice Float 0

优惠价。

ModuleDetails Array of ModuleDetail

计价模块价格详情。

ModuleDetail
CostAfterDiscount Float 0

优惠价。

InvoiceDiscount Float 100

折扣。

UnitPrice Float 0

单价。

OriginalCost Float 200

原价。

ModuleCode String PackageCode

计价模块标识。

PromotionDetails Array of PromotionDetail

优惠详情。

PromotionDetail
PromotionDesc String test

优惠描述。

PromotionId Long 1021199213

优惠标识。

PromotionName String test

优惠名称。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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/>
            </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格式

HTTP/1.1 200 OK
Content-Type:application/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!"
}

错误码

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