Release Notes
Announcements
Security Announcements
Domain name for API request: emr.intl.tencentcloudapi.com.
This API is used to query the price for renewal.
A maximum of 20 requests can be initiated per second for this API.
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: InquiryPriceRenewInstance. |
| 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. |
| TimeSpan | Yes | Integer | How long the instance will be renewed for, which needs to be used together with TimeUnit. |
| PayMode | Yes | Integer | Instance billing mode. |
| ResourceIds.N | No | Array of String | List of resource IDs of the node to be renewed. The resource ID is in the format of emr-vm-xxxxxxxx. A valid resource ID can be queried in the console. |
| TimeUnit | No | String | Unit of time for instance renewal. |
| Currency | No | String | Currency. |
| Placement | No | Placement | Location of the instance. This parameter is used to specify the AZ, project, and other attributes of the instance. |
| ModifyPayMode | No | Integer | Whether to change from pay-as-you-go billing to monthly subscription billing. 0: no; 1: yes |
| NeedDetail | No | Boolean | Whether the renewal price for every node is required. |
| InstanceId | No | String | Cluster ID. This parameter can be filled to get renewal information for all yearly/monthly subscription nodes in the cluster. |
| Parameter Name | Type | Description |
|---|---|---|
| OriginalCost | Float | Original price. |
| DiscountCost | Float | Discounted price. |
| TimeUnit | String | Time unit for instance renewal. |
| TimeSpan | Integer | Duration of instance renewal. |
| PriceDetail | Array of PriceDetail | Price details. Note: This field may return null, indicating that no valid values can be obtained. |
| NodeRenewPriceDetails | Array of NodeRenewPriceDetail | Node renewal pricing list. |
| 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. |
This example shows you how to query the renewal price.
POST / HTTP/1.1
Host: emr.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: InquiryPriceRenewInstance
<Common request parameters>
{
"Placement": {
"ProjectId": "0",
"Zone": "ap-guangzhou-4"
},
"Currency": "CNY",
"TimeSpan": "1",
"PayMode": "1",
"ResourceIds": [
"emr-vm-jv1s4zas"
],
"TimeUnit": "m"
}{
"Response": {
"DiscountCost": 596.54,
"OriginalCost": 898.9,
"RequestId": "223c838e-ce27-4adf-9a41-89661fe7ad21",
"TimeSpan": 1,
"TimeUnit": "m"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
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.GetCvmServerFailed | Failed to call the CVM service. |
| InternalError | Internal error. |
| InternalError.AccountCgwError | An error occurred while calling another service API. |
| InternalError.CamCgwError | An error occurred while calling another service API. |
| InternalError.CamError | An error occurred while calling another service API. |
| InternalError.CbsCgwError | An error occurred while calling another service API. |
| InternalError.CbsError | An error occurred while calling another service API. |
| InternalError.CdbCgwError | An error occurred while calling another service API. |
| InternalError.CdbError | An error occurred while calling another service API. |
| InternalError.CheckQuotaErr | CVM or CBS resources are insufficient, or the software is invalid. |
| InternalError.ConfigCgwError | An error occurred while calling another service API. |
| InternalError.CvmError | An error occurred while calling another service API. |
| InternalError.KmsError | An error occurred while calling another service API. |
| InternalError.ProjectCgwError | An error occurred while calling another service API. |
| InternalError.SgError | An error occurred when calling a security group API. |
| InternalError.TagError | An error occurred while calling another service API. |
| InternalError.TradeCgwError | An error occurred while calling another service API. |
| InternalError.VpcCgwError | An error occurred while calling another service API. |
| InternalError.VpcError | An error occurred while calling another service API. |
| InvalidParameter.InvalidResourceIds | Invalid resource ID. |
| InvalidParameter.InvalidResourceSpec | Invalid resource specification. |
| InvalidParameter.InvalidTimeSpan | Invalid timespan. |
| InvalidParameter.InvalidTimeUnit | Invalid TimeUnit. |
| InvalidParameter.PayModeResourceNotMatch | The billing mode and resource do not match. |
| InvalidParameter.ProjectResourceNotMatch | The project does not match the resource. |
| InvalidParameter.ZoneResourceNotMatch | The AZ and resource do not match. |
| ResourceInUse.InstanceInProcess | The instance is under workflow. |
| ResourceNotFound.InstanceNotFound | The instance was not found. |
| ResourceNotFound.ResourceNotFound | Unable to find the monitoring metadata. |
フィードバック