容器版TBDS集群服务部署信息
最近更新时间: 2026-09-17 00:05:50
1. 接口描述
接口请求域名： tbdsnew.api3.fincloud.tencent.cn。
云原生集群服务部署信息，以及组件的网络信息等
默认接口请求频率限制：20次/秒。
接口更新时间：2025-09-12 14:52:28。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：DescribeCloudInstanceService |
| Version | 是 | 否 | String | 公共参数，本接口取值：2019-01-03 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| InstanceId | 是 | 否 | String | emr集群ID 示例值： tbds-aqy2cvg6 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| TotalCnt | Int64 | 1 示例值： 1 |
| ServiceLayerIns | Array of ServiceLayerIn | {"1":[{"ClusterId":"emr-test","ServiceType":"1","ServiceLayer":"1","Status":"1","SoftName":"Spark","SoftVersion":"3.2.2"}],"InstanceId":"emr-test"} 注意：此字段可能返回 null，表示取不到有效值。 示例值：查看 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameter.InvalidMasterDiskType | 参数错误。 |
| InternalError.CbsCgwError | 内部服务调用异常。 |
| InternalError.CdbCgwError | 内部服务调用异常。 |
| InternalError.QcloudServiceException | Qcloud服务异常。 |
| InternalError.WoodJobSubmitError | 内部错误。 |
| InvalidParameter.InvalidNodeCount | 不合法的节点数量。 |
| InternalError.OpenTSDBWriteException | 写OpenTSDB异常。 |
| InvalidParameter.IncorrectCommonCount | Common节点数量无效。 |
| ResourcesSoldOut | 资源售罄。 |
| InvalidParameter.InvalidNodeFlag | 不合法的节点类型。 |
| InternalError.EMRCCException | EMRCC异常。 |
| InvalidParameter.InvalidExternalServiceVpcId | 无效组件依赖集群vpc。 |
| InternalError.ConfigCgwError | 内部服务调用异常。 |
| InvalidParameter.InvalidTKEPlatformType | 无效的PlatFormType容器类型参数。 |
| ResourceNotFound.FlowNotFound | 资源不存在。 |
| InternalError.WoodStackIdNotFound | 内部错误。 |
| UnsupportedOperation.UnsupportedDiskType | 操作不支持。 |
| InternalError.WoodDataBaseBeginTransactionError | 内部错误。 |
| InvalidParameter.InvalidTimeLayout | 参数错误。 |
| FailedOperation.CheckIfSupportPodStretch | 操作失败。 |
| InternalError.CamCgwError | 内部服务调用异常。 |
| InternalError.WoodOperationQueryError | 内部错误。 |
| InvalidParameter.ImpalaQueryException | impala查询参数异常。 |
| ResourceNotFound.TKEPreconditionNotFound | tke集群前置组件未部署。 |
| InternalError.DBException | DB异常。 |
| InternalError.EMRCCInvalidParam | 请求EMRCC参数非法。 |
| InternalError.ESException | ES异常。 |
| InternalError.WoodJobGetStageError | 内部错误。 |
| InternalError.WoodHostInfoNotFound | 内部错误。 |
| InvalidParameter.InvalidUinNum | 父帐号uin参数输入异常。 |
| InternalError.TradeCgwError | 内部服务调用异常。 |
| InternalError.WoodConfigFileIdNotFound | 内部错误。 |
| InternalError.DBQueryException | DB查询异常。 |
| FailedOperation.NotSupportPod | 操作失败，不支持pod。 |
| InternalError.WoodDataBaseCommitError | 内部错误。 |
| InternalError.WoodGetModuleError | 内部错误。 |
| InvalidParameter.InvalidInstanceChargeType | 不合法的实例计费模式。 |
| InvalidParameter.InvalidSecuritySupport | 该EMR版本不支持开启安全模式。 |
| InvalidParameter.InvalidProductVersion | 不合法的产品版本。 |
| InternalError.COSException | COS异常。 |
| InvalidParameter.InvalidTKEPlatFormType | 无效的PlatFormType容器类型参数。 |
| InvalidParameter.InvalidMetaDataJdbcUrl | 无效的元数据库URL。 |
| InvalidParameter.InvalidDiskType | 参数错误。 |
| InternalError.OpenTSDBQueryException | 查询OpenTSDB异常。 |
| InvalidParameter.InvalidCountNum | 同一请求只能扩容Task或者Core节点。 |
| InternalError.WoodJobNotAcceptByService | 内部错误。 |
| FailedOperation.GetCamServerFailed | 调用cam服务失败。 |
| LimitExceeded.SecurityGroupNumLimitExceeded | 安全组数量超过限制。 |
| InternalError.ClickHouseQueryException | 查询ClickHouse异常。 |
| InvalidParameter.HALessMasterCount | 参数错误。 |
| InvalidParameter.InvalidDependServiceAndEnableKerberosConflict | DependService和EnableKerberos参数冲突。 |
| UnsupportedOperation.UnauthenticatedUnsupport | 权限不足。 |
| ResourceUnavailable.NotSupportResourceType | 资源不可用。 |
| InvalidParameter.InvalidClickHouseCluster | 无效的ClickHouse集群。 |
| InvalidParameter.InvalidInstanceType | 无效的机型。 |
| InvalidParameter.InvalidRenewFlag | 不合法自动续费标识。 |
| InvalidParameter.RepeatedExecutionTime | 执行时间重复。 |
| InvalidParameter.InvalidUnNecessaryNodeList | 参数错误。 |
| FailedOperation.RefundCvmFailed | 操作失败。 |
| InternalError.ProjectCgwError | 内部服务调用异常。 |
| InternalError.WoodRedisError | 内部错误。 |
| InternalError.EKSError | 调用EKS报错。 |
| InternalError.WoodHostSizeNotEnough | 内部错误。 |
| InternalError.OpenTSDBInvalidParam | OpenTSDB参数非法。 |
| InternalError.WoodOperationDeleteError | 内部错误。 |
| InvalidParameter.KerberosSupport | 不合法的支持Kerberos标识。 |
| InvalidParameter.InvalidAllNodeResourceSpec | 不合法的AllNodeResourceSpec参数。 |
| InvalidParameter.InvalidOrderKey | 错误信息：Invalid OrderKey。 |
| InternalError.HBaseException | HBase异常。 |
| InternalError.WoodConfHistoryFileCountError | 内部错误。 |
| InvalidParameter.MoreMaxlimitNum | 超过cvm实例最大限制个数。 |
| UnsupportedOperation.ServiceNotSupport | 该服务不支持此操作。 |
| InvalidParameter.IncorrectMasterCount | Master节点数量无效。 |
| InvalidParameter.InvalidCustomizedPodParam | 错误信息：Invalid PodParameter。 |
| FailedOperation.GetCamRoleFailed | 获取cam角色失败。 |
| InternalError.WoodCannotDelDefaultConfGroup | 内部错误。 |
| InvalidParameter.InvalidTkeInstance | 无效的Tke集群ID，或Tke集群不符合条件。 |
| InvalidParameter.InvalidCount | 扩容数量必须大于0。 |
| FailedOperation.GetCvmConfigQuotaFailed | 获取cvm 规格信息失败。 |
| InternalError.OpenTSDBHttpReturnCodeNotOK | 请求OpenTSDB失败。 |
| InternalError.WoodServerError | 内部服务调用异常。 |
| InvalidParameter.InvalidOrderType | 错误信息：Invalid OrderType。 |
| UnauthorizedOperation.CheckCamAuth | 校验账号操作无权限。 |
| InternalError.WoodDataBaseError | 内部错误。 |
| InternalError.WoodRestartNodeNotFound | 内部错误。 |
| InvalidParameter.InvalidScriptBootstrapActionConfig | 不合法的引导脚本执行参数。 |
| FailedOperation.GetCvmServerFailed | 调用cvm服务失败。 |
| InvalidParameter.InvalidCommonDiskType | 参数错误。 |
| ResourceNotFound.KeyTabFileNotReady | KeyTab文件上传中，请稍等片刻。 |
| InternalError.DoOpenTSDBRequestException | 请求OpenTSDB异常。 |
| InternalError.WoodClusterServiceNotFound | 内部错误。 |
| InternalError.WoodJobGetTaskError | 内部错误。 |
| InternalError.WoodRecordDuplicated | 内部错误。 |
| ResourceUnavailable.ResourceSpecNotDefaultSpec | 当前资源规格不存在默认规格。 |
| FailedOperation.GetEksServerFailed | 获取eks服务失败。 |
| FailedOperation.GetTkeServerFailed | 获取Tke 服务失败。 |
| InternalError.AccountCgwError | 内部服务调用异常。 |
| InternalError.WoodInvalidParam | 内部错误。 |
| InternalError.WoodSystemUnknownError | 内部错误。 |
| InternalError.DBWriteException | 写DB异常。 |
| InternalError.VpcCgwError | 内部服务调用异常。 |
| ResourceNotFound.InstanceNotFound | 无法找到该实例。 |
5. 示例
示例1 容器版emr集群服务部署信息
输入示例
POST / HTTP/1.1
Host: tbdsnew.api3.{conf.main_domain}
Content-Type: application/json
X-TC-Action: DescribeCloudInstanceService
<公共请求参数>
{
"InstanceId": "tbds-aqy2cvg6"
}
输出示例
{
"Response": {
"RequestId": "8bdc87d0-39f1-4a75-826e-209e88b7f618",
"ServiceLayerIns": [
{
"CloudServices": [
{
"AddTime": "2025-05-15 14:24:46",
"ClusterId": 14250,
"DependentClusterId": "",
"DependentClusterIsEmrContainerCluster": 0,
"DisPlay": true,
"ErrorNums": 0,
"ExternalService": [
"Gateway:10.4.2.83:40012"
],
"ExternalServiceIpv4": [
"Gateway:10.4.2.83:40012"
],
"InternalService": [
"Gateway:tbds-aqy2cvg6-knox-gateway-inner:30002"
],
"IsExternal": 0,
"PathsInfo": "/usr/local/service/knox",
"RunningNums": 1,
"ServiceLayer": "accessLayer",
"ServiceType": 24,
"Soft": "KNOX-1.6.1",
"SoftName": "KNOX",
"Status": 0,
"UserGroup": "hadoop",
"UserName": "hadoop"
}
],
"ServiceLayer": "accessLayer"
},
{
"CloudServices": [
{
"AddTime": "2025-05-15 14:24:46",
"ClusterId": 14250,
"DependentClusterId": "",
"DependentClusterIsEmrContainerCluster": 0,
"DisPlay": true,
"ErrorNums": 0,
"ExternalService": [
"Slapd:10.4.2.83:40000,10.4.2.83:40001"
],
"ExternalServiceIpv4": [
"Slapd:10.4.2.83:40000,10.4.2.83:40001"
],
"InternalService": [
"Slapd:tbds-aqy2cvg6-openldap-slapd-inner:389"
],
"IsExternal": 0,
"PathsInfo": "/usr/local/service/openldap",
"RunningNums": 2,
"ServiceLayer": "middleLayer",
"ServiceType": 39,
"Soft": "OPENLDAP-2.4.44",
"SoftName": "OPENLDAP",
"Status": 0,
"UserGroup": "root",
"UserName": "root"
},
{
"AddTime": "2025-05-15 14:24:46",
"ClusterId": 14250,
"DependentClusterId": "",
"DependentClusterIsEmrContainerCluster": 0,
"DisPlay": true,
"ErrorNums": 0,
"ExternalService": [
"KadminServer:10.4.2.83:40002",
"KdcServer:10.4.2.83:40003,10.4.2.83:40004"
],
"ExternalServiceIpv4": [
"KadminServer:10.4.2.83:40002",
"KdcServer:10.4.2.83:40003,10.4.2.83:40004"
],
"InternalService": [
"KadminServer:tbds-aqy2cvg6-krb5-kadmin-inner:8849",
"KdcServer:tbds-aqy2cvg6-krb5-krb5kdc-inner:8888,tbds-aqy2cvg6-krb5-krb5kdc-inner:13349"
],
"IsExternal": 0,
"PathsInfo": "/usr/local/service/KRB5",
"RunningNums": 4,
"ServiceLayer": "middleLayer",
"ServiceType": 21,
"Soft": "KRB5-1.21.2",
"SoftName": "KRB5",
"Status": 0,
"UserGroup": "root",
"UserName": "root"
},
{
"AddTime": "2025-05-15 14:24:46",
"ClusterId": 14250,
"DependentClusterId": "",
"DependentClusterIsEmrContainerCluster": 0,
"DisPlay": true,
"ErrorNums": 0,
"ExternalService": [
"RangerAdmin:10.4.2.83:40007",
"RangerKms:10.4.2.83:40009",
"RangerUsersync:10.4.2.83:40010"
],
"ExternalServiceIpv4": [
"RangerAdmin:10.4.2.83:40007",
"RangerKms:10.4.2.83:40009",
"RangerUsersync:10.4.2.83:40010"
],
"InternalService": [
"RangerAdmin:tbds-aqy2cvg6-ranger-ranger-inner:6080",
"RangerKms:tbds-aqy2cvg6-ranger-rangerkms-inner:9292",
"RangerUsersync:tbds-aqy2cvg6-ranger-rangerusersync-inner:11920"
],
"IsExternal": 0,
"PathsInfo": "/usr/local/service/ranger",
"RunningNums": 6,
"ServiceLayer": "middleLayer",
"ServiceType": 16,
"Soft": "RANGER-2.3.0",
"SoftName": "RANGER",
"Status": 0,
"UserGroup": "hadoop",
"UserName": "hadoop"
},
{
"AddTime": "2025-05-15 14:24:46",
"ClusterId": 14250,
"DependentClusterId": "",
"DependentClusterIsEmrContainerCluster": 0,
"DisPlay": true,
"ErrorNums": 0,
"ExternalService": [
"Zookeeper:10.4.2.83:40005,10.4.2.83:40006,10.4.2.83:40008"
],
"ExternalServiceIpv4": [
"Zookeeper:10.4.2.83:40005,10.4.2.83:40006,10.4.2.83:40008"
],
"InternalService": [
"Zookeeper:tbds-aqy2cvg6-zookeeper-quorumpeermain-inner:2181"
],
"IsExternal": 0,
"PathsInfo": "/usr/local/service/zookeeper",
"RunningNums": 3,
"ServiceLayer": "middleLayer",
"ServiceType": 0,
"Soft": "ZOOKEEPER-3.7.2",
"SoftName": "ZOOKEEPER",
"Status": 0,
"UserGroup": "root",
"UserName": "root"
},
{
"AddTime": "2025-05-15 14:24:46",
"ClusterId": 14250,
"DependentClusterId": "",
"DependentClusterIsEmrContainerCluster": 0,
"DisPlay": true,
"ErrorNums": 0,
"ExternalService": [
"MetaServiceServer:10.4.2.83:40011,10.4.2.83:40013"
],
"ExternalServiceIpv4": [
"MetaServiceServer:10.4.2.83:40011,10.4.2.83:40013"
],
"InternalService": [
"MetaServiceServer:tbds-aqy2cvg6-metaservice-metaserviceserver-inner:8898,tbds-aqy2cvg6-metaservice-metaserviceserver-inner:9002"
],
"IsExternal": 0,
"PathsInfo": "/usr/local/service/metaservice",
"RunningNums": 2,
"ServiceLayer": "middleLayer",
"ServiceType": 49,
"Soft": "METASERVICE-0.7.0",
"SoftName": "METASERVICE",
"Status": 0,
"UserGroup": "metaservice",
"UserName": "metaservice"
}
],
"ServiceLayer": "middleLayer"
}
],
"TotalCnt": 6
}
}