1. 接口描述
接口请求域名: tbdsnew.api3.fincloud.tencent.com。
云原生集群服务部署信息,以及组件的网络信息等
默认接口请求频率限制: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 | 无法找到该实例。 |