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.
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 | AZ ID. For more information, see https://document.capi.woa.com/document/api/1605/76892. |
| CvmPayMode | Yes | Integer | 0: pay-as-you-go; 1: yearly/monthly subscription; 99: pay-as-you-go and yearly/monthly subscription. Incorrect values will not display billing information. |
| NodeType | Yes | String | Node type. Valid values: Master, Core, Task, Router, and All. |
| TradeType | Yes | Integer | 0: old billing page; 1: new billing page. If incorrectly filled, the old billing page is used by default. |
| ProductId | Yes | Integer | Product ID. If not specified, the value is 0, indicating all product IDs. This parameter is required on the frontend. 44 EMR V3.5.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. |
| Parameter Name | Type | Description |
|---|---|---|
| NodeSpecs | Array of DescribeNodeSpec | Node specifications type. |
| Architectures | Array of ArchitectureInfo | Instance type architecture information. |
| 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. |
POST / HTTP/1.1
Host: emr.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeNodeSpec
<Common request parameters>
{
"ZoneId": 100003,
"CvmPayMode": 0,
"NodeType": "Core",
"TradeType": 1,
"ProductId": 20,
"SceneName": "Hadoop-Default",
"ResourceBaseType": "ComputeResource"
}{
"Response": {
"Architectures": [
{
"Architecture": "X86 Computing",
"ArchitectureName": "x86 computing",
"InstanceFamilies": [
"S2"
],
"Order": 1
}
],
"NodeSpecs": [
{
"CmnTypes": [],
"NodeName": "Core node",
"NodeType": "Core",
"Types": [
{
"InstanceFamilies": [
{
"FamilyName": "Standard S2",
"InstanceFamily": "S2",
"InstanceTypes": [
{
"Cpu": 4,
"CpuType": "Intel Xeon E5-2680 v4",
"DataDisk": [
{
"Count": 1,
"DefaultDiskSize": 100,
"DiskType": "CLOUD_BSSD",
"IsSpecialDisk": false,
"Name": "Balanced SSD"
}
],
"FamilyName": "",
"GpuDesc": "",
"GpuNum": 0,
"GpuResourceKey": "",
"InstanceFamily": "",
"InstanceType": "S2.LARGE8",
"IsGpuInstance": true,
"LocalDataDisk": [],
"Memory": 8,
"NeedHpcClusterId": false,
"NodeName": "Core node",
"NodeType": "Core",
"Num": 580,
"Order": 0,
"OriginPrice": 1.44,
"PrepaidUnderwritePeriods": null,
"QuotaNum": 899992,
"QuotaUnit": "VCPU",
"Remark": "Enough",
"SellOutReason": "",
"SoldOutReason": "",
"SystemDisk": [
{
"Count": 1,
"DefaultDiskSize": 70,
"DiskType": "CLOUD_BSSD",
"IsSpecialDisk": false,
"Name": "Balanced SSD"
}
],
"Type": "",
"TypeName": ""
}
],
"Order": 14
}
],
"Order": 1,
"Type": "S",
"TypeName": "Standard"
}
]
}
],
"RequestId": "18d59c7d-39de-4fbb-b6c0-2a5d18c09d5e"
}
}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 |
|---|---|
| AuthFailure | CAM signature/authentication error. |
| FailedOperation | Operation failed. |
| FailedOperation.GetCvmConfigQuotaFailed | Failed to obtain the CVM specifications information. |
| FailedOperation.NotAuthenticated | Unauthorized operation. |
| FailedOperation.SpecDeleteDenyForAutoScaleStrategies | Operation failed. |
| InternalError | Internal error. |
| 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.CvmError | Internal service call exception. |
| InternalError.KmsError | Internal service call exception. |
| InternalError.ProjectCgwError | Internal service call exception. |
| InternalError.TKEError | TKE call error. |
| InternalError.TradeCgwError | Internal service call exception. |
| InvalidParameter | Parameter error. |
| InvalidParameter.AppIdResourceNotMatch | Parameter error. |
| InvalidParameter.CpuType | Invalid CpuType parameter. |
| InvalidParameter.DisplayStrategyNotMatch | Display policy error. |
| InvalidParameter.InvalidPaymode | Invalid payment type. |
| InvalidParameter.InvalidVendorType | Parameter error. |
| InvalidParameter.InvalidVolumeType | Parameter error. |
| InvalidParameter.InvalidZone | Invalid AZ. |
| InvalidParameter.LessCommonCount | Parameter error. |
| InvalidParameter.LessTaskCount | Parameter error. |
| InvalidParameter.MoreMaxlimitNum | The number of CVM instances exceeds the maximum limit. |
| InvalidParameter.NotContainMustSelectSoftware | Invalid parameter. It does not contain required components. |
| InvalidParameter.PayModeResourceNotMatch | The payment mode does not match resources. |
| InvalidParameter.ProjectResourceNotMatch | The project does not match resources. |
| InvalidParameter.RepeatedStrategyName | Duplicate scaling rule name. |
| InvalidParameter.ResourceProviderType | Invalid ResourceProviderType parameter. |
| InvalidParameter.RestartServiceUnsupported | This service does not support restart. |
| InvalidParameter.SoftwareNotInProducr | Invalid product components exist. |
| InvalidParameter.UngrantedPolicy | The policy is authorization. |
| InvalidParameter.UnsatisfiedSoftDependecy | Parameter error. |
| InvalidParameterValue | Parameter value error. |
| InvalidParameterValue.InvalidTkeInstance | Invalid TKE cluster ID, or the TKE cluster does not meet the criteria. |
| LimitExceeded | The quota limit is exceeded. |
| MissingParameter | Missing parameter error. |
| MissingParameter.MissingCoreResource | Missing parameter error. |
| OperationDenied | Operation denied. |
| RequestLimitExceeded | The 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 error. |
| UnsupportedOperation | The operation is not supported. |
| UnsupportedOperation.NotInWhiteList | This feature is supported by the allowlist. |
文档反馈