tencent cloud

DescribeNodeSpec
Last updated: 2025-11-13 20:49:04
DescribeNodeSpec
Last updated: 2025-11-13 20:49:04

1. API Description

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

This API is used to query node specifications.

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: DescribeNodeSpec.
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.
ZoneId Yes Integer Availability zone (AZ) ID. https://document.capi.woa.com/document/api/1605/76892 can be accessed for related information.
CvmPayMode Yes Integer 0: pay-as-you-go; 1: yearly/monthly subscription; 99: a combination of pay-as-you-go and yearly/monthly subscription. Invalid values will suppress billing display.
NodeType Yes String Node type: Master,Core,Task,Router,All.
TradeType Yes Integer 0: old billing page; 1: new billing page. Invalid values will be deemed to be old billing by default.
ProductId Yes Integer Product ID. If left blank, the value is "0". This field is used to represent the product ID in all situations. It is required in front-end scenarios.

44 EMR V3.5.0
43 EMR V3.4.0.tlinux
42 EMR V2.7.0.tlinux
41 DRUID V1.1.0
67 STARROCKS V2.2.0
45 DRUID V1.1.0.tlinux
40 EMRCLOUD v3.2.0
47 EMR V4.0.0
48 STARROCKS V1.2.0
49 STARROCKS V1.3.0
50 KAFKA V2.0.0
51 STARROCKS V1.4.0
52 EMR-TKE V1.0.0
53 EMR V3.6.0
54 STARROCKS V2.0.0
55 EMR-TKE V1.0.1
56 EMR-TKE DLCV1.0.0
57 EMR V2.8.0
58 EMR V3.6.1
59 SERVERLESS V1.0.0
60 EMR-TKE V1.1.0
62 STARROCKS V2.1.1
63 STARROCKS V2.1.1.tlinux
64 EMR-TKE TCCV1.0.0
65 EMR-TKE-AI V1.0.0
66 RSS V1.0.0
24 EMR TianQiong-V1.0.0
3 EMR V2.0.1.tlinux
4 EMR V2.1.0
7 EMR V3.0.0
8 EMR V3.0.0.tlinux
9 EMR V2.2.0
11 CLICKHOUSE V1.0.0
12 CLICKHOUSE V1.0.0.tlinux
16 EMR V2.3.0
17 CLICKHOUSE V1.1.0
18 CLICKHOUSE V1.1.0.tlinux
19 EMR V2.4.0
20 EMR V2.5.0
21 USERCUSTOM V1.0.0
22 CLICKHOUSE V1.2.0
39 STARROCKS V1.1.0
25 EMR V3.1.0
26 DORIS V1.0.0
27 KAFKA V1.0.0
28 EMR V3.2.0
29 EMR V2.5.1
30 EMR V2.6.0
32 DORIS V1.1.0
33 EMR V3.2.1
34 EMR V3.3.0
35 DORIS V1.2.0
36 STARROCKS V1.0.0
37 EMR V3.4.0
38 EMR V2.7.0
SceneName Yes String Scenario name.
ResourceBaseType No String The type can be ComputeResource, EMR, or a default value. The default value is EMR.
ComputeResourceId No String Computing resource ID.

3. Output Parameters

Parameter Name Type Description
NodeSpecs Array of DescribeNodeSpec Node specification type.
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 Querying Node Specifications

Input Example

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

{
    "ZoneId": 190001,
    "CvmPayMode": 0,
    "NodeType": "All",
    "TradeType": 3,
    "ProductId": 30,
    "SceneName": "Hadoop-Default"
}

Output Example

{
    "Response": {
        "NodeSpecs": [
            {
                "CmnTypes": [],
                "NodeName": "Master Node",
                "NodeType": "Master",
                "Types": [
                    {
                        "InstanceFamilies": [
                            {
                                "FamilyName": "Standard S6",
                                "InstanceFamily": "S6",
                                "InstanceTypes": [],
                                "Order": 60
                            }
                        ]
                    }
                ]
            }
        ],
        "RequestId": "bb613114-cbe0-4fc1-8845-1d69e4f35e7a"
    }
}

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
AuthFailure CAM signature/authentication error.
FailedOperation Operation failed.
FailedOperation.GetCvmConfigQuotaFailed Failed to fetch the specifications of the CVM.
FailedOperation.NotAuthenticated Unauthorized operation.
FailedOperation.SpecDeleteDenyForAutoScaleStrategies Operation failed.
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.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.TKEError An error occurred while calling TKE.
InternalError.TradeCgwError An error occurred while calling another service API.
InvalidParameter Invalid parameter.
InvalidParameter.AppIdResourceNotMatch Parameter error.
InvalidParameter.CpuType Invalid CpuType parameter.
InvalidParameter.DisplayStrategyNotMatch Incorrect display policy.
InvalidParameter.InvalidPaymode Invalid billing mode.
InvalidParameter.InvalidVendorType Parameter error.
InvalidParameter.InvalidVolumeType Parameter error.
InvalidParameter.InvalidZone Invalid AZ.
InvalidParameter.LessCommonCount Parameter error.
InvalidParameter.LessTaskCount Parameter error.
InvalidParameter.MoreMaxlimitNum Number of CVM instances exceeds the maximum limit.
InvalidParameter.NotContainMustSelectSoftware Invalid parameter. Necessary components are missing.
InvalidParameter.PayModeResourceNotMatch The billing mode and resource do not match.
InvalidParameter.ProjectResourceNotMatch The project does not match the resource.
InvalidParameter.RepeatedStrategyName Repeated scaling rule name.
InvalidParameter.ResourceProviderType Invalid ResourceProviderType parameter.
InvalidParameter.RestartServiceUnsupported This service does not support restart.
InvalidParameter.SoftwareNotInProducr Invalid product component exists.
InvalidParameter.UngrantedPolicy The policy is not authorized.
InvalidParameter.UnsatisfiedSoftDependecy Parameter error.
InvalidParameterValue Incorrect parameter value.
InvalidParameterValue.InvalidTkeInstance The TKE cluster ID is invalid, or the TKE cluster is not eligible.
LimitExceeded The quota limit is exceeded.
MissingParameter Missing parameter.
MissingParameter.MissingCoreResource Error of misiParameter errors are missing.
OperationDenied Operation denied.
RequestLimitExceeded Number of requests exceeds the frequency limit.
ResourceNotFound.SpecNotFound The specifications do not exist.
ResourceUnavailable.NotSupportNodeType Resources are unavailable.
UnauthorizedOperation Unauthorized operation.
UnknownParameter Unknown parameter.
UnsupportedOperation Unsupported operation.
UnsupportedOperation.NotInWhiteList This function is included in the allowlist.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback