全部产品
云市场

预付费产品询价服务

更新时间:2019-10-14 19:02:51

接口名

GetSubscriptionPrice

描述

预付费产品价格查询接口,查询用户某个预付费产品的价格。阿里云产品较多,并且有比较繁多的配置参数,可以配合其他的接口进行参数的查询:API询价调用流程

请求参数

名称 类型 是否必填 说明
Action String 要执行的操作,取值:GetSubscriptionPrice
ProductCode String 产品代码,请参考阿里云产品Code速查手册
ProductType String 产品类型,是否必输以具体产品的询价文档为准。
SubscriptionType String 订阅类型。取值类型:Subscription(预付费)
OrderType String 订单类型。取值范围:NewOrder(新购),Renewal(续费),Upgrade(升级)
ServicePeriodQuantity Integer 服务时长
ServicePeriodUnit String 服务时长单位。取值范围:Year(年),Month(月)
Region String 实例所属的 Region ID。请参考阿里云Region文档
InstanceId String 指定询价的实例 ID,升级场景必须设置,用于获取实例升级前配置
ModuleList.n.Config String 第n个计价模块的配置,n的取值范围为[1,50],格式:“AA:aa,BB:bb”,其中AA,BB分别为计价模块属性标识,aa,bb分别为计价模块属性的属性值。可通过DescribePricingModule接口获取Module参数,同时可参考云产品询价参数
ModuleList.n.ModuleCode String 第n个计价模块的模块标识
ModuleList.n.ModuleStatus Integer 仅在订单类型为Upgrade(升级)时需要,表示此次询价模块变更状态。取值范围:1(新增),2(变更,升级场景如果计价模块的配置发生变化需要显示指定此状态值),默认值:1
ModuleList.n.Tag String 仅在某些产品的的升级变配中需要,代表指定资源的标识。比如对于磁盘的变配,用Tag标识具体磁盘对应的Id

返回参数

名称 类型 说明
OriginalPrice Double 原价
DiscountPrice Double 折扣
TradePrice Double 优惠价
Currency String 币种。取值范围:CNY(人民币),USD(美元),JPY(日元)
ModuleDetails ModuleDetail 计价模块价格详情,详见数据字典
PromotionDetails PromotionDetail 优惠详情,详见数据字典

ModuleDetail详情

名称 类型 说明
ModuleCode String 计价模块标识
UnitPrice Double 单价
OriginalCost Double 原价
InvoiceDiscount Double 折扣
CostAfterDiscount Double 优惠价

PromotionDetail详情

名称 类型 说明
PromotionName String 优惠名称
PromotionDesc Double 优惠描述
PromotionId Long 优惠标识

错误码

错误码 错误信息 HTTP状态码语义
NotApplicable This API is not applicable for caller. 400 该用户没有访问API的权限。
MissingParameter The specified parameter xx is mandatory for this request. 400 指定的参数未设置。
InvalidParameter The specified moduleCode is not valid. 400 指定的参数不合法。
InvalidModuleCode The specified moduleCode is not valid. 400 模块标识不合法。
InvalidConfigCode The specified configCode is not valid. 400 模块属性标识不合法。
InvalidOwner The specified owner doesn’t belong to caller. 400 指定的拥有者从属关系不属于调用者。
InvalidCaller The specified caller doesn’t exists. 400 调用者不合法。
InternalError The request processing has failed due to some unknown error, exception or failure. 400 内部未知错误。
ProductNotFind Can not find inquired product, it may not exist. 400 查询的产品不合法。

请求示例

  1. https://business.aliyuncs.com/?Action=GetSubscriptionPrice
  2. &Action=GetSubscriptionPrice
  3. &ModuleList.1.ModuleCode=ExtBandwidth
  4. &ModuleList.1.Config=ExtBandwidth:50
  5. &ModuleList.2.ModuleCode=PackageCode
  6. &ModuleList.2.Config=PackageCode:version_1
  7. &OrderType=NewOrder
  8. &ProductCode=waf
  9. &Quantity=1
  10. &Region=cn
  11. &ServicePeriodQuantity=1
  12. &ServicePeriodUnit=Month
  13. &SubscriptionType=Subscription
  14. &公共参数

返回示例

  1. "Data": {
  2. "Quantity": 1,
  3. "DiscountPrice": 900,
  4. "ModuleDetails": {
  5. "ModuleDetail": [
  6. {
  7. "ModuleCode": "ExtBandwidth",
  8. "UnitPrice": 0,
  9. "CostAfterDiscount": 0,
  10. "OriginalCost": 800,
  11. "InvoiceDiscount": 800
  12. },
  13. {
  14. "ModuleCode": "PackageCode",
  15. "UnitPrice": 0,
  16. "CostAfterDiscount": 0,
  17. "OriginalCost": 100,
  18. "InvoiceDiscount": 100
  19. }
  20. ]
  21. },
  22. "PromotionDetails": {
  23. "PromotionDetail": [
  24. {
  25. "PromotionId": 1021199213,
  26. "PromotionName": ""
  27. }
  28. ]
  29. },
  30. "OriginalPrice": 900,
  31. "TradePrice": 0,
  32. "Currency": "CNY"

注: 查询云服务器ECS资源的最新价格,同样可使用接口DescribePrice; 查询云服务器ECS包年包月资源的续费价格,可调用DescribeRenewalPrice