All Products
Search

This Product

    Elastic Desktop Service:DescribePrice

    Document Center

    Elastic Desktop Service:DescribePrice

    Last Updated:Nov 14, 2025

    Queries the prices of Elastic Desktop Service (EDS) resources.

    Operation description

    Usage notes

    The request parameters vary based on the type of desktop resources whose price you want to query. Take note of the following items:

    • If you set ResourceType to OfficeSite, you must specify InstanceType.
    • If you set ResourceType to Bandwidth, the pay-by-data-transfer metering method is used for network billing.
    • If you set ResourceType to Desktop, you must specify InstanceType, RootDiskSizeGib, and UserDiskSizeGib. You can specify OsType, PeriodUnit, Period, and Amount based on your business requirements.
    Note Before you call this operation to query the prices of cloud desktops by setting ResourceType to Desktop, you must know the desktop types and disk sizes that EDS provides. The disk sizes vary based on the desktop types. For more information, see Cloud desktop types.

    Debugging

    You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

    Authorization information

    The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

    • Operation: the value that you can use in the Action element to specify the operation on a resource.
    • Access level: the access level of each operation. The levels are read, write, and list.
    • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
      • For mandatory resource types, indicate with a prefix of * .
      • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
    • Condition Key: the condition key that is defined by the cloud service.
    • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
    OperationAccess levelResource typeCondition keyAssociated operation
    ecd:DescribePricenone
    *All Resources
    *
      none
    		none

    Request parameters

    ParameterTypeRequiredDescriptionExample
    RegionIdstringYes

    The region ID. You can call the DescribeRegions operation to query the regions supported by EDS.

    		cn-hangzhou
    ResourceTypestringNo

    The type of the resource.

    Valid values:

    • DesktopMonthPackage: monthly subscription cloud computers that use hourly limit plans.
    • Desktop (default): pay-as-you-go cloud computers/monthly subscription cloud computers that use unlimited plans.
    • Bandwidth: premium bandwidth plans.
    • DesktopGroup: cloud computer shares.
    		Desktop
    InstanceTypestringNo

    The specifications of the resource.

    • This parameter is required if you set ResourceType to Desktop. You can call the DescribeDesktopTypes to query the available cloud computer types that correspond to the value of DesktopTypeId.
    • If you set ResourceType to DesktopGroup, set the value of this parameter to large.
    • If you set ResourceType to Bandwidth, you can leave this parameter empty.
    		eds.general.2c2g
    RootDiskSizeGibintegerNo

    The size of the system disk. Unit: GiB. If you set ResourceType to Desktop, you must specify this parameter.

    		80
    UserDiskSizeGibintegerNo

    The size of the data disk. Unit: GiB.

    		100
    OsTypestringNo

    The OS type.

    Valid values:

    • Linux
    • Windows (default)
    		Windows
    PeriodUnitstringNo

    The billing cycle.

    Valid values:

    • Month
    • Year
    • Hour (default)
    		Hour
    PeriodintegerNo

    The subscription duration. The valid values of this parameter vary based on the value of PeriodUnit.

    • If you set PeriodUnit to Hour, set the value of this parameter to 1.
    • If you set PeriodUnit to Month, set the value of this parameter to 1, 2, 3, or 6.
    • If you set PeriodUnit to Year, set the value of this parameter to 1, 2, or 3.

    Default value: 1.

    		1
    AmountintegerNo

    The number of resources. Default value: 1.

    		1
    PromotionIdstringNo

    The promotion ID.

    		123456
    InternetChargeTypestringNo

    The metering method for network traffic.

    Valid values:

    • PayByTraffic: You are charged for the actually consumed traffic.
    • PayByBandwidth: You are charged by a fixed bandwidth.
    		PayByTraffic
    BandwidthintegerNo

    The maximum public bandwidth. Unit: Mbit/s.

    • Valid values if you set InternetChargeType to PayByBandwidth: 10 to 1000.
    • Valid values if you set InternetChargeType to InternetChargeType: 10 to 200.
    		10
    GroupDesktopCountintegerNo

    The number of cloud computer shares. Default value: 1.

    Note This parameter takes effect only if you set ResourceType to DesktopGroup.
    		1
    DurationintegerNo

    The type of hourly plan if you use the Monthly Subscription billing method. If you set ResourceType to DesktopMonthPackage, you must specify this parameter.

    Valid values:

    • 120: the 120-hour computing plan.
    • 250: the 250-hour computing plan.
    		120
    RootDiskCategorystringNo

    The category of the system disk.

    Valid values:

    • cloud_efficiency: the ultra disk
    • cloud_auto: the standard SSD.
    • cloud_essd: the Enterprise SSD (ESSD). Take note that only specific cloud computer types support ESSDs.
    		40
    UserDiskCategorystringNo

    The category of the data disk.

    Valid values:

    • cloud_efficiency: the ultra disk
    • cloud_auto: the standard SSD.
    • cloud_essd: the ESSD. Take note that only specific cloud computer types support ESSDs.
    		80

    Response parameters

    ParameterTypeDescriptionExample
    object
    RequestIdstring

    The request ID.

    		B1175630-3C44-4389-A3C1-15639FFC8EBC
    PriceInfoobject

    The price details.

    Rulesarray<object>

    The details of the promotion rules.

    Ruleobject
    Descriptionstring

    The description of the rule.

    		Receive a 15% discount on a one-year subscription.
    RuleIdlong

    The rule ID.

    		587
    Priceobject

    The price.

    OriginalPricefloat

    The original price.

    		2.796
    DiscountPricefloat

    The discounted amount.

    		0
    Currencystring

    The unit of currency (USD).

    		CNY
    TradePricefloat

    The actual price. The original price minus the discounted amount equals the actual price.

    		2.796
    Promotionsarray<object>

    The promotions.

    Promotionobject

    The promotion.

    PromotionDescstring

    The description of the promotion.

    		Get started with new services with a discount.
    OptionCodestring

    The description of the promotion rule.

    		test
    Selectedboolean

    Indicates whether an item is selected.

    		false
    PromotionIdstring

    The promotion ID.

    		123456
    PromotionNamestring

    The promotion name.

    		Special Offer
    OrderLinesobject

    The orders.

    string

    The order.

    		5376483****
    SpPricelong

    The price under an effective savings plan.

    		50.00
    FreeCdsQuotaboolean

    Indicates whether a free enterprise drive is available.

    		true
    FreeCdsSizelong

    The free capacity provided by the enterprise drive. Unit: GiB.

    		100

    Examples

    Sample success responses

    JSONformat

    {
  "RequestId": "B1175630-3C44-4389-A3C1-15639FFC8EBC",
  "PriceInfo": {
    "Rules": [
      {
        "Description": "Receive a 15% discount on a one-year subscription.\n",
        "RuleId": 587
      }
    ],
    "Price": {
      "OriginalPrice": 2.796,
      "DiscountPrice": 0,
      "Currency": "CNY",
      "TradePrice": 2.796,
      "Promotions": [
        {
          "PromotionDesc": "Get started with new services with a discount.\n",
          "OptionCode": "test",
          "Selected": false,
          "PromotionId": 123456,
          "PromotionName": "Special Offer\n"
        }
      ],
      "OrderLines": {
        "key": "5376483****"
      },
      "SpPrice": 50
    },
    "FreeCdsQuota": true,
    "FreeCdsSize": 100
  }
}

    Error codes

    For a list of error codes, visit the Service error codes.

    Change history

    Change timeSummary of changesOperation
    2025-11-04The internal configuration of the API is changed, but the call is not affectedView Change Details
    2024-11-09The request parameters of the API has changedView Change Details
    2024-09-27The request parameters of the API has changedView Change Details
    2024-07-25The request parameters of the API has changedView Change Details
    2021-10-28The request parameters of the API has changedView Change Details
    2021-10-28The request parameters of the API has changedView Change Details