Release Notes
Announcements
Security Announcements
Domain name for API request: emr.intl.tencentcloudapi.com.
This API is used to query price of scale-out.
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: InquiryPriceScaleOutInstance. |
| 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 of scale-out. Valid value:PayMode is 0, TimeUnit can only be s. |
| TimeSpan | Yes | Integer | Time span of scale-out, which needs to be used together with TimeUnit.PayMode is 0, TimeSpan can only be 3,600. |
| ZoneId | Yes | Integer | ID of the AZ where an instance resides. |
| PayMode | Yes | Integer | Instance billing mode. Valid value: |
| InstanceId | Yes | String | Instance ID. |
| CoreCount | Yes | Integer | Number of core nodes to be added. |
| TaskCount | Yes | Integer | Number of task nodes to be added. |
| Currency | Yes | String | Currency. |
| RouterCount | No | Integer | Number of router nodes to be added. |
| MasterCount | No | Integer | Number of master nodes to be added. |
| ResourceBaseType | No | String | The type can be ComputeResource, EMR, or a default value. The default value is EMR. |
| ComputeResourceId | No | String | Computing resource ID. |
| HardwareResourceType | No | String | Scale-out resource type. |
| Parameter Name | Type | Description |
|---|---|---|
| OriginalCost | String | Original price. |
| DiscountCost | String | Discounted price. |
| Unit | String | Time unit of scale-out. Valid values. |
| PriceSpec | PriceResource | Node spec queried for price. Note: This field may return null, indicating that no valid values can be obtained. |
| MultipleEmrPrice | Array of EmrPrice | The inquiry results corresponding to the specs specified by the input parameter MultipleResources, with the result of the first spec returned by other output parameters.Note: This field may return null, indicating that no valid values can be obtained. |
| 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 perform a scale-out inquiry.
POST / HTTP/1.1
Host: emr.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: InquiryPriceScaleOutInstance
<Common request parameters>
{
"TimeSpan": "3600",
"InstanceId": "emr-3ida6zmi",
"CoreCount": "1",
"ZoneId": "100003",
"PayMode": "0",
"Currency": "CNY",
"TaskCount": "0",
"TimeUnit": "s",
"RouterCount": "0"
}{
"Response": {
"DiscountCost": "0.65",
"MultipleEmrPrice": [
{
"DiscountCost": "0.65",
"OriginalCost": "1.21",
"PriceSpec": {
"Cpu": 4,
"DiskCnt": 0,
"DiskNum": 0,
"DiskSize": 200,
"DiskType": "CLOUD_HSSD",
"InstanceType": "S6.LARGE8",
"LocalDiskNum": 0,
"MemSize": 8192,
"MultiDisks": [],
"RootSize": 70,
"Spec": "CVM.S6",
"StorageType": 6,
"Tags": null
},
"SupportSpotPaid": true,
"Unit": "s"
}
],
"OriginalCost": "1.21",
"PriceSpec": {
"Cpu": 4,
"DiskCnt": 0,
"DiskNum": 0,
"DiskSize": 200,
"DiskType": "CLOUD_HSSD",
"InstanceType": "S6.LARGE8",
"LocalDiskNum": 0,
"MemSize": 8192,
"MultiDisks": [],
"RootSize": 70,
"Spec": "CVM.S6",
"StorageType": 6,
"Tags": null
},
"RequestId": "e0acae32-c70d-4d32-80bd-b2e528a33026",
"Unit": "s"
}
}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 | Operation failed. |
| 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.InvalidAppId | Invalid AppId. |
| InvalidParameter.InvalidCoreCount | The number of core nodes is invalid. |
| InvalidParameter.InvalidCountNum | A scale-out request only applies to task nodes or core nodes. |
| InvalidParameter.InvalidInstanceType | Invalid model. |
| InvalidParameter.InvalidModifySpec | Invalid target specification. |
| InvalidParameter.InvalidPaymode | Invalid billing mode. |
| InvalidParameter.InvalidResourceSpec | Invalid resource specification. |
| InvalidParameter.InvalidTimeSpan | Invalid timespan. |
| InvalidParameter.InvalidTimeUnit | Invalid TimeUnit. |
| InvalidParameter.InvalidVpcId | Invalid VPC ID. |
| ResourceInsufficient.DiskInsufficient | The disk specification is insufficient. |
| ResourceInsufficient.InstanceInsufficient | The node specification is unsupported or has been sold out. |
| ResourceNotFound.InstanceNotFound | The instance was not found. |
| ResourceUnavailable.ResourceSpecNotDefaultSpec | There is no default value of the current resource spec. |
| ResourcesSoldOut.CvmSoldOut | CVM instances have been sold out. |
フィードバック