调用DescribePrice接口查询新购价格-无影云电脑企业版-阿里云-阿里云帮助中心

查询无影商品的新购价格。

调试

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

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
ecd:DescribePrice	none	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。	cn-hangzhou
ResourceType	string	否	资源类型。枚举值： DesktopMonthPackage：云电脑（按月时长包）。 Desktop：云电脑（按需购买/按月购买-不限时长）[默认值]。 Bandwidth：公网精品带宽。 DesktopGroup：共享型云电脑。	Desktop
InstanceType	string	否	资源规格。当`ResourceType`为`Desktop`时，该字段必填。可以调用 DescribeDesktopTypes 查询可用的值（对应`DesktopTypeId`的值）。当`ResourceType`为`DesktopGroup`时，取值为`large`。当`ResourceType`为`Bandwidth`时，可以不传入该参数。	eds.general.2c2g
RootDiskSizeGib	integer	否	系统盘大小。单位：GiB。当`ResourceType`为`Desktop`时，该字段必填。	80
UserDiskSizeGib	integer	否	数据盘大小。单位：GiB。	100
OsType	string	否	操作系统类型。枚举值： Linux：Linux。 Windows：Windows [默认值]。	Windows
PeriodUnit	string	否	计费周期。枚举值： Month：月。 Year：年。 Hour：小时 [默认值]。	Hour
Period	integer	否	购买时长。取值范围由参数`PeriodUnit`的值决定。 `PeriodUnit`为`Hour`时，取值范围为：1。 `PeriodUnit`为`Month`时，取值范围为：1、2、3、6。 `PeriodUnit`为`Year`时，取值范围为：1、2、3。默认值：1。	1
Amount	integer	否	资源数量。默认值为 1。	1
PromotionId	string	否	促销活动 ID。	123456
InternetChargeType	string	否	互联网访问包的计费方式。枚举值： PayByTraffic：按使用流量计费。 PayByBandwidth：按固定带宽计费。	PayByTraffic
Bandwidth	integer	否	公网带宽峰值。单位：Mbps。按固定带宽计费时，取值范围为 10~1000。按使用流量计费时，取值范围为 10~200。	10
RootDiskPerformanceLevel	string	否	系统盘的性能等级。当云电脑规格设置为图形型或者高主频时，支持设置磁盘性能等级。关于各性能等级磁盘的差异，请参见 ESSD 云盘。	PL0
UserDiskPerformanceLevel	string	否	数据盘的性能等级。当云电脑规格设置为图形型或者高主频时，支持设置磁盘性能等级。关于各性能等级磁盘的差异，请参见 ESSD 云盘。	PL0
GroupDesktopCount	integer	否	共享型云电脑的数量，默认值为 1。说明当`ResourceType`为`DesktopGroup`时，该值有效。	1
Duration	integer	否	按月购买云电脑时的时长包类型。当`ResourceType`为`DesktopMonthPackage`时，该字段必填。枚举值： 120：120小时/月。 250：250小时/月。	120
RootDiskCategory	string	否	系统盘类型。枚举值： cloud_efficiency：高效云盘。 cloud_auto：极速云盘。 cloud_essd：增强型SSD云盘，仅部分规格支持。	40
UserDiskCategory	string	否	数据盘类型。枚举值： cloud_efficiency：高效云盘。 cloud_auto：极速云盘。 cloud_essd：增强型SSD云盘，仅部分规格支持。	80
ResellerOwnerUid	long	否	转售模式的资源归属用户 ID，非转售模式无需填写该参数。	1422724566551XXX

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	B1175630-3C44-4389-A3C1-15639FFC8EBC
PriceInfo	object	价格详细信息。
Rules	array<object>	活动规则信息。
Rule	object	活动规则信息。
Description	string	规则描述。	买满1年，立享官网价格8.5折优惠。
RuleId	long	规则 ID。	587
Price	object	价格信息。
OriginalPrice	float	原价。	79.0
DiscountPrice	float	折减的价格。	15.8
Currency	string	货币单位（CNY）。	CNY/USD
TradePrice	float	实际付款价格。取值为原价减去折减的价格。	63.2
Promotions	array<object>	促销活动信息。
Promotion	object	促销活动信息。
PromotionDesc	string	促销信息描述。	新品上市，立享优惠
OptionCode	string	促销活动规则描述。	test
Selected	boolean	是否被选中。	false
PromotionId	string	促销活动 ID。	123456
PromotionName	string	促销活动名称。	精选特惠
OrderLines	object	订单信息。
	string	订单信息。	5376483****
SpPrice	long	节省计划下的价格。	50.00
FreeCdsQuota	boolean	是否有免费企业网盘。	true
FreeCdsSize	long	企业网盘的免费容量。单位：GiB。	100

示例

正常返回示例

JSON格式

{
  "RequestId": "B1175630-3C44-4389-A3C1-15639FFC8EBC",
  "PriceInfo": {
    "Rules": [
      {
        "Description": "买满1年，立享官网价格8.5折优惠。",
        "RuleId": 587
      }
    ],
    "Price": {
      "OriginalPrice": 79,
      "DiscountPrice": 15.8,
      "Currency": "CNY/USD",
      "TradePrice": 63.2,
      "Promotions": [
        {
          "PromotionDesc": "新品上市，立享优惠",
          "OptionCode": "test",
          "Selected": false,
          "PromotionId": 123456,
          "PromotionName": "精选特惠"
        }
      ],
      "OrderLines": {
        "key": "5376483****"
      },
      "SpPrice": 50
    },
    "FreeCdsQuota": true,
    "FreeCdsSize": 100
  }
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-11-09	OpenAPI 入参发生变更	查看变更详情
2024-09-27	OpenAPI 入参发生变更	查看变更详情
2024-07-25	OpenAPI 入参发生变更	查看变更详情
2021-10-28	OpenAPI 入参发生变更	查看变更详情
2021-10-28	OpenAPI 入参发生变更	查看变更详情