All Products
Search

This Product

    Compute Nest:GetServiceEstimateCost

    Document Center

    Compute Nest:GetServiceEstimateCost

    Last Updated:Oct 22, 2025

    Queries the estimated cost of creating a service instance.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    computenest:GetServiceEstimateCost

    get

    *Service

    acs:computenest:{#regionId}:{#accountId}:service/{#ServiceId}

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    The region ID.

    cn-hangzhou
    ServiceId

    string

    Yes

    The service ID.

    service-12xxxxxx
    ServiceVersion

    string

    No

    The service version.

    1
    TemplateName

    string

    No

    The template name.

    模板1
    Parameters

    object

    No

    The parameters to deploy the service instance.

    { \"RegionId\": \"cn-hangzhou\", \"InstanceType\": \"ecs.g5.large\"}
    ClientToken

    string

    No

    A client token to ensure the idempotence of the request. Generate a unique value for each request. The ClientToken supports only ASCII characters and cannot be longer than 64 characters.

    qwertyuiop
    TrialType

    string

    No

    The usage type. Valid values:

    • Trial: The service supports a free trial.

    • NotTrial: The service does not support a free trial.

    NotTrial
    SpecificationName

    string

    No

    The specification name.

    套餐一
    ServiceInstanceId

    string

    No

    The service instance ID.

    si-d6ab3a63ccbb4b17xxxx
    Commodity

    object

    No

    The subscription period for the purchase order.

    PayPeriodUnit

    string

    No

    The unit of the subscription duration. Valid values:

    • Year: Year.

    • Month: Month.

    • Day: Day.

    Year
    PayPeriod

    integer

    No

    The subscription duration.

    1
    CouponId

    string

    No

    The coupon ID.

    302070970220
    QuotationId

    string

    No

    The ID of the private offer in Alibaba Cloud Marketplace.

    17cde2e8-2f5d-xxxx-xxxx-5120dd215d66
    OperationName

    string

    No

    The name of the upgrade or downgrade operation.

    参数变配

    Response elements

    Element

    Type

    Description

    Example

    object

    The response body.

    RequestId

    string

    The request ID.

    08ABBB67-39C9-5EE7-98E5-80486F75CE8D
    Resources

    object

    The list of resources.

    { "EcsInstance" : { "Type" : "ALIYUN::ECS::Instance", "Success" : true, "Result" : { "Order" : { "Currency" : "CNY", "RuleIds" : [ "102111101338****" ], "DetailInfos" : { "ResourcePriceModel" : [ { "OriginalPrice" : 0, "DiscountPrice" : 0, "SubRules" : { "Rule" : [ ] }, "Resource" : "bandwidth", "TradePrice" : 0 }, { "OriginalPrice" : 0, "DiscountPrice" : 0, "SubRules" : { "Rule" : [ ] }, "Resource" : "image", "TradePrice" : 0 }, { "OriginalPrice" : 0.366666, "DiscountPrice" : 0.249012, "SubRules" : { "Rule" : [ ] }, "Resource" : "instanceType", "TradePrice" : 0.117654 }, { "OriginalPrice" : 0.055555, "DiscountPrice" : 0.037729, "SubRules" : { "Rule" : [ ] }, "Resource" : "systemDisk", "TradePrice" : 0.017826 } ] }, "TradeAmount" : 0.135, "OriginalAmount" : 0.422, "Coupons" : { "Coupon" : [ ] }, "DiscountAmount" : 0.287 }, "OrderSupplement" : { "PriceUnit" : "/Hour", "ChargeType" : "PostPaid", "Quantity" : 1, "PriceType" : "Total" }, "Rules" : { "Rule" : [ { "RuleDescId" : "102111101338****", "Name" : "合同优惠_多计费项优惠_3.208750折" } ] } } } }

    any

    The list of resources.

    { "EcsInstance" : { "Type" : "ALIYUN::ECS::Instance", "Success" : true, "Result" : { "Order" : { "Currency" : "CNY", "RuleIds" : [ "102111101338****" ], "DetailInfos" : { "ResourcePriceModel" : [ { "OriginalPrice" : 0, "DiscountPrice" : 0, "SubRules" : { "Rule" : [ ] }, "Resource" : "bandwidth", "TradePrice" : 0 }, { "OriginalPrice" : 0, "DiscountPrice" : 0, "SubRules" : { "Rule" : [ ] }, "Resource" : "image", "TradePrice" : 0 }, { "OriginalPrice" : 0.366666, "DiscountPrice" : 0.249012, "SubRules" : { "Rule" : [ ] }, "Resource" : "instanceType", "TradePrice" : 0.117654 }, { "OriginalPrice" : 0.055555, "DiscountPrice" : 0.037729, "SubRules" : { "Rule" : [ ] }, "Resource" : "systemDisk", "TradePrice" : 0.017826 } ] }, "TradeAmount" : 0.135, "OriginalAmount" : 0.422, "Coupons" : { "Coupon" : [ ] }, "DiscountAmount" : 0.287 }, "OrderSupplement" : { "PriceUnit" : "/Hour", "ChargeType" : "PostPaid", "Quantity" : 1, "PriceType" : "Total" }, "Rules" : { "Rule" : [ { "RuleDescId" : "102111101338****", "Name" : "合同优惠_多计费项优惠_3.208750折" } ] } } } }
    Commodity

    object

    The information about the Alibaba Cloud Marketplace purchase order.

    {'cmgj00059839': {'Result': {'InquiryType': 'Buy', 'Order': {'Currency': 'CNY', 'DiscountAmount': '0.0', 'TradeAmount': '0.01', 'OriginalAmount': '0.01'}}}}

    object

    The information about the Alibaba Cloud Marketplace purchase order.

    Result

    object

    The Result model.

    Order

    object

    The order information.

    Currency

    string

    The currency code.

    CNY
    TradeAmount

    string

    The amount after the discount is applied.

    9.99
    DiscountAmount

    string

    The discount amount.

    1.99
    OriginalAmount

    string

    The original amount.

    11.98
    InquiryType

    string

    The inquiry type. Valid values:

    1. Buy: an inquiry for a new purchase.

    2. ModificationBuy: an inquiry for an upgrade or downgrade.

    Buy
    SubOrders

    object

    The sub-orders.

    SubOrder

    array<object>

    The sub-orders.

    object

    The sub-order object.

    ModuleInstance

    array<object>

    The module or instance information.

    object

    The module or instance object.

    ModuleId

    integer

    The module ID.

    1234
    ModuleName

    string

    The module name.

    数据库类型
    ModuleCode

    string

    The module code.

    rds_dbtype
    TotalProductFee

    number

    The original price of the product, in CNY.

    10.00
    DiscountFee

    number

    The discount, in CNY.

    1.99
    PayFee

    number

    The amount payable, in CNY.

    8.01
    PriceUnit

    string

    The unit of the price.

    元/GB/小时
    IsPricingModule

    boolean

    Indicates whether the module is a billing item.

    true
    NeedOrderPay

    boolean

    Indicates whether payment is required for the module in the order.

    true
    PriceType

    string

    The pricing type.

    hourPrice
    ModuleAttrs

    array<object>

    The module attributes.

    object

    The module attribute object.

    Type

    integer

    The attribute type. Valid values:

    1. 1: product attribute

    2. 2: specification attribute

    3. 3: module attribute

    4. 4: external parameter (reserved)

    3
    Name

    string

    The attribute name.

    20GB
    Code

    string

    The attribute code.

    rds_storage
    Value

    string

    The attribute value.

    20
    Unit

    string

    The unit of the value.

    GB
    ModuleNameEn

    string

    The English name of the module.

    数据单元
    PriceUnitEn

    string

    The English name of the price unit.

    元/月
    Coupons

    array<object>

    The coupons.

    object

    The coupon.

    CanPromFee

    number

    The payable amount.

    9.99
    CouponDesc

    string

    The description of the coupon.

    10元优惠券（有效期至2024年9月8日）
    CouponName

    string

    The name of the coupon.

    10元优惠券
    CouponOptionNo

    string

    The coupon number.

    50008800000xxxx
    Selected

    boolean

    Indicates whether the coupon is selected.

    true

    Examples

    Success response

    JSON format

    {
  "RequestId": "08ABBB67-39C9-5EE7-98E5-80486F75CE8D",
  "Resources": {
    "key": "{\n    \"EcsInstance\" : {\n      \"Type\" : \"ALIYUN::ECS::Instance\",\n      \"Success\" : true,\n      \"Result\" : {\n        \"Order\" : {\n          \"Currency\" : \"CNY\",\n          \"RuleIds\" : [ \"102111101338****\" ],\n          \"DetailInfos\" : {\n            \"ResourcePriceModel\" : [ {\n              \"OriginalPrice\" : 0,\n              \"DiscountPrice\" : 0,\n              \"SubRules\" : {\n                \"Rule\" : [ ]\n              },\n              \"Resource\" : \"bandwidth\",\n              \"TradePrice\" : 0\n            }, {\n              \"OriginalPrice\" : 0,\n              \"DiscountPrice\" : 0,\n              \"SubRules\" : {\n                \"Rule\" : [ ]\n              },\n              \"Resource\" : \"image\",\n              \"TradePrice\" : 0\n            }, {\n              \"OriginalPrice\" : 0.366666,\n              \"DiscountPrice\" : 0.249012,\n              \"SubRules\" : {\n                \"Rule\" : [ ]\n              },\n              \"Resource\" : \"instanceType\",\n              \"TradePrice\" : 0.117654\n            }, {\n              \"OriginalPrice\" : 0.055555,\n              \"DiscountPrice\" : 0.037729,\n              \"SubRules\" : {\n                \"Rule\" : [ ]\n              },\n              \"Resource\" : \"systemDisk\",\n              \"TradePrice\" : 0.017826\n            } ]\n          },\n          \"TradeAmount\" : 0.135,\n          \"OriginalAmount\" : 0.422,\n          \"Coupons\" : {\n            \"Coupon\" : [ ]\n          },\n          \"DiscountAmount\" : 0.287\n        },\n        \"OrderSupplement\" : {\n          \"PriceUnit\" : \"/Hour\",\n          \"ChargeType\" : \"PostPaid\",\n          \"Quantity\" : 1,\n          \"PriceType\" : \"Total\"\n        },\n        \"Rules\" : {\n          \"Rule\" : [ {\n            \"RuleDescId\" : \"102111101338****\",\n            \"Name\" : \"合同优惠_多计费项优惠_3.208750折\"\n          } ]\n        }\n      }\n    }\n  }"
  },
  "Commodity": {
    "key": {
      "Result": {
        "Order": {
          "Currency": "CNY",
          "TradeAmount": "9.99",
          "DiscountAmount": "1.99",
          "OriginalAmount": "11.98"
        },
        "InquiryType": "Buy",
        "SubOrders": {
          "SubOrder": [
            {
              "ModuleInstance": [
                {
                  "ModuleId": 1234,
                  "ModuleName": "数据库类型",
                  "ModuleCode": "rds_dbtype",
                  "TotalProductFee": 10,
                  "DiscountFee": 1.99,
                  "PayFee": 8.01,
                  "PriceUnit": "元/GB/小时",
                  "IsPricingModule": true,
                  "NeedOrderPay": true,
                  "PriceType": "hourPrice",
                  "ModuleAttrs": [
                    {
                      "Type": 3,
                      "Name": "20GB",
                      "Code": "rds_storage",
                      "Value": "20",
                      "Unit": "GB"
                    }
                  ],
                  "ModuleNameEn": "数据单元",
                  "PriceUnitEn": "元/月"
                }
              ]
            }
          ]
        },
        "Coupons": [
          {
            "CanPromFee": 9.99,
            "CouponDesc": "10元优惠券（有效期至2024年9月8日）",
            "CouponName": "10元优惠券",
            "CouponOptionNo": "50008800000xxxx",
            "Selected": true
          }
        ]
      }
    }
  }
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.