tencent cloud

APIs

DocumentationAPIsElastic MapReduceCluster Resource Management APIsInquiryPriceUpdateInstance

InquiryPriceUpdateInstance

Download
Focus Mode
Font Size
Last updated: 2026-10-10 14:59:11

1. API Description

Domain name for API request: emr.intl.tencentcloudapi.com.

This API is used to inquire the price for the configuration change.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: InquiryPriceUpdateInstance.
Version Yes String Common Params. The value used for this API: 2019-01-03.
Region Yes String Common Params. For more information, please see the list of regions supported by the product.
TimeUnit Yes String Time unit for the configuration change. Valid values:
  • s: second. When PayMode is set to 0, TimeUnit can only be set to s.
  • m: month. When PayMode is set to 1, TimeUnit can only be set to m.
    		•
    TimeSpan Yes Integer Configuration change duration, which is used together with TimeUnit.
  • When TimeUnit is set to s, this parameter can only be set to 3600, indicating a pay-as-you-go instance.
  • When TimeUnit is set to m, the number entered for this parameter indicates the purchase duration of a yearly/monthly subscription instance. For example, the value 1 indicates one month.
    		•
    PayMode Yes Integer Instance billing mode. Valid values:
  • 0: pay-as-you-go
  • 1: monthly subscription
    		•
    UpdateSpec No UpdateInstanceSettings
    Placement No Placement
    Currency No String Currency type. Valid values:
  • CNY: RMB
    		•
    ResourceIdList.N No Array of String ID list of resources modified in batches.

    3. Output Parameters

    Parameter Name Type Description
    OriginalCost Float Original price (CNY).
    DiscountCost Float Discounted price (CNY).
    TimeUnit String Time unit for the configuration change. Valid values:
  • s: indicates second.
  • m: indicates month.
    		•
    TimeSpan Integer
    PriceDetail Array of PriceDetail Price details.
    NewConfigPrice PriceResult Price of the new configuration.
    RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

    4. Example

    Example1 Inquiring the Price for the Configuration Change

    Input Example

    POST / HTTP/1.1
Host: emr.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: InquiryPriceUpdateInstance
<Common request parameters>

{
    "Placement": {
        "ProjectId": 0,
        "Zone": "100003"
    },
    "TimeSpan": 3600,
    "UpdateSpec": {
        "ResourceId": "emr-vm-a0xxx9on",
        "CPUCores": 8,
        "Memory": 16
    },
    "PayMode": 0,
    "Currency": "CNY",
    "TimeUnit": "s"
}

    Output Example

    {
    "Response": {
        "DiscountCost": 2.01,
        "OriginalCost": 3.04,
        "RequestId": "95eb9120-0883-407c-aa5a-43b4e2c250d1",
        "TimeSpan": 3600,
        "TimeUnit": "s",
        "PriceDetail": [
            {
                "Formula": "(1). Configuration change order amount: CNY 2870.4 [New configuration unit price 3546.4 x Duration 1 x Discount 100% - Old configuration unit price 676 x Duration 1 x Discount 100%]<br/>(2). Duration: 1 month",
                "DiscountCost": 2870.4,
                "ResourceId": "emr-vm-xxxxxxx",
                "OriginalCost": 2870.4
            }
        ]
    }
}

    5. Developer Resources

    SDK

    TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

    Command Line Interface

    6. Error Code

    The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

    Error Code Description
    FailedOperation.GetTradeServerFailed Failed to call the inquiry center service.
    InternalError.AccountCgwError Internal service call exception.
    InternalError.CamCgwError Internal service call exception.
    InternalError.CamError Internal service call exception.
    InternalError.CbsCgwError Internal service call exception.
    InternalError.CbsError Internal service call exception.
    InternalError.CdbCgwError Internal service call exception.
    InternalError.CdbError Internal service call exception.
    InternalError.CheckQuotaErr Insufficient CVM or CBS resources, or invalid software.
    InternalError.ConfigCgwError Internal service call exception.
    InternalError.CvmError Internal service call exception.
    InternalError.KmsError Internal service call exception.
    InternalError.ProjectCgwError Internal service call exception.
    InternalError.SgError An exception occurred when the security group API is called.
    InternalError.TagError Internal service call exception.
    InternalError.TradeCgwError Internal service call exception.
    InternalError.VpcCgwError Internal service call exception.
    InternalError.VpcError Internal service call exception.
    InvalidParameter.InvalidAppId Invalid parameter: APPID.
    InvalidParameter.InvalidClusterId Invalid parameter: ClusterId.
    InvalidParameter.InvalidModifySpec Invalid specifications for configuration change.
    InvalidParameter.InvalidResourceSpec Invalid resource specifications.
    InvalidParameter.InvalidTimeSpan Invalid timespan.
    InvalidParameter.InvalidTimeUnit Invalid TimeUnit.
    InvalidParameter.InvalidVpcId Invalid VPC ID.
    InvalidParameter.InvalidZone Invalid AZ.
    InvalidParameter.ZoneResourceNotMatch The AZ does not match resources.
    ResourceNotFound.InstanceNotFound The instance cannot be found.
    ResourceNotFound.ResourceNotFound The monitoring metadata cannot be found.
    Previous Topic: InquiryPriceScaleOutInstanceNext Topic: ScaleOutCluster

    Help and Support

    Was this page helpful?

    Help us improve! Rate your documentation experience in 5 mins.

    Feedback

    Search
      Enter keywords to search documentation