AccessInfo
引擎的访问信息
被如下接口引用:DescribeDataEngine, DescribeDataEngines。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AccessType | String | 否 | 访问引擎的方法 注意:此字段可能返回 null,表示取不到有效值。 示例值:DLCJDBC |
| AccessConnectionInfos | Array of String | 否 | 访问引擎的url,内部的部分参数需要根据实际情况替换 注意:此字段可能返回 null,表示取不到有效值。 示例值:jdbc:dlc:xxxx-xxxx |
AnalysisTaskResults
洞察分析结果返回体
被如下接口引用:DescribeTasksAnalysis。
| 名称 | 类型 | 描述 |
|---|---|---|
| Id | String | 任务Id 示例值:89570c65-49de-4bbd-ac0a-a67c724fc80f |
| InstanceStartTime | Integer | 任务创建时间,毫秒时间戳 示例值:1715141119301 |
| InstanceCompleteTime | Integer | 任务结束时间,毫秒时间戳 示例值:1715141437247 |
| State | Integer | 任务状态:0 初始化, 1 执行中, 2 执行成功,3 数据写入中,4 排队中。-1 执行失败,-3 已取消。 示例值:2 |
| SQL | String | 任务SQL语句 示例值:INSERT INTO person_table values(100, 'John', 30, 1, 'Street 1') |
| DataEngineName | String | 计算资源名字 示例值:标准SPARK |
| JobTimeSum | Integer | 单位毫秒,引擎内执行耗时, 反映真正用于计算所需的耗时,即从 Spark 任务第一个 Task 开始执行到任务结束之间的耗时。 示例值:80852 |
| TaskTimeSum | Integer | 单位秒,累计 CPU* 秒 ( 累计 CPU * 时 = 累计 CPU* 秒/ 3600),统计参与计算所用 Spark Executor 每个 core 的 CPU 执行时长总和 示例值:4329 |
| InputRecordsSum | Integer | 数据扫描总行数 示例值:0 |
| InputBytesSum | Integer | 数据扫描总 bytes 示例值:99330 |
| OutputRecordsSum | Integer | 输出总行数 示例值:0 |
| OutputBytesSum | Integer | 输出总 bytes 示例值:0 |
| ShuffleReadBytesSum | Integer | shuffle read 总 bytes 示例值:9807 |
| ShuffleReadRecordsSum | Integer | shuffle read 总行数 示例值:28 |
| AnalysisStatus | String | 洞察结果类型分类,一个 json 数组,有如下几种类型:SPARK-StageScheduleDelay(资源抢占), SPARK-ShuffleFailure(Shuffle异常), SPARK-SlowTask(慢task), SPARK-DataSkew(数据倾斜), SPARK-InsufficientResource(磁盘或内存不足) 示例值:["SPARK-StageScheduleDelay"] |
| OutputFilesNum | Integer | 任务输出文件总数 示例值:0 |
| OutputSmallFilesNum | Integer | 任务输出小文件总数 示例值:0 |
| ShuffleWriteBytesSum | Integer | shuffle write 总 Bytes 大小 单位:Bytes 默认值:无 示例值:9807 |
ApiKeyInfo
API Key 响应
被如下接口引用:ListApiKeys, ListAvailableApiKeys, ListServiceApiKeys。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ApiKeyId | String | 否 | apiKey的Id 示例值:apikey-20260615150836-trum |
| Name | String | 否 | apiKey名称 示例值:xgboost-self-scale-test-key-20260615150836-ocbz |
| ApiKey | String | 否 | apiKey 示例值:sk-proj-Q4nRCLNS61ab3zoYyfVTX9bdotCV27SSdQMHe6dCz0yo5Zaf |
| ServiceId | String | 否 | 推理服务Id 示例值:svc-20260615150835-n7pq |
| ServiceName | String | 否 | 推理服务名称 示例值:xgboost-self-scale-test |
| Status | String | 否 | 状态 枚举值:
示例值:Active |
| AppId | Integer | 否 | appid 示例值:260200066 |
| Uin | String | 否 | 主账号uin 示例值:700002655694 |
| CreateTime | Integer | 否 | 创建时间 示例值:1781507316105 |
| UpdateTime | Integer | 否 | 更新时间 示例值:1781507316105 |
| SubAccountUin | String | 否 | 子账号uin 示例值:700002655694 |
ApiKeyResponseInfo
API Key 响应类.
被如下接口引用:BindApiKey。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ApiKeyId | String | 否 | apiKey的id 示例值:apikey-20260615204858-736d |
| Name | String | 否 | apikey名称 示例值:chenfan_test |
| ApiKey | String | 否 | apikey内容 示例值:sk-proj-ZazLg0SL0ubeu3VJGtJkiYqI5jj6wMOHbbltNpIHUq0smw0s |
| ServiceId | String | 否 | 推理服务id 示例值:svc-20260610145259-6s6v |
| ServiceName | String | 否 | 推理服务名称 示例值:m-qwen3-5-4b-6a223aba-951c-svczwc |
| Status | String | 否 | apikey状态 枚举值:
示例值:Active |
| AppId | Integer | 否 | appid 示例值:260200066 |
| Uin | String | 否 | 主账号uin 示例值:700002655694 |
| SubAccountUin | String | 否 | 子账号uin 示例值:700002655694 |
| CreateTime | Integer | 否 | 创建时间 示例值:1781527738362 |
| UpdateTime | Integer | 否 | 更新时间 示例值:1781527776086 |
Asset
元数据基本对象
被如下接口引用:AlterDMSDatabase, AlterDMSTable, CreateDMSDatabase, CreateDMSTable, DescribeDMSDatabase, DescribeDMSTable, DescribeDMSTables。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | Integer | 否 | 主键 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| Name | String | 否 | 名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:name |
| Guid | String | 否 | 对象GUID值 注意:此字段可能返回 null,表示取不到有效值。 示例值:xxxx-xxxx-xxx-xxx |
| Catalog | String | 否 | 数据目录 注意:此字段可能返回 null,表示取不到有效值。 示例值:DataLakeCatalog |
| Description | String | 否 | 描述信息 示例值:desc |
| Owner | String | 否 | 对象owner 示例值:root |
| OwnerAccount | String | 否 | 对象owner账户 示例值:root |
| PermValues | Array of KVPair | 否 | 权限 |
| Params | Array of KVPair | 否 | 附加属性 |
| BizParams | Array of KVPair | 否 | 附加业务属性 |
| DataVersion | Integer | 否 | 数据版本 示例值:1 |
| CreateTime | Timestamp ISO8601 | 否 | 创建时间 示例值:2021-01-01 12:12:12 |
| ModifiedTime | Timestamp ISO8601 | 否 | 修改时间 示例值:2021-01-01 12:12:12 |
| DatasourceId | Integer | 否 | 数据源主键 示例值:1 |
BatchSQLCostInfo
spark session batch SQL的消耗信息
被如下接口引用:DescribeSparkSessionBatchSQLCost。
| 名称 | 类型 | 描述 |
|---|---|---|
| BatchId | String | 任务id 示例值:8925a6ba-0b33-4499-8b41-1f5a213689f0 |
| DataEngineName | String | 引擎名称 示例值:testengine |
| DataEngineId | String | 引擎id 示例值:DataEngine-xxx |
| Cost | Float | 本次消耗,单位cu 示例值:1.231412 |
| TimeCost | Integer | 时间开销,秒 示例值:12 |
| Operator | String | 操作者 示例值:1238741213 |
BatchSqlTask
SparkSQL批任务信息
被如下接口引用:DescribeSparkSessionBatchSQL。
| 名称 | 类型 | 描述 |
|---|---|---|
| TaskId | String | SQL子任务唯一标识 示例值:3a0e3e8b-3cb0-46cd-b126-1ab9837acfc6 |
| ExecuteSQL | String | 运行SQL 示例值:select 1; |
| Message | String | 任务信息,成功则返回:Task Success!,失败则返回异常信息 示例值:Task Success! |
BenchmarkResourceInfo
评测容器自身资源规格
被如下接口引用:CreateBenchmarkTask, RerunBenchmarkTask, StopBenchmarkTask。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ResourcePartitionId | String | 否 | 评测容器所在资源包 ID 示例值:dlc-p-akgkmdml |
| Queue | String | 否 | 评测容器所在资源组 示例值:default |
| BillingItem | String | 否 | 评测容器计费项(规格) 示例值:sv_dlc_standard_cu_standard_cu |
| Spec | Integer | 否 | 规格数量 示例值:1 |
BenchmarkSummaryInfo
模型评测汇总信息(排行榜数据项)
被如下接口引用:ListBenchmarkSummary。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ModelName | String | 否 | 模型名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:qwen2.5 |
| Provider | String | 否 | 模型提供方 注意:此字段可能返回 null,表示取不到有效值。 示例值:personal |
| ModelType | String | 否 | 模型类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:LLM |
| ParameterSize | String | 否 | 参数量 注意:此字段可能返回 null,表示取不到有效值。 示例值:0.51B |
| ServiceName | String | 否 | 评测所用的服务名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:svc-cjl-3 |
| TaskName | String | 否 | 评测任务名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:benchmark-svc-cjl-3-1781247433435 |
| BenchmarkCount | Integer | 否 | 该模型的评测任务总数 注意:此字段可能返回 null,表示取不到有效值。 示例值:4 |
| InputTokens | Integer | 否 | 输入 Token 数 注意:此字段可能返回 null,表示取不到有效值。 示例值:256 |
| OutputTokens | Integer | 否 | 输出 Token 数 注意:此字段可能返回 null,表示取不到有效值。 示例值:1024 |
| RequestsPerSecond | Float | 否 | 每秒请求数 (QPS) 注意:此字段可能返回 null,表示取不到有效值。 示例值:5 |
| MaxConcurrency | Integer | 否 | 最大并发数 注意:此字段可能返回 null,表示取不到有效值。 示例值:16 |
| TimeToFirstTokenAvg | Float | 否 | TTFT 平均值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:224.15 |
| TimeToFirstTokenMedian | Float | 否 | TTFT 中间值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:213.43 |
| TimeToFirstTokenP99 | Float | 否 | TTFT P99 值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:265.76 |
| TimePerOutputTokenAvg | Float | 否 | TPOT 平均值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:42.97 |
| TimePerOutputTokenMedian | Float | 否 | TPOT 中间值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:43.57 |
| TimePerOutputTokenP99 | Float | 否 | TPOT P99 值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:43.78 |
| InterTokenLatencyAvg | Float | 否 | ITL 平均值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:42.3 |
| InterTokenLatencyMedian | Float | 否 | ITL 中间值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:50.08 |
| InterTokenLatencyP99 | Float | 否 | ITL P99 值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:131.56 |
| EndToEndAvg | Float | 否 | E2E 平均值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:2931.09 |
| EndToEndMedian | Float | 否 | E2E 中间值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:2969.11 |
| EndToEndP99 | Float | 否 | E2E P99 值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:3011.42 |
| CreateTime | Integer | 否 | 评测完成时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1781247433444 |
BenchmarkTaskInfo
性能评测任务信息
被如下接口引用:ListBenchmarkTasks。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| TaskId | String | 否 | benchmark任务id 注意:此字段可能返回 null,表示取不到有效值。 示例值:bench-20260609151655-awqe |
| TaskName | String | 否 | 任务名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:benchmark-svc-cjl-1-1780989415291 |
| ServiceId | String | 否 | 关联的推理服务ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:svc-20260608113612-te93 |
| ServiceName | String | 否 | 关联的推理服务名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:svc-cjl-1 |
| Status | String | 否 | 任务状态(Running/Completed/Failed/Pending/Stopped) 注意:此字段可能返回 null,表示取不到有效值。 示例值:Completed |
| InputTokens | Integer | 否 | 输入 Token 数 注意:此字段可能返回 null,表示取不到有效值。 示例值:128 |
| OutputTokens | Integer | 否 | 输出 Token 数 注意:此字段可能返回 null,表示取不到有效值。 示例值:64 |
| RequestsPerSecond | Float | 否 | 每秒请求数 (QPS) 注意:此字段可能返回 null,表示取不到有效值。 示例值:2 |
| MaxConcurrency | Integer | 否 | 最大并发数 注意:此字段可能返回 null,表示取不到有效值。 示例值:2 |
| TotalPrompts | Integer | 否 | Prompts 总数 注意:此字段可能返回 null,表示取不到有效值。 示例值:5 |
| UseGateway | Boolean | 否 | 是否经 Ingress 网关(true=网关, false=集群内直连 SVC) 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| DeploymentName | String | 否 | 直连模式下使用的部署名称(仅 UseGateway=false 时有值) 注意:此字段可能返回 null,表示取不到有效值。 示例值:svc-cjl-1-deploy-v2 |
| ApiKeyId | String | 否 | API Key ID(走网关时使用的 API Key 标识) 示例值:apikey-20260616110430-f7i1 |
| ApiKeyName | String | 否 | API Key 名称 示例值:m-qwen2-tangbo-test-key-20260616110430-dznt |
| TimeToFirstTokenAvg | Float | 否 | TTFT 平均值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:224.15 |
| TimeToFirstTokenMedian | Float | 否 | TTFT 中间值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:213.43 |
| TimeToFirstTokenP99 | Float | 否 | TTFT P99 值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:265.76 |
| TimePerOutputTokenAvg | Float | 否 | TPOT 平均值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:42.97 |
| TimePerOutputTokenMedian | Float | 否 | TPOT 中间值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:43.57 |
| TimePerOutputTokenP99 | Float | 否 | TPOT P99 值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:43.78 |
| InterTokenLatencyAvg | Float | 否 | ITL 平均值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:42.3 |
| InterTokenLatencyMedian | Float | 否 | ITL 中间值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:50.08 |
| InterTokenLatencyP99 | Float | 否 | ITL P99 值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:131.56 |
| EndToEndAvg | Float | 否 | E2E 平均值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:2931.09 |
| EndToEndMedian | Float | 否 | E2E 中间值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:2969.11 |
| EndToEndP99 | Float | 否 | E2E P99 值(ms) 注意:此字段可能返回 null,表示取不到有效值。 示例值:3011.42 |
| TokenThroughput | Float | 否 | Token 吞吐量 (output tokens/s) 注意:此字段可能返回 null,表示取不到有效值。 示例值:34.79 |
| RequestThroughput | Float | 否 | 请求吞吐量 (requests/s) 注意:此字段可能返回 null,表示取不到有效值。 示例值:0.54 |
| ErrorMessage | String | 否 | 错误信息(失败时) 注意:此字段可能返回 null,表示取不到有效值。 示例值:Benchmark job failed. Check logs for details. |
| AppId | Integer | 否 | appid 注意:此字段可能返回 null,表示取不到有效值。 示例值:260200066 |
| CreateTime | Integer | 否 | 创建时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1780989415296 |
| UpdateTime | Integer | 否 | 更新时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1780989475107 |
| Uin | String | 否 | 主账号uin 示例值:700002655694 |
| SubAccountUin | String | 否 | 子账号uin 示例值:700002655694 |
CHDFSProductVpcInfo
chdfs产品vpc信息
被如下接口引用:DescribeOtherCHDFSBindingList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| VpcId | String | 否 | vpc id 示例值:vpc-6z****3s |
| VpcName | String | 否 | vpc名称 示例值:Name |
| VpcCidrBlock | Array of VpcCidrBlock | 否 | vpc子网信息列表 |
| RuleId | Integer | 否 | 规则Id 示例值:1560 |
| AccessGroupId | String | 否 | 权限组Id 示例值:ag-groupId |
CSV
CSV类型数据格式
被如下接口引用:CreateTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| CodeCompress | String | 否 | 压缩格式,["Snappy", "Gzip", "None"选一]。 示例值:Snappy |
| CSVSerde | CSVSerde | 否 | CSV序列化及反序列化数据结构。 |
| HeadLines | Integer | 否 | 标题行,默认为0。 示例值:1 |
| Format | String | 否 | 格式,默认值为CSV 示例值:CSV |
CSVSerde
CSV序列化及反序列化数据结构
被如下接口引用:CreateTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Escape | String | 否 | CSV序列化转义符,默认为"\",最长8个字符,如 Escape: "/" 示例值:\ |
| Quote | String | 否 | CSV序列化字段域符,默认为"'",最长8个字符, 如 Quote: """ 示例值:" |
| Separator | String | 否 | CSV序列化分隔符,默认为"\t",最长8个字符, 如 Separator: "\t" 示例值:, |
CheckpointConfig
用于返回训练作业的checkpoint的配置信息
被如下接口引用:CancelTrainingJobInstance, CreateTrainingJobInstance, DescribeTrainingJobInstance, DescribeTrainingJobSpec, ListMlflowServerTrainingInstances, ListTrainingJobInstance, ListTrainingJobSpec, ModifyTrainingJobSpec, ResumeTrainingJobInstance, SubmitTrainingJob。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Catalog | String | 否 | Checkpoint 产出存储的 Catalog 配置 JSON(结构同顶层 Catalog) 示例值:{"COSVolumes":[{"Region":"ap-guangzhou","Bucket":"my-ckpt-1300000000","VolumeSubPath":"/checkpoints"}]} |
| SaveStrategy | String | 否 | 保存策略:steps / epoch / none,默认 steps;GRPO 仅支持 steps / none 示例值:epoch |
| SaveFreq | Integer | 否 | 保存频率(每 N 步或每 N epoch),默认 500 示例值:1 |
| MaxKeep | Integer | 否 | 最大保留数量,0 表示不限制,默认 3 示例值:0 |
| OutputDir | String | 否 | 容器内输出目录回退值(可选;正常场景由 Checkpoint 挂载路径决定,仅在挂载路径为空时生效,默认 /workspace/output/{mode}) 示例值:/abc |
CheckpointMetrics
Checkpoint 训练指标(仅 checkpoint 目录且 snapshot 存在时有值)
被如下接口引用:DescribeTrainingCheckpoints。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Epoch | Float | 否 | 当前 checkpoint 对应的 epoch 示例值:3990 |
| Step | Integer | 否 | 全局训练步数 示例值:19950 |
| Loss | Float | 否 | 训练 loss(归一化后) 示例值:0.00000000000000000000 |
| EvalLoss | Float | 否 | 评估 loss(归一化后) 示例值:12.55574911246028 |
| LearningRate | Float | 否 | 学习率 示例值:0.0000000000000000000 |
| RawMetrics | Array of MetricItem | 否 | snapshot 中的原始 metrics 键值对列表(前端可展开查看) |
CheckpointMountInfo
Checkpoint 挂载摘要
被如下接口引用:CancelTrainingJobInstance, CreateTrainingJobInstance, DescribeTrainingJobInstance, DescribeTrainingJobSpec, ListMlflowServerTrainingInstances, ListTrainingJobInstance, ListTrainingJobSpec, ModifyTrainingJobSpec, ResumeTrainingJobInstance, SubmitTrainingJob。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| StorageType | String | 否 | 存储类型:COS / CFS / CFS_TURBO / GOOSEFS 示例值:COS |
| MountPath | String | 否 | 容器内挂载路径 示例值:/ |
| VolumeSubPath | String | 否 | COS key 前缀 或 CFS/GooseFS 子路径 示例值:/checkpoints456 |
| Bucket | String | 否 | 实际访问的 COS bucket 示例值:my-ckpt-1300000000 |
| Region | String | 否 | COS region 示例值:ap-nanjing |
| PlatformManaged | Boolean | 否 | 是否平台托管桶(影响凭证选择) 示例值:true |
| SnapshotKey | String | 否 | 快照在平台 COS 桶中的 key(仅 CFS/GooseFS 有值) 示例值:shared-mount-snapshots/rayjob-20260721163534-l84h/shared/latest.json |
ClsTopicItem
CLS 日志主题条目
被如下接口引用:DescribeClsTopics。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| TopicId | String | 否 | 日志主题 ID 示例值:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| TopicName | String | 否 | 日志主题名称 示例值:ray-nexus |
ClusterGroup
集群组响应
被如下接口引用:ListClusterGroups。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | String | 否 | 集群组 ID(系统生成) 注意:此字段可能返回 null,表示取不到有效值。 示例值:rayclustergroup-h5l7xk-cw8w |
| Name | String | 否 | 集群组名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:生产环境集群组 |
| Description | String | 否 | 集群组描述 注意:此字段可能返回 null,表示取不到有效值。 示例值:用于生产环境的集群组 |
| Config | String | 否 | 配置 注意:此字段可能返回 null,表示取不到有效值。 示例值:config-content |
| AppId | Integer | 否 | 应用 ID(多租户) 注意:此字段可能返回 null,表示取不到有效值。 示例值:260090589 |
| Uin | String | 否 | 创建者主账号 UIN 注意:此字段可能返回 null,表示取不到有效值。 示例值:700002467852 |
| SubAccountUin | String | 否 | 创建者子账号 UIN 注意:此字段可能返回 null,表示取不到有效值。 示例值:700002467852 |
| CreateTime | Integer | 否 | 创建时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:1774256065032 |
| UpdateTime | Integer | 否 | 更新时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:1774256065032 |
| Deleted | Boolean | 否 | 是否已软删除 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
| DeleteTime | Integer | 否 | 删除时间(软删时写入,活跃记录为 null) 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
ClusterPod
集群pod详情
被如下接口引用:GetLabPods, GetRayClusterPods。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| PodName | String | 否 | Pod名称 示例值:raycluster-20260527110617-96zt-head-6xn6r |
| PodIp | String | 否 | Pod IP 示例值:30.0.1.153 |
| Status | String | 否 | Pod状态 示例值:Running |
| Phase | String | 否 | Pod阶段 示例值:Pending |
| NodeName | String | 否 | 所属节点 示例值:30.0.0.31 |
| NodeIp | String | 否 | 节点IP 示例值:30.0.0.31 |
| Namespace | String | 否 | 命名空间 示例值:dlc-p-bleurqnv |
| CpuRequest | String | 否 | CPU请求 示例值:800m |
| CpuLimit | String | 否 | CPU限制 示例值:2 |
| MemoryRequest | String | 否 | 内存请求 示例值:1.6Gi |
| MemoryLimit | String | 否 | 内存限制 示例值:4Gi |
| GpuCount | String | 否 | GPU数量 示例值:0 |
| Image | String | 否 | 容器镜像 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:2.55.1-py311-cpu |
| Role | String | 否 | Pod角色(head/worker) 示例值:worker |
| CreateTime | Integer | 否 | 创建时间(毫秒时间戳) 示例值:1780112020000 |
| StartTime | Integer | 否 | 启动时间(毫秒时间戳) 示例值:1780112020000 |
Column
数据表列信息。
被如下接口引用:CreateTable, DescribeMCPTaskResult, DescribeNotebookSessionStatementSqlResult, DescribeTable, DescribeTables, DescribeTaskResult, DescribeViews, QueryResult。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 是 | 列名称,不区分大小写,最大支持25个字符。 示例值:col1 |
| Type | String | 是 | string|tinyint|smallint|int|bigint|boolean|float|double|decimal|timestamp|date|binary|array|map|struct|uniontype 示例值:string |
| Comment | String | 否 | 对该类的注释。 注意:此字段可能返回 null,表示取不到有效值。 示例值:create by zhangsan |
| Precision | Integer | 否 | 表示整个 numeric 的长度 示例值:5 |
| Scale | Integer | 否 | 表示小数部分的长度 示例值:2 |
| Nullable | String | 否 | 是否为null 示例值:Nullable |
| Position | Integer | 否 | 字段位置,小的在前 示例值:1 |
| CreateTime | String | 否 | 字段创建时间 参数格式:YYYY-MM-DD hh:mm:ss 示例值:2021-09-07 06:19:23 |
| ModifiedTime | String | 否 | 字段修改时间 参数格式:YYYY-MM-DD hh:mm:ss 示例值:2021-09-07 06:19:23 |
| IsPartition | Boolean | 否 | 是否为分区字段 示例值:false |
| DataMaskStrategyInfo | DataMaskStrategyInfo | 否 | 数据脱敏策略信息 注意:此字段可能返回 null,表示取不到有效值。 |
| TypeText | String | 否 | 数据字段说明 示例值:decimal |
CommonMetrics
任务公共指标
被如下接口引用:DescribeSparkAppTasks, DescribeTaskDetail, DescribeTaskList, DescribeTasks。
| 名称 | 类型 | 描述 |
|---|---|---|
| CreateTaskTime | Float | 创建任务时长,单位:ms 注意:此字段可能返回 null,表示取不到有效值。 示例值:96 |
| ProcessTime | Float | 预处理总时长,单位:ms 注意:此字段可能返回 null,表示取不到有效值。 示例值:223 |
| QueueTime | Float | 排队时长,单位:ms 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| ExecutionTime | Float | 执行时长,单位:ms 注意:此字段可能返回 null,表示取不到有效值。 示例值:8981 |
| IsResultCacheHit | Boolean | 是否命中结果缓存 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
| MatchedMVBytes | Integer | 匹配物化视图数据量 注意:此字段可能返回 null,表示取不到有效值。 示例值:...[] |
| MatchedMVs | String | 匹配物化视图列表 注意:此字段可能返回 null,表示取不到有效值。 示例值:null |
| AffectedBytes | String | 结果数据量,单位:byte 注意:此字段可能返回 null,表示取不到有效值。 示例值:7614 |
| AffectedRows | Integer | 结果行数 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| ProcessedBytes | Integer | 扫描数据量,单位:byte 注意:此字段可能返回 null,表示取不到有效值。 示例值:17562718 |
| ProcessedRows | Integer | 扫描行数 注意:此字段可能返回 null,表示取不到有效值。 示例值:19327 |
CoreInfo
任务 core 用量信息
被如下接口引用:DescribeTaskResourceUsage。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Timestamp | Array of Integer | 否 | 时间戳(毫秒)数组 示例值:[1749193814000] |
| CoreUsage | Array of Integer | 否 | core 用量 示例值:[1,1] |
CosPermission
cos权限描述
被如下接口引用:CreateUserRole, DescribeUserRoles。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| CosPath | String | 否 | cos路径 注意:此字段可能返回 null,表示取不到有效值。 示例值:cosn://*** |
| Permissions | Array of String | 否 | 权限【"read","write"】 注意:此字段可能返回 null,表示取不到有效值。 示例值:["read","write"] |
CpuSummaryItem
CPU resource summary item aggregated from all running deployments.
被如下接口引用:CreateInferenceService, GetInferenceService, ListInferenceServices, RestartInferenceService, StopInferenceService, UpdateServiceAuthConfig。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| TotalCpuCores | Integer | 否 | CPU 总核数(headCpu + cpu × replicas 的总和) 示例值:2 |
| TotalMemoryGB | Integer | 否 | 内存总量(headMem + mem × replicas 的总和,单位 GB) 示例值:16 |
| Replicas | Integer | 否 | 运行中的副本总数 示例值:2 |
CrontabResumeSuspendStrategy
定时启停策略信息
被如下接口引用:CreateDataEngine, DescribeDataEngine, DescribeDataEngines, UpdateDataEngine。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ResumeTime | String | 否 | 定时拉起时间:如:周一&周三8点 示例值:0000101-08:00:00 |
| SuspendTime | String | 否 | 定时挂起时间:如:周一&周三20点 示例值:0000101-20:00:00 |
| SuspendStrategy | Integer | 否 | 挂起配置:0(默认):等待任务结束后挂起、1:强制挂起 示例值:0 |
CustomConfig
自定义参数
被如下接口引用:CreateDatasourceConnection, DescribeDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ConfigKey | String | 否 | 自定义参数名 示例值:hive.iceberg-catalog-name |
| ConfigValue | String | 否 | 自定义参数值 示例值:prod_iceberg |
DLCCatalogAccess
DLC 数据目录访问权限
被如下接口引用:DescribeDLCCatalogAccess。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| VpcId | String | 是 | VPCID 示例值:vpc-1234567 |
| Product | String | 是 | 产品类型 示例值:EMR |
| Description | String | 否 | 描述信息 示例值:生产环境 |
| CreateTime | String | 否 | 创建时间 示例值:2024-01-01 10:10:10 |
DMSColumn
迁移列对象
被如下接口引用:AlterDMSTable, CreateDMSTable, DescribeDMSTable, DescribeDMSTables。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:name1 |
| Description | String | 否 | 描述 注意:此字段可能返回 null,表示取不到有效值。 示例值:desc1 |
| Type | String | 否 | 类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:EXTERNAL |
| Position | Integer | 否 | 排序 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| Params | Array of KVPair | 否 | 附加参数 注意:此字段可能返回 null,表示取不到有效值。 |
| BizParams | Array of KVPair | 否 | 业务参数 注意:此字段可能返回 null,表示取不到有效值。 |
| IsPartition | Boolean | 否 | 是否分区 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
DMSColumnOrder
列排序对象
被如下接口引用:AlterDMSTable, CreateDMSTable, DescribeDMSTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Col | String | 否 | 列名 注意:此字段可能返回 null,表示取不到有效值。 示例值:col1 |
| Order | Integer | 否 | 排序 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
DMSPartition
迁移元数据分区对象
被如下接口引用:AddDMSPartitions, AlterDMSPartition, AlterDMSTable, CreateDMSTable, DescribeDMSPartitions, DescribeDMSTable, DescribeDMSTables。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DatabaseName | String | 否 | 数据库名称 示例值:11 |
| SchemaName | String | 否 | 数据目录名称 示例值:schema1 |
| TableName | String | 否 | 表名称 示例值:table1 |
| DataVersion | Integer | 否 | 数据版本 示例值:1 |
| Name | String | 否 | 分区名称 示例值:partition1 |
| Values | Array of String | 否 | 值列表 示例值:["aa", "bb"] |
| StorageSize | Integer | 否 | 存储大小 示例值:1 |
| RecordCount | Integer | 否 | 记录数量 示例值:1 |
| CreateTime | Timestamp ISO8601 | 否 | 创建时间 示例值:2021-05-08 16:43:16 |
| ModifiedTime | Timestamp ISO8601 | 否 | 修改时间 示例值:2021-05-08 16:43:16 |
| LastAccessTime | Timestamp ISO8601 | 否 | 最后访问时间 示例值:2021-05-08 16:43:16 |
| Params | Array of KVPair | 否 | 附件属性 |
| Sds | DMSSds | 否 | 存储对象 |
| DatasourceConnectionName | String | 否 | 数据源连接名 示例值:DataLakeCatalog |
DMSSds
元数据存储描述属性
被如下接口引用:AddDMSPartitions, AlterDMSPartition, AlterDMSTable, CreateDMSTable, DescribeDMSPartitions, DescribeDMSTable, DescribeDMSTables。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Location | String | 否 | 存储地址 注意:此字段可能返回 null,表示取不到有效值。 示例值:cosn://aaa |
| InputFormat | String | 否 | 输入格式 注意:此字段可能返回 null,表示取不到有效值。 示例值:InputFormat |
| OutputFormat | String | 否 | 输出格式 注意:此字段可能返回 null,表示取不到有效值。 示例值:OutputFormat |
| NumBuckets | Integer | 否 | bucket数量 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| Compressed | Boolean | 否 | 是是否压缩 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
| StoredAsSubDirectories | Boolean | 否 | 是否有子目录 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| SerdeLib | String | 否 | 序列化lib 注意:此字段可能返回 null,表示取不到有效值。 示例值:org.apache.hadoop.hive.serde2.OpenCSVSerde |
| SerdeName | String | 否 | 序列化名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:serde1 |
| BucketCols | Array of String | 否 | 桶名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:["aa", "bb"] |
| SerdeParams | Array of KVPair | 否 | 序列化参数 注意:此字段可能返回 null,表示取不到有效值。 |
| Params | Array of KVPair | 否 | 附加参数 注意:此字段可能返回 null,表示取不到有效值。 |
| SortCols | DMSColumnOrder | 否 | 列排序(Expired) 注意:此字段可能返回 null,表示取不到有效值。 |
| Cols | Array of DMSColumn | 否 | 列 注意:此字段可能返回 null,表示取不到有效值。 |
| SortColumns | Array of DMSColumnOrder | 否 | 列排序字段 注意:此字段可能返回 null,表示取不到有效值。 |
DMSTable
DMSTable基本信息
被如下接口引用:DescribeDMSTables。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ViewOriginalText | String | 否 | 视图文本 注意:此字段可能返回 null,表示取不到有效值。 示例值:select 1 |
| ViewExpandedText | String | 否 | 视图文本 注意:此字段可能返回 null,表示取不到有效值。 示例值:select 1 |
| Retention | Integer | 否 | hive维护版本 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| Sds | DMSSds | 否 | 存储对象 注意:此字段可能返回 null,表示取不到有效值。 |
| PartitionKeys | Array of DMSColumn | 否 | 分区列 注意:此字段可能返回 null,表示取不到有效值。 |
| Partitions | Array of DMSPartition | 否 | 分区 注意:此字段可能返回 null,表示取不到有效值。 |
| Type | String | 否 | 表类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:EXTERNAL |
| DbName | String | 否 | 数据库名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:db1 |
| SchemaName | String | 否 | Schema名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:schema1 |
| StorageSize | Integer | 否 | 存储大小 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| RecordCount | Integer | 否 | 记录数量 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| LifeTime | Integer | 否 | 生命周期 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| LastAccessTime | Timestamp ISO8601 | 否 | 最后访问时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:2020-01-01 11:11:11 |
| DataUpdateTime | Timestamp ISO8601 | 否 | 数据更新时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:2020-01-01 11:11:11 |
| StructUpdateTime | Timestamp ISO8601 | 否 | 结构更新时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:2020-01-01 11:11:11 |
| Columns | Array of DMSColumn | 否 | 列 注意:此字段可能返回 null,表示取不到有效值。 |
| Name | String | 否 | 表名 注意:此字段可能返回 null,表示取不到有效值。 示例值:tb1 |
DMSTableInfo
DMSTable信息
被如下接口引用:DescribeDMSTables。
DataEngineBasicInfo
DataEngine基本信息
被如下接口引用:DescribeUpdatableDataEngines。
| 名称 | 类型 | 描述 |
|---|---|---|
| DataEngineName | String | DataEngine名称 示例值:dlc_presto |
| State | Integer | 数据引擎状态 -2已删除 -1失败 0初始化中 1挂起 2运行中 3准备删除 4删除中 示例值:1 |
| CreateTime | Integer | 创建时间 示例值:1635320563 |
| UpdateTime | Integer | 更新时间 示例值:1635320563 |
| Message | String | 返回信息 示例值:测试资源 |
| DataEngineId | String | 引擎id 示例值:DataEngine-houseid1 |
| DataEngineType | String | 引擎类型,有效值:PrestoSQL/SparkSQL/SparkBatch 示例值:SparkSQL |
| AppId | Integer | 用户ID 示例值:130****568 |
| UserUin | String | 账号ID 示例值:1000****6235 |
DataEngineConfigInstanceInfo
引擎配置信息
被如下接口引用:DescribeUserDataEngineConfig。
| 名称 | 类型 | 描述 |
|---|---|---|
| DataEngineId | String | 引擎ID 示例值:Dataengine-xx |
| DataEngineConfigPairs | Array of DataEngineConfigPair | 用户自定义配置项集合 |
| SessionResourceTemplate | SessionResourceTemplate | 作业集群资源参数配置模板 |
DataEngineConfigPair
引擎配置
被如下接口引用:CheckDataEngineConfigPairsValidity, CreateDataEngine, DescribeUserDataEngineConfig, UpdateDataEngine, UpdateUserDataEngineConfig。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ConfigItem | String | 是 | 配置项 示例值:dlc.query.execution.timeout |
| ConfigValue | String | 是 | 配置值 示例值:360 |
DataEngineImageSessionParameter
集群Session配置信息.
被如下接口引用:DescribeDataEngineSessionParameters。
| 名称 | 类型 | 描述 |
|---|---|---|
| ParameterId | String | 配置id 示例值:d3018ad4-9a7e-4f64-a3f4-f38507c69742 |
| ChildImageVersionId | String | 小版本镜像ID 示例值:d30dfgsf4-9a7e-4f64-a3f4-f38507c69742 |
| EngineType | String | 集群类型:SparkSQL/PrestoSQL/SparkBatch 示例值:SparkSQL |
| KeyName | String | 参数key 示例值:spark.sql.shuffle.partitions |
| KeyDescription | String | Key描述信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:默认分区数。 |
| ValueType | String | value类型 示例值:string |
| ValueLengthLimit | String | value长度限制 注意:此字段可能返回 null,表示取不到有效值。 示例值:100 |
| ValueRegexpLimit | String | value正则限制 注意:此字段可能返回 null,表示取不到有效值。 示例值:[0-9]+$ |
| ValueDefault | String | value默认值 注意:此字段可能返回 null,表示取不到有效值。 示例值:200 |
| IsPublic | Integer | 是否为公共版本:1:公共;2:私有 示例值:1 |
| ParameterType | Integer | 配置类型:1:session配置(默认);2:common配置;3:cluster配置 示例值:1 |
| SubmitMethod | String | 提交方式:User(用户)、BackGround(后台) 示例值:User |
| Operator | String | 操作者 注意:此字段可能返回 null,表示取不到有效值。 示例值:admin |
| InsertTime | String | 插入时间 示例值:2020-01-01 01:01:01 |
| UpdateTime | String | 更新时间 示例值:2020-01-01 01:01:01 |
DataEngineImageVersion
集群大版本镜像信息。
被如下接口引用:DescribeDataEngineImageVersions。
| 名称 | 类型 | 描述 |
|---|---|---|
| ImageVersionId | String | 镜像大版本ID 示例值:d3018ad4-9a7e-4f64-a3f4-f38507c69742 |
| ImageVersion | String | 镜像大版本名称 示例值:SuperSQL |
| Description | String | 镜像大版本描述 示例值:测试版本 |
| IsPublic | Integer | 是否为公共版本:1:公共;2:私有 示例值:1 |
| EngineType | String | 集群类型:SparkSQL/PrestoSQL/SparkBatch 示例值:SparkSQL |
| IsSharedEngine | Integer | 版本状态:1:初始化;2:上线;3:下线 示例值:1 |
| State | Integer | 版本状态:1:初始化;2:上线;3:下线 示例值:2 |
| InsertTime | String | 插入时间 示例值:2020-01-01 01:01:01 |
| UpdateTime | String | 更新时间 示例值:2020-01-01 01:01:01 |
DataEngineInfo
DataEngine详细信息
被如下接口引用:DescribeDataEngine, DescribeDataEngines, DescribeDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DataEngineName | String | 是 | DataEngine名称 示例值:shared_presto |
| EngineType | String | 是 | 引擎类型 spark/presto 示例值:presto |
| ClusterType | String | 是 | 集群资源类型 spark_private/presto_private/presto_cu/spark_cu 示例值:presto_private |
| QuotaId | String | 否 | 引用ID 示例值:**** |
| State | Integer | 否 | 数据引擎状态 -2已删除 -1失败 0初始化中 1挂起 2运行中 3准备删除 4删除中 示例值:1 |
| CreateTime | Integer | 否 | 创建时间 示例值:1635320563 |
| UpdateTime | Integer | 否 | 更新时间 示例值:1635320563 |
| Size | Integer | 否 | 集群规格 注意:此字段可能返回 null,表示取不到有效值。 示例值:64 |
| Mode | Integer | 否 | 计费模式 0共享模式 1按量计费 2包年包月 示例值:0 |
| MinClusters | Integer | 否 | 最小集群数 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| MaxClusters | Integer | 否 | 最大集群数 注意:此字段可能返回 null,表示取不到有效值。 示例值:10 |
| AutoResume | Boolean | 否 | 是否自动恢复 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| SpendAfter | Integer | 否 | 自动恢复时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:10 |
| CidrBlock | String | 否 | 集群网段 注意:此字段可能返回 null,表示取不到有效值。 示例值:10.255.252.0/22 |
| DefaultDataEngine | Boolean | 否 | 是否为默认引擎 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| Message | String | 否 | 返回信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:测试资源 |
| DataEngineId | String | 否 | 引擎id 示例值:025495-cfe0-461c-8c3d-5715d03feda4 |
| SubAccountUin | String | 否 | 操作者 示例值:**** |
| ExpireTime | String | 否 | 到期时间 示例值:2022-03-16 10:41:03 |
| IsolatedTime | String | 否 | 隔离时间 示例值:2022-03-16 10:41:03 |
| ReversalTime | String | 否 | 冲正时间 示例值:2022-03-16 10:41:03 |
| UserAlias | String | 否 | 用户名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:testname |
| TagList | Array of TagInfo | 否 | 标签对集合 注意:此字段可能返回 null,表示取不到有效值。 |
| Permissions | Array of String | 否 | 引擎拥有的权限 注意:此字段可能返回 null,表示取不到有效值。 示例值:["USE"] |
| AutoSuspend | Boolean | 否 | 是否自定挂起集群:false(默认):不自动挂起、true:自动挂起 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
| CrontabResumeSuspend | Integer | 否 | 定时启停集群策略:0(默认):关闭定时策略、1:开启定时策略(注:定时启停策略与自动挂起策略互斥) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| CrontabResumeSuspendStrategy | CrontabResumeSuspendStrategy | 否 | 定时启停策略,复杂类型:包含启停时间、挂起集群策略 注意:此字段可能返回 null,表示取不到有效值。 |
| EngineExecType | String | 否 | 引擎执行任务类型,有效值:SQL/BATCH 注意:此字段可能返回 null,表示取不到有效值。 示例值:SQL |
| RenewFlag | Integer | 否 | 自动续费标志,0,初始状态,默认不自动续费,若用户有预付费不停服特权,自动续费。1:自动续费。2:明确不自动续费 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| AutoSuspendTime | Integer | 否 | 集群自动挂起时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:10 |
| NetworkConnectionSet | Array of NetworkConnection | 否 | 网络连接配置 注意:此字段可能返回 null,表示取不到有效值。 |
| UiURL | String | 否 | ui的跳转地址 注意:此字段可能返回 null,表示取不到有效值。 示例值:dlc-xxx.com |
| ResourceType | String | 否 | 引擎的资源类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:Standard_CU |
| ImageVersionId | String | 否 | 集群镜像版本ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:7ac9cc78-bc95-440f-9768-4f4a79048755 |
| ChildImageVersionId | String | 否 | 集群镜像小版本ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:772f03ca-92ed-4f02-aaa2-0c26b0818ec4 |
| ImageVersionName | String | 否 | 集群镜像版本名字 注意:此字段可能返回 null,表示取不到有效值。 示例值:SuperSQL-S 1.0 |
| StartStandbyCluster | Boolean | 否 | 是否开启备集群 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
| ElasticSwitch | Boolean | 否 | spark jar 包年包月集群是否开启弹性 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
| ElasticLimit | Integer | 否 | spark jar 包年包月集群弹性上限 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| DefaultHouse | Boolean | 否 | 是否为默认引擎 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| MaxConcurrency | Integer | 否 | 单个集群任务最大并发数 注意:此字段可能返回 null,表示取不到有效值。 示例值:5 |
| TolerableQueueTime | Integer | 否 | 任务排队上限时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:1000 |
| UserAppId | Integer | 否 | 用户appid 注意:此字段可能返回 null,表示取不到有效值。 示例值:125111081 |
| UserUin | String | 否 | 用户uin 注意:此字段可能返回 null,表示取不到有效值。 示例值:1000****4787 |
| SessionResourceTemplate | SessionResourceTemplate | 否 | SessionResourceTemplate 注意:此字段可能返回 null,表示取不到有效值。 |
| AutoAuthorization | Boolean | 否 | 自动授权开关 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| EngineGeneration | String | 否 | 引擎版本,支持Native/SuperSQL 注意:此字段可能返回 null,表示取不到有效值。 示例值:Native |
| EngineTypeDetail | String | 否 | 引擎详细类型,支持:SparkSQL/SparkBatch/PrestoSQL/Kyuubi 注意:此字段可能返回 null,表示取不到有效值。 示例值:SparkSQL |
| EngineNetworkId | String | 否 | 引擎网络ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:Engine-Network-xxx |
| EngineResourceGroupCount | Integer | 否 | 标准引擎关联的资源组个数 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| EngineResourceUsedCU | Integer | 否 | 引擎当前使用量(Cu) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| AccessInfos | Array of AccessInfo | 否 | 引擎的访问信息 注意:此字段可能返回 null,表示取不到有效值。 |
| EngineNetworkName | String | 否 | 引擎所在网络名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:default-network |
| IsPoolMode | String | 否 | 是否使用预留池 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| IsSupportAI | Boolean | 否 | 是否支持AI,false: 不支持;true:支持 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
| GatewayId | String | 否 | 网关id 注意:此字段可能返回 null,表示取不到有效值。 示例值:dataengine-xxx |
| GatewayState | Integer | 否 | 网关状态 注意:此字段可能返回 null,表示取不到有效值。 示例值:2 |
| IsAIGateway | Boolean | 否 | 是否能执行AI任务 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| IsAIEngine | Integer | 否 | 1:AI引擎,0:非AI引擎 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| ScheduleElasticityConf | ScheduleElasticityConf | 否 | 引擎资源弹性伸缩策略 |
| GPUInfo | GPUInfo | 否 | GPU 信息 |
| EngineResourceUsedGPU | Integer | 否 | GPU 使用量 示例值:1 |
| GPUTotalSize | Integer | 否 | GPU 总规格 示例值:1 |
| InstanceModel | String | 否 | GPU 机型 示例值:sv |
| NodeNum | Integer | 否 | 节点数量 示例值:1 |
| SizeWithElastic | Integer | 否 | 引擎规格,包含负载弹性或分时弹性 示例值:16 |
| MaxElasticSize | Integer | 否 | 最大弹性值,包含负载弹性或分时弹性 示例值:16 |
DataEngineScaleInfo
引擎规格详情
被如下接口引用:DescribeDataEnginesScaleDetail。
| 名称 | 类型 | 描述 |
|---|---|---|
| DataEngineId | String | 引擎ID 示例值:dataengine-mock |
| DataEngineName | String | 引擎名称 示例值:dlc_engine |
| ScaleDetail | Array of DataEngineScaleInfoDetail | 引擎规格详情 示例值: [ { "StartTime": "2024-06-06 12:00:00", "EndTime": "2024-06-06 13:00:00", "CU": 0 } ] |
DataEngineScaleInfoDetail
引擎规格详情
被如下接口引用:DescribeDataEnginesScaleDetail。
| 名称 | 类型 | 描述 |
|---|---|---|
| StartTime | String | 统计开始时间,格式为:yyyy-MM-dd HH:mm:ss 示例值:2024-06-06 12:00:00 |
| EndTime | String | 统计结束时间,格式为:yyyy-MM-dd HH:mm:ss 示例值:2024-06-06 13:00:00 |
| CU | Integer | 当前统计时间段,引擎规格 示例值:16 |
DataFormat
数据表数据格式。
被如下接口引用:CreateTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| TextFile | TextFile | 否 | 文本格式,TextFile。 注意:此字段可能返回 null,表示取不到有效值。 |
| CSV | CSV | 否 | 文本格式,CSV。 注意:此字段可能返回 null,表示取不到有效值。 |
| Json | Other | 否 | 文本格式,Json。 注意:此字段可能返回 null,表示取不到有效值。 |
| Parquet | Other | 否 | Parquet格式 注意:此字段可能返回 null,表示取不到有效值。 |
| ORC | Other | 否 | ORC格式 注意:此字段可能返回 null,表示取不到有效值。 |
| AVRO | Other | 否 | AVRO格式 注意:此字段可能返回 null,表示取不到有效值。 |
DataGovernPolicy
数据治理规则
被如下接口引用:CreateMetaDatabase, DescribeDatabase, DescribeDatabases。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| RuleType | String | 否 | 治理规则类型,Customize: 自定义;Intelligence: 智能治理 示例值:Customize |
| GovernEngine | String | 否 | 治理引擎 示例值:DataEngine- |
DataMaskStrategy
数据脱敏策略信息
被如下接口引用:DescribeDataMaskStrategies。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| StrategyId | String | 否 | 策略ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| UserAppId | String | 否 | 用户AppId 注意:此字段可能返回 null,表示取不到有效值。 示例值:1232121211 |
| Uin | String | 否 | 用户Uin 注意:此字段可能返回 null,表示取不到有效值。 示例值:1212313121 |
| SubAccountUin | String | 否 | 操作用户子账号uin 注意:此字段可能返回 null,表示取不到有效值。 示例值:1213124121 |
| StrategyName | String | 否 | 策略名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:策略1 |
| StrategyType | String | 否 | MASK_SHOW_FIRST_4; MASK_SHOW_LAST_4;MASK_HASH; MASK_DATE_SHOW_YEAR; MASK_NULL; MASK_DEFAULT 等 注意:此字段可能返回 null,表示取不到有效值。 示例值:MASK_SHOW_FIRST_4 |
| StrategyDesc | String | 否 | 策略描述 注意:此字段可能返回 null,表示取不到有效值。 示例值:描述 |
| Groups | Array of GroupInfo | 否 | 用户组策略列表 注意:此字段可能返回 null,表示取不到有效值。 |
| Users | String | 否 | 用户子账号uin列表,按;拼接 注意:此字段可能返回 null,表示取不到有效值。 示例值:12312314112;1231231231 |
| State | Integer | 否 | 1: 生效中; 0:已删除 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| CreateTime | Integer | 否 | 策略创建时间,毫秒时间戳 注意:此字段可能返回 null,表示取不到有效值。 示例值:1723106621346 |
| UpdateTime | Integer | 否 | 策略更新时间,毫秒时间戳 注意:此字段可能返回 null,表示取不到有效值。 示例值:1723106621346 |
DataMaskStrategyInfo
数据脱敏策略信息
被如下接口引用:CreateDataMaskStrategy, DescribeNotebookSessionStatementSqlResult, DescribeTable, DescribeTables, QueryResult, UpdateDataMaskStrategy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| StrategyName | String | 否 | 策略名称 示例值:策略1 |
| StrategyType | String | 否 | MASK_SHOW_FIRST_4; MASK_SHOW_LAST_4;MASK_HASH; MASK_DATE_SHOW_YEAR; MASK_NULL; MASK_DEFAULT 等 示例值:MASK_SHOW_FIRST_4 |
| StrategyDesc | String | 否 | 策略描述 示例值:for testing purpose |
| Groups | Array of GroupInfo | 否 | 用户组策略列表 注意:此字段可能返回 null,表示取不到有效值。 |
| Users | String | 否 | 用户子账号uin列表,按;拼接 示例值:12312314112;1231231231 |
| StrategyId | String | 否 | 策略Id 示例值:1 |
DataMaskStrategyPolicy
数据脱敏策略权限对象
被如下接口引用:AttachDataMaskPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| PolicyInfo | Policy | 否 | 数据脱敏权限对象 注意:此字段可能返回 null,表示取不到有效值。 |
| DataMaskStrategyId | String | 否 | 数据脱敏策略ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:1123-12a-31231 |
| ColumnType | String | 否 | 绑定字段类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:int |
DataSourceInfo
数据源详细信息
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InstanceId | String | 否 | 数据源实例的唯一ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:datasource-test |
| InstanceName | String | 否 | 数据源的名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:test_datasource |
| JdbcUrl | String | 否 | 数据源的JDBC访问链接 注意:此字段可能返回 null,表示取不到有效值。 示例值:jdbc:postgresql://ip:port/ |
| User | String | 否 | 用于访问数据源的用户名 注意:此字段可能返回 null,表示取不到有效值。 示例值:root |
| Password | String | 否 | 数据源访问密码,需要base64编码 注意:此字段可能返回 null,表示取不到有效值。 示例值:xaskdowq+= |
| Location | DatasourceConnectionLocation | 否 | 数据源的VPC和子网信息 注意:此字段可能返回 null,表示取不到有效值。 |
| DbName | String | 否 | 默认数据库名 注意:此字段可能返回 null,表示取不到有效值。 示例值:default |
DatabaseInfo
数据库对象
被如下接口引用:CreateDatabase。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DatabaseName | String | 是 | 数据库名称,长度0~128,支持数字、字母下划线,不允许数字大头,统一转换为小写。 示例值:database1 |
| Comment | String | 否 | 数据库描述信息,长度 0~500。 注意:此字段可能返回 null,表示取不到有效值。 示例值:create by zhangsan |
| Properties | Array of Property | 否 | 数据库属性列表。 注意:此字段可能返回 null,表示取不到有效值。 |
| Location | String | 否 | 数据库cos路径 示例值:cosn:// |
DatabaseResponseInfo
数据库对象
被如下接口引用:DescribeDatabase, DescribeDatabases。
| 名称 | 类型 | 描述 |
|---|---|---|
| DatabaseName | String | 数据库名称。 示例值:database1 |
| Comment | String | 数据库描述信息,长度 0~256。 示例值:create by zhangsan |
| Properties | Array of Property | 允许针对数据库的属性元数据信息进行指定。 注意:此字段可能返回 null,表示取不到有效值。 |
| CreateTime | String | 数据库创建时间戳,单位:s。 注意:此字段可能返回 null,表示取不到有效值。 示例值:1611646963 |
| ModifiedTime | String | 数据库更新时间戳,单位:s。 注意:此字段可能返回 null,表示取不到有效值。 示例值:1611646963 |
| Location | String | cos存储路径 示例值:cosn://test |
| UserAlias | String | 建库用户昵称 示例值:testUser |
| UserSubUin | String | 建库用户ID 示例值:100019878767 |
| GovernPolicy | DataGovernPolicy | 数据治理配置项 注意:此字段可能返回 null,表示取不到有效值。 |
| DatabaseId | String | 数据库ID(无效字段) 示例值:21903 |
| CatalogName | String | 所属catalog名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:DataLakeCatalog |
| CatalogType | String | 所属catalog 类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:LAKEHOUSE |
| IsInformationSchema | Boolean | 是否InformationSchema 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
DatasetMount
数据文件名(可选),JSONL/parquet 文件名,位于挂载目录下;后训练场景等价于旧 Dataset 字段。数据集 COS 路径指向具体文件时后端自动提取文件名,无需填写
被如下接口引用:CancelTrainingJobInstance, CreateTrainingJobInstance, DescribeTrainingJobInstance, DescribeTrainingJobSpec, ListMlflowServerTrainingInstances, ListTrainingJobInstance, ListTrainingJobSpec, ModifyTrainingJobSpec, ResumeTrainingJobInstance, SubmitTrainingJob。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DatasetId | String | 否 | 数据集ID 示例值:5 |
| DatasetName | String | 否 | 数据集名称 示例值:Math-Step-DPO-10K |
| Catalog | String | 否 | 挂载信息 示例值:{"Catalog":"{"COSVolumes":[],"CFSVolumes":[{"FileSystemId":"cfs-99dt0xbn","VolumeSubPath":"/datasets","MountPath":"/datas","Source":"dataset","Origin":"cos_reference"}],"CFSTurboVolumes":[],"GooseFSVolumes":[]}"} |
| Eval | EvalDatasetConfig | 否 | 验证集信息 |
| FileName | String | 否 | 数据集为单个文件时,若需挂载单个文件,需提供文件名 示例值:file123.json |
DatasourceConnectionConfig
数据源属性
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection, DescribeDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Mysql | MysqlInfo | 否 | Mysql数据源连接的属性 注意:此字段可能返回 null,表示取不到有效值。 |
| Hive | HiveInfo | 否 | Hive数据源连接的属性 注意:此字段可能返回 null,表示取不到有效值。 |
| Kafka | KafkaInfo | 否 | Kafka数据源连接的属性 注意:此字段可能返回 null,表示取不到有效值。 |
| OtherDatasourceConnection | OtherDatasourceConnection | 否 | 其他数据源连接的属性 注意:此字段可能返回 null,表示取不到有效值。 |
| PostgreSql | DataSourceInfo | 否 | PostgreSQL数据源连接的属性 注意:此字段可能返回 null,表示取不到有效值。 |
| SqlServer | DataSourceInfo | 否 | SQLServer数据源连接的属性 注意:此字段可能返回 null,表示取不到有效值。 |
| ClickHouse | DataSourceInfo | 否 | ClickHouse数据源连接的属性 注意:此字段可能返回 null,表示取不到有效值。 |
| Elasticsearch | ElasticsearchInfo | 否 | Elasticsearch数据源连接的属性 注意:此字段可能返回 null,表示取不到有效值。 |
| TDSQLPostgreSql | DataSourceInfo | 否 | TDSQL-PostgreSQL数据源连接的属性 注意:此字段可能返回 null,表示取不到有效值。 |
| TCHouseD | TCHouseD | 否 | Doris数据源连接的属性 注意:此字段可能返回 null,表示取不到有效值。 |
| TccHive | TccHive | 否 | TccHive数据目录连接信息 |
| MongoDB | DataSourceInfo | 否 | MongoDB 数据源 |
| TCHouseP | TCHousePInfo | 否 | TCHouseP数据源 |
DatasourceConnectionInfo
数据源信息
被如下接口引用:DescribeDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | Integer | 是 | 数据源数字Id 示例值:42 |
| DatasourceConnectionId | String | 是 | 数据源字符串Id 示例值:datasource-xxx |
| DatasourceConnectionName | String | 是 | 数据源名称 示例值:DataLakeCatalog |
| DatasourceConnectionDesc | String | 是 | 数据源描述 示例值:测试数据源 |
| DatasourceConnectionType | String | 是 | 数据源类型,支持DataLakeCatalog、IcebergCatalog、Result、Mysql、HiveCos、HiveHdfs 示例值:DataLakeCatalog |
| DatasourceConnectionConfig | DatasourceConnectionConfig | 是 | 数据源属性 注意:此字段可能返回 null,表示取不到有效值。 |
| State | Integer | 是 | 数据源状态:0(初始化)、1(成功)、-1(已删除)、-2(失败)、-3(删除中) 示例值:0 |
| Region | String | 是 | 地域 示例值:ap-beijjing |
| AppId | String | 是 | 用户AppId 示例值:123xxx789 |
| CreateTime | String | 是 | 数据源创建时间 示例值:1734570843 |
| UpdateTime | String | 是 | 数据源最近一次更新时间 示例值:1734570843 |
| Message | String | 是 | 数据源同步失败原因 示例值:success |
| DataEngines | Array of DataEngineInfo | 否 | 数据源绑定的计算引擎信息 注意:此字段可能返回 null,表示取不到有效值。 |
| UserAlias | String | 否 | 创建人 示例值:user |
| NetworkConnectionSet | Array of NetworkConnection | 否 | 网络配置列表 注意:此字段可能返回 null,表示取不到有效值。 |
| ConnectivityState | Integer | 否 | 连通性状态:0(未测试,默认)、1(正常)、2(失败) 示例值:0 |
| ConnectivityTips | String | 否 | 连通性测试提示信息 示例值:测试成功 |
| CustomConfig | Array of CustomConfig | 否 | 自定义参数 |
| AllowRollback | Boolean | 否 | 是否允许回退 示例值:true |
DatasourceConnectionLocation
数据源连接的网络信息
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| VpcId | String | 是 | 数据连接所在Vpc实例Id,如“vpc-azd4dt1c”。 示例值:“vpc-azd4dt1c” |
| VpcCidrBlock | String | 是 | Vpc的IPv4 CIDR 示例值:“10.0.0.0/24” |
| SubnetId | String | 是 | 数据连接所在子网的实例Id,如“subnet-bthucmmy” 示例值:“subnet-bthucmmy” |
| SubnetCidrBlock | String | 是 | Subnet的IPv4 CIDR 示例值:“10.0.0.0/24” |
DependencyPackage
任务依赖包信息
被如下接口引用:CreateSparkApp, CreateSparkAppForTDLC, ModifySparkApp, ModifySparkAppForTDLC。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| PackageSource | String | 否 | 依赖包类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:Maven |
| MavenPackage | String | 否 | 依赖包信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:com.hedera.hashgraph:hapi:0.61.3 |
| MavenRepository | String | 否 | 依赖包仓库 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://mirrors.cloud.tencent.com/nexus/repository/maven-public |
| MavenExclusion | String | 否 | maven包exclusion信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:json:json |
| PypiPackage | String | 否 | pypi包信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:requests |
| PypiIndexUrl | String | 否 | pypi索引地址 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://pypi.org/simple |
| PackageType | String | 否 | 文件包的类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:jar |
| PackagePath | String | 否 | 文件包的路径 注意:此字段可能返回 null,表示取不到有效值。 示例值:cosn://a/b/c.jar |
DeploymentInfo
部署信息
被如下接口引用:ListDeployments。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DeploymentId | String | 否 | 部署 ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:deploy-20260606165607-xp4s |
| Name | String | 否 | 部署名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:m-qwen3-5-4b-6a223aba-951c-svc-deploy-1 |
| ServiceId | String | 否 | 关联的服务ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:svc-20260606165607-zvrv |
| ModelVersion | String | 否 | 部署使用的模型版本号 注意:此字段可能返回 null,表示取不到有效值。 示例值:2021-01-25 |
| Status | String | 否 | 部署状态(Running/Stopped/Deploying/Failed) 注意:此字段可能返回 null,表示取不到有效值。 示例值:Deploying |
| Engine | String | 否 | 推理引擎(vLLM/SGLang 等) 注意:此字段可能返回 null,表示取不到有效值。 示例值:vllm |
| Replicas | Integer | 否 | 期望副本数 注意:此字段可能返回 null,表示取不到有效值。 示例值:2 |
| AvailableReplicas | Integer | 否 | 可用副本数 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| ResourceConfig | String | 否 | 资源配置(JSON 字符串) 注意:此字段可能返回 null,表示取不到有效值。 示例值:{"workerBillingItem":"sv_dlc_gn7_gn75xlarge80","workerSpec":1,"headBillingItem":"sv_dlc_postpay_cu_standard_cu","headSpec":1,"gpu":"T4","gpuNum":1,"cpu":20,"mem":80,"headCpu":1,"headMem":4} |
| HeadHighAvailabilityEnabled | Boolean | 否 | ray head 是否开启高可用 示例值:false |
| AdvancedParams | String | 否 | 高级参数(JSON 字符串) 注意:此字段可能返回 null,表示取不到有效值。 示例值:{"EnableRemoteCode":false} |
| AutoscalingEnabled | Boolean | 否 | 是否开启自动伸缩 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| ModelStorageConfig | String | 否 | 模型存储配置(Catalog JSON,记录模型 COS 挂载信息) 注意:此字段可能返回 null,表示取不到有效值。 示例值:{"COSVolumes":[{"Region":"ap-guangzhou","Bucket":"common-job-packages-251233710","VolumeSubPath":"/builtin-models/Qwen3.5-4B/v1/","MountPath":"/builtin-models/Qwen3.5-4B/v1"}]} |
| CreateTime | Integer | 否 | 创建时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1780736167350 |
| UpdateTime | Integer | 否 | 更新时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1780736167451 |
| NeutrinoServeId | String | 否 | Neutrino Serve ID (RayService CR name) 注意:此字段可能返回 null,表示取不到有效值。 示例值:rayserve-20260606165607-llfe |
| RayDashboardUrl | String | 否 | Ray Dashboard 访问地址(通过 Ingress 代理,仅 Running 状态的部署有值) 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://cls-p9d8s1gc.tcray-gateway.ap-guangzhou.cloud.tencent.com:443/dlc-p-mghaaeha/rayserve-20260528010633-6ssd-kcgkm/ |
| ResourcePartitionId | String | 否 | 资源分区 ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:dlc-p-zntmtydc |
| Queue | String | 否 | 资源队列名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:default |
| AppId | Integer | 否 | App id 示例值:260200066 |
| Uin | String | 否 | Uin 示例值:700002655694 |
| SubAccountUin | String | 否 | SubAccountUin 示例值:700002655694 |
| AdvancedOptions | String | 否 | AdvancedOptions 高级参数(JSON 字符串,扁平 KV 结构,key 形如 spec.rayClusterConfig.headGroupSpec.serviceType) 注意:此字段可能返回 null,表示取不到有效值。 示例值:{"spec.excludeHeadPodFromServeSvc":"true"} |
| Image | String | 否 | 自定义镜像地址(为空则使用引擎默认镜像) 注意:此字段可能返回 null,表示取不到有效值。 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:2.55.1-py311-cu125-serve |
| ResourcePartitionName | String | 否 | 资源分区名称(后端按 ResourcePartitionId 反查 ResourceService 填充;分区不存在或 ResourceManager 未启用时可能为 null) 注意:此字段可能返回 null,表示取不到有效值。 示例值:dlc-test-03-cpu-resource-new |
DeploymentReplicaInfo
部署副本信息
被如下接口引用:ListDeploymentReplicas。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DeploymentId | Integer | 否 | 关联的部署ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:77 |
| Name | String | 否 | 副本名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:rayserve-20260608120438-185z-mt9m9-default-worker-worker-rnb9v |
| Status | String | 否 | 副本状态(Running/Pending/Failed/Terminated) 注意:此字段可能返回 null,表示取不到有效值。 示例值:Pending |
| RestartCount | Integer | 否 | 重启次数 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| NodeType | String | 否 | 节点类型(head/worker) 注意:此字段可能返回 null,表示取不到有效值。 示例值:worker |
| StartTime | Integer | 否 | 启动时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1780891485000 |
| PodIp | String | 否 | Pod IP 注意:此字段可能返回 null,表示取不到有效值。 示例值:30.0.0.132 |
| NodeName | String | 否 | 节点名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:30.0.0.113 |
| NodeIp | String | 否 | 节点 IP 注意:此字段可能返回 null,表示取不到有效值。 示例值:30.0.0.113 |
| Namespace | String | 否 | 命名空间 注意:此字段可能返回 null,表示取不到有效值。 示例值:dlc-p-zntmtydc |
| CpuRequest | String | 否 | CPU 请求 注意:此字段可能返回 null,表示取不到有效值。 示例值:400m |
| CpuLimit | String | 否 | CPU 限制 注意:此字段可能返回 null,表示取不到有效值。 示例值:20 |
| MemoryRequest | String | 否 | 内存请求 注意:此字段可能返回 null,表示取不到有效值。 示例值:1.6Gi |
| MemoryLimit | String | 否 | 内存限制 注意:此字段可能返回 null,表示取不到有效值。 示例值:80Gi |
| GpuCount | Integer | 否 | GPU 数量 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| Image | String | 否 | 容器镜像 注意:此字段可能返回 null,表示取不到有效值。 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:3.0.0.dev0-py311-cu125-extra |
| CreateTime | Integer | 否 | 创建时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1780891479000 |
DeploymentResourceInfo
部署的资源规格
被如下接口引用:CreateBenchmarkTask, RerunBenchmarkTask, StopBenchmarkTask。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DeploymentId | String | 否 | 部署业务唯一标识(deploymentUid) 示例值:deploy-20260729171407-f02y |
| DeploymentName | String | 否 | 部署名称 示例值:m-qwen2-5-personal-tes-11-123-svc-deploy-1 |
| Status | String | 否 | 部署状态 示例值:Running |
| WorkerBillingItem | String | 否 | Worker 节点 BillingItem 示例值:sv_dlc_gn7_gn75xlarge80 |
| WorkerSpec | Integer | 否 | Worker 节点规格倍数 示例值:1 |
| WorkerResourceType | String | 否 | Worker 节点资源类型,枚举: • GU — GPU 计费单位 • CU — CPU 计费单位 示例值:GU |
| HeadBillingItem | String | 否 | Head 节点 BillingItem 示例值:sv_dlc_standard_cu_standard_cu |
| HeadSpec | Integer | 否 | Head 节点规格倍数 示例值:2 |
| HeadResourceType | String | 否 | Head 节点资源类型。当前实现恒为 CU 示例值:CU |
| GpuType | String | 否 | GPU 型号。CPU 部署或型号未知时为空串 "" 示例值:T4 |
| Replicas | Integer | 否 | 期望副本数 示例值:1 |
ElasticPlan
引擎资源弹性伸缩计划
被如下接口引用:UpdateDataEngine。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| MinElasticClusters | Integer | 否 | 最小集群数 示例值:1 |
| MaxElasticClusters | Integer | 否 | 最大集群数 示例值:10 |
| TolerableQueueTime | Integer | 否 | 最大排队时间 示例值:10 |
| StartTime | String | 否 | 开始时间,Once格式:yyyy-MM-dd HH:mm:ss; 非Once格式: HH:mm:ss 示例值:21:00:00 |
| EndTime | String | 否 | 结束时间,Once格式:yyyy-MM-dd HH:mm:ss; 非Once格式: HH:mm:ss 示例值:22:00:00 |
| ElasticLimit | Integer | 否 | 分时弹性上限 示例值:16 |
ElasticsearchInfo
Elasticsearch数据源的详细信息
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InstanceId | String | 否 | 数据源ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:datasource-test |
| InstanceName | String | 否 | 数据源名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:test_datasource |
| User | String | 否 | 用户名 注意:此字段可能返回 null,表示取不到有效值。 示例值:root |
| Password | String | 否 | 密码,需要base64编码 注意:此字段可能返回 null,表示取不到有效值。 示例值:asdfcjaidf-= |
| Location | DatasourceConnectionLocation | 否 | 数据源的VPC和子网信息 注意:此字段可能返回 null,表示取不到有效值。 |
| DbName | String | 否 | 默认数据库名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:default |
| ServiceInfo | Array of IpPortPair | 否 | 访问Elasticsearch的ip、端口信息 注意:此字段可能返回 null,表示取不到有效值。 |
EmrResourceUsage
EMR-TKE 集群资源用量
被如下接口引用:DescribeEmrClusterInfo。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Cpu | String | 否 | CPU 用量,例如 2core 示例值:1core |
| Mem | String | 否 | 内存用量,例如 4GB 示例值:2GB |
EngineCapabilities
描述一个推理引擎的能力
被如下接口引用:DescribeModelEngines, ListInferenceEngines。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| GpuOptional | Boolean | 否 | GPU 是否可选 示例值:true |
| SupportsParallelConfig | Boolean | 否 | 是否支持并行配置 示例值:true |
| SupportsRemoteCode | Boolean | 否 | 是否支持远程代码 示例值:true |
| GpuMemoryKey | String | 否 | GPU 显存配置键名 示例值:gpu-memory-utilization |
| ParallelKeys | Array of ParallelKeyMapping | 否 | 并行配置键名列表 |
EngineNetworkInfo
引擎网络信息
被如下接口引用:DescribeEngineNetworks。
| 名称 | 类型 | 描述 |
|---|---|---|
| EngineNetworkName | String | 引擎网络名字 注意:此字段可能返回 null,表示取不到有效值。 |
| EngineNetworkState | Integer | 引擎网络状态,0--初始化,2--可用,-1--已删除 注意:此字段可能返回 null,表示取不到有效值。 |
| EngineNetworkCidr | String | 引擎网络cidr 注意:此字段可能返回 null,表示取不到有效值。 |
| EngineNetworkId | String | 引擎网络ID 注意:此字段可能返回 null,表示取不到有效值。 |
| CreateTime | Integer | 创建时间 注意:此字段可能返回 null,表示取不到有效值。 |
| UpdateTime | Integer | 更新时间 注意:此字段可能返回 null,表示取不到有效值。 |
| PrivateLinkNumber | Integer | 私有连接个数 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| EngineNumber | Integer | 计算引擎个数 注意:此字段可能返回 null,表示取不到有效值。 示例值:2 |
| GateWayInfo | Array of GatewayInfo | 网关信息 注意:此字段可能返回 null,表示取不到有效值。 |
EngineResourceGroupConfigPair
引擎资源组参数 配置项
被如下接口引用:CreateStandardEngineResourceGroup, DescribeStandardEngineResourceGroupConfigInfo。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ConfigItem | String | 是 | 配置项 注意:此字段可能返回 null,表示取不到有效值。 |
| ConfigValue | String | 是 | 配置项的值 注意:此字段可能返回 null,表示取不到有效值。 |
EngineSessionImage
TensorFlow、Pytorch、SK-learn镜像信息列表
被如下接口引用:DescribeSessionImageVersion。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| SparkImageId | String | 否 | Spark镜像唯一id 注意:此字段可能返回 null,表示取不到有效值。 |
| SparkImageVersion | String | 否 | Spark镜像版本名称 注意:此字段可能返回 null,表示取不到有效值。 |
| SparkImageType | Integer | 否 | 小版本镜像类型.1:TensorFlow、2:Pytorch、3:SK-learn 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| SparkImageTag | String | 否 | 镜像地址 注意:此字段可能返回 null,表示取不到有效值。 |
Env
环境变量标签
被如下接口引用:CreateResourceConfig, GetResourceConfig, UpdateResourceConfig。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 名称 示例值:1 |
| Value | String | 否 | 值 示例值:2 |
EvalDatasetConfig
验证数据集配置(作为 DatasetMount 属性,与训练集一对一)
被如下接口引用:CancelTrainingJobInstance, CreateTrainingJobInstance, DescribeTrainingJobInstance, ListMlflowServerTrainingInstances, ListTrainingJobInstance, ModifyTrainingJobSpec, ResumeTrainingJobInstance, SubmitTrainingJob。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| EvalMode | String | 否 | 验证集模式:none / split / separate 示例值:split |
| EvalSplitRatio | Float | 否 | 自动拆分比例(1-20,即 1%-20%),仅 split 生效 示例值:10 |
| EvalDatasetId | String | 否 | 独立验证数据集 ID(dataset 表),仅 separate 生效;与 Catalog 二选一 示例值:13 |
| EvalDatasetName | String | 否 | 验证数据集名称(dataset 表 name 字段,与 EvalDatasetId 配对) 示例值:xdaa |
| Catalog | String | 否 | 原始 Catalog 卷定义 JSON(仅 separate 生效,无数据集 ID 时使用,直接并入顶层 Catalog;与 EvalDatasetId 二选一) 示例值:{"Catalog":"{"COSVolumes":[],"CFSVolumes":[{"FileSystemId":"cfs-99dt0xbn","VolumeSubPath":"/datasets","MountPath":"/datas","Source":"dataset","Origin":"cos_reference"}],"CFSTurboVolumes":[],"GooseFSVolumes":[]}"} |
| FileName | String | 否 | 验证用单文件名(可选,JSONL/parquet 文件名,位于挂载目录下;仅基于单个文件验证时指定) 示例值:file123.json |
EventItem
数据实验室事件项
被如下接口引用:DescribeMlflowServerEvents, GetLabEvent, GetRayClusterEvent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| EventTime | Integer | 否 | 事件时间(Unix 时间戳,毫秒) 示例值:1780039441000 |
| Component | String | 否 | 组件名称,来源于 event.involvedObject.kind 示例值:Pod |
| Level | String | 否 | 事件级别,来源于 event.type 的原始值(如 Normal、Warning) 示例值:Warning |
| Message | String | 否 | 事件内容,来源于 event.message 示例值:Readiness probe failed: Get "http://30.0.1.55:52365/api/healthz": dial tcp 30.0.1.55:52365: connect: connection refused |
| InvolvedObjectName | String | 否 | 关联的 K8s 对象名称,来源于 event.involvedObject.name 示例值:mlflow-fe2455ce-mlflow-server-79469f5756-vbcks |
| SourceComponent | String | 否 | 事件来源组件,来源于 event.source.component 示例值:tke-eni-ipamd |
| Reason | String | 否 | 事件原因,来源于 event.reason 示例值:Pulled |
ExampleCategories
案例分类详情
被如下接口引用:ListExampleCategories。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Categories | String | 否 | 分类名称 示例值:generative-ai |
ExampleDifficulties
案例难度详情
被如下接口引用:ListExampleDifficulties。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Difficulty | String | 否 | 案例难度 示例值:advanced |
ExampleEntity
案例实体
被如下接口引用:ListExamples。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | Integer | 否 | ID 示例值:11 |
| ExampleId | String | 否 | 案例ID 示例值:example-001-ray-core-basics |
| Title | String | 否 | 标题 示例值:Ray入门,你的第一个分布式作业 |
| Description | String | 否 | 描述 示例值:通过简单案例快速掌握Ray的三大核心概念:Task、Actor和Object |
| Readme | String | 否 | README 示例值:# Ray Core 核心概念速览> 本案例是 Ray 案例广场的 Hello World。 |
| CodeArchiveUrl | String | 否 | 案例归档URL 示例值:https://common-job-packages-251233710.cos.ap-guangzhou.myqcloud.com/models/examples/example-001-ray-core-basics.zip |
| Image | String | 否 | 图片URL 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:3.0.0.dev0-py311-cpu-extra |
| LabImage | String | 否 | 实验室镜像地址 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:2.55.1-py311-cpu-lab |
| ResourceConfig | String | 否 | 资源配置 示例值:{"Head":{"Name":"default-head","PodCpu":4,"PodMem":2,"PodNum":1},"Worker":[{"Name":"default-worker","PodCpu":1,"PodMem":2,"MinPodNum":4,"MaxPodNum":4}]} |
| Category | String | 否 | 分类 示例值:generative-ai |
| Tags | Array of String | 否 | 标签 示例值:["Ray Data"] |
| Popularity | Integer | 否 | 案例热度 示例值:3 |
| Difficulty | String | 否 | 难度 示例值:advanced |
| EstimatedTime | Integer | 否 | 预估时间(分钟) 示例值:20 |
| SortOrder | Integer | 否 | 排序 示例值:5 |
| IsEnabled | Boolean | 否 | 是否启用 示例值:true |
| CreateTime | Integer | 否 | 创建时间 示例值:1779799361632 |
| UpdateTime | Integer | 否 | 更新时间 示例值:1779799361632 |
| Deleted | Integer | 否 | 是否删除 示例值:0 |
ExampleTag
案例标签返回值
被如下接口引用:ListExampleTags。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Tag | String | 否 | 案例标签名称 示例值:Ray Data |
| Count | Integer | 否 | 标签数量 示例值:2 |
Execution
SQL语句对象
被如下接口引用:CreateDatabase, CreateTable, GenerateCreateMangedTableSql, GenerateInternalTable。
| 名称 | 类型 | 描述 |
|---|---|---|
| SQL | String | 自动生成SQL语句。 示例值:CREATE DATABASE test;; |
FailedItem
绑定失败的条目.
被如下接口引用:BindApiKey。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ApiKeyId | String | 否 | apiKey的Id 示例值:apikey-migrated-00000005 |
| Reason | String | 否 | 失败原因 示例值:推理服务不存在: svc-20260615142836-tixi |
FavorInfo
FavorInfo
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Priority | Integer | 否 | 优先事项 示例值:2147483647 |
| Catalog | String | 否 | Catalog名称 示例值:DataLakeCatalog |
| DataBase | String | 否 | DataBase名称 示例值:dlc-db |
| Table | String | 否 | Table名称 示例值:dlc-table |
FileNode
文件/目录节点
被如下接口引用:GetModelFiles。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 文件/目录名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:README.md |
| Type | String | 否 | 节点类型:file 或 directory 注意:此字段可能返回 null,表示取不到有效值。 示例值:file |
| Size | Integer | 否 | 文件大小(字节),目录为 null 注意:此字段可能返回 null,表示取不到有效值。 示例值:6730 |
| Children | Array of FileNode | 否 | 子节点列表(仅目录有效) 注意:此字段可能返回 null,表示取不到有效值。 |
| LastModifyTime | Integer | 否 | 文件最后修改时间(毫秒时间戳) 单位:ms 示例值:1781008616000 |
Filter
筛选条件定义
被如下接口引用:DescribeDLCCatalogAccess, DescribeDataEngines, DescribeDataMaskStrategies, DescribeDatasourceConnection, DescribeEngineNetworks, DescribeNotebookSessions, DescribePartitionQueues, DescribePartitions, DescribeScripts, DescribeSparkAppJobs, DescribeSparkAppTasks, DescribeStandardEngineResourceGroupConfigInfo, DescribeStandardEngineResourceGroups, DescribeTables, DescribeTablesName, DescribeTaskList, DescribeTaskLog, DescribeTasks, DescribeTasksAnalysis, DescribeTasksCostInfo, DescribeTasksOverview, DescribeUserDataEngineConfig, DescribeUserInfo, DescribeUsers, DescribeViews, DescribeWorkGroupInfo, DescribeWorkGroups, GetLabPods, GetRayClusterPods, GetRayJobPods, ListApiKeys, ListBenchmarkSummary, ListBenchmarkTasks, ListClusterGroups, ListDeploymentReplicas, ListDeployments, ListInferenceEngines, ListInferenceModels, ListInferenceServices, ListJobSpecs, ListJobsBySpec, ListLabs, ListMlflowServerTrainingInstances, ListMlflowServers, ListModelVersions, ListRayClusterJobs, ListRayClusters, ListRayJobs, ListResourceConfigs, ListServiceApiKeys, ListTaskJobLogDetail, ListTrainingJobInstance, ListTrainingJobSpec, QueryDashboardServiceList, QueryTaskCostDetail。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 筛选字段名,对应实体属性名(驼峰命名) 示例值:status |
| Operator | String | 否 | 筛选操作符:EQ/NE/GT/GE/LT/LE/LIKE/IN,默认EQ 示例值:EQ |
| Values | Array of String | 否 | 筛选值列表,EQ/NE/GT/GE/LT/LE/LIKE取第一个值,IN使用完整列表 示例值:["dlc-engine"] |
FlowActivityDetail
流程活动详情
被如下接口引用:DescribeFlowDetailList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ActivityCode | String | 否 | 活动编码 示例值:CREATE_NAMESPACE |
| Status | Integer | 否 | 活动状态 示例值:1 |
| CreateTime | String | 否 | 创建时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:2026-01-15 10:30:00 |
| Duration | Integer | 否 | 耗时(秒) 注意:此字段可能返回 null,表示取不到有效值。 示例值:30 |
FlowDetail
流程详情
被如下接口引用:DescribeFlowDetailList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| FlowId | Integer | 否 | 流程ID(数据库主键) 示例值:1 |
| WorkFlowId | String | 否 | Temporal Workflow ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:workflow-abc123 |
| WorkFlowCode | String | 否 | 流程编码 示例值:CREATE_PARTITION |
| Progress | Integer | 否 | 流程进度,0~100 示例值:50 |
| Status | Integer | 否 | 流程状态 示例值:1 |
| CreateTime | String | 否 | 创建时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:2026-01-15 10:30:00 |
| Activities | Array of FlowActivityDetail | 否 | 流程活动列表 注意:此字段可能返回 null,表示取不到有效值。 |
FlowInfo
流程简要信息
被如下接口引用:DescribeFlowList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| FlowId | Integer | 否 | 流程ID 示例值:0 |
| WorkFlowCode | String | 否 | 流程编码 示例值:CREATE_PARTITION |
| Status | Integer | 否 | 流程状态 示例值:0 |
GPUInfo
GPU 机型
被如下接口引用:DescribeDataEngine, DescribeDataEngines。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| BillingItem | String | 否 | 计费项 示例值:sv_dlc_gpu_gn10xp_10cu_1v100_32g |
| Model | String | 否 | 机型 示例值:GN10P |
| CU | Integer | 否 | cu 示例值:16 |
| Type | String | 否 | gpu 机型 示例值:v100 |
| Num | Integer | 否 | 数量 示例值:1 |
| GPUMemory | Integer | 否 | 显存 示例值:16 |
| InstanceType | String | 否 | 机型 示例值:GN10Xp.2XLARGE40 |
| SaleStatus | Integer | 否 | 售卖情况(1-缺货,2-低库存,3-充足) |
GatewayInfo
网关基础信息,包括id,名称,规格和状态
被如下接口引用:DescribeEngineNetworks。
| 名称 | 类型 | 描述 |
|---|---|---|
| GatewayId | String | 网关ID, 注意:此字段可能返回 null,表示取不到有效值。 示例值:DataEngine-xxx |
| GatewayName | String | 网关名称,全局唯一 注意:此字段可能返回 null,表示取不到有效值。 示例值:default-gateway-1 |
| Size | Integer | 网关的规格 注意:此字段可能返回 null,表示取不到有效值。 示例值:2 |
| State | Integer | -2已删除 -1失败 0初始化中 1挂起 2运行中 3准备删除 4删除中 5挂起中 6启动中 7隔离中 8隔离 9续费中 10变配中 11冲正中 注意:此字段可能返回 null,表示取不到有效值。 示例值:网关状态 |
| PayMode | Integer | 计费模式 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| Mode | Integer | 模式 注意:此字段可能返回 null,表示取不到有效值。 示例值:2 |
GooseFSConfig
推理模型接入goosefs参数
被如下接口引用:CreateInferenceModel, CreateModelVersion。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ClusterId | String | 是 | goosefs集群id 示例值:g_cvm_ufw40z53 |
| GooseFSPath | String | 是 | goosefs命名空间名称 示例值:dlc-andrew-260200066 |
| MasterAddresses | Array of String | 是 | 主从节点信息 示例值:["["10.0.0.5:9200", "10.0.0.2:9200", "10.0.0.3:9200"]"] |
GpuSummaryItem
运行中部署的 GPU 资源汇总
被如下接口引用:GetInferenceService, ListInferenceServices。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| GpuType | String | 否 | GPU 型号 注意:此字段可能返回 null,表示取不到有效值。 示例值:T4 |
| GpuCount | Integer | 否 | GPU 总数(gpuNum × replicas) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| Replicas | Integer | 否 | 运行中的副本数 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
GroupInfo
数据脱敏用户组信息
被如下接口引用:CreateDataMaskStrategy, DescribeDataMaskStrategies, UpdateDataMaskStrategy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| WorkGroupId | Integer | 否 | 用户组ID 示例值:212123 |
| StrategyType | String | 否 | 策略类型 示例值:MASK_SHOW_FIRST_4; MASK_SHOW_LAST_4;MASK_HASH; MASK_DATE_SHOW_YEAR; MASK_NULL; MASK_DEFAULT 等 |
HeadSpecDTO
head组规格
被如下接口引用:CreateResourceConfig, DescribePostTrainingPreset, GetResourceConfig, ListResourceConfigs, UpdateResourceConfig。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | head/worker名称 示例值:default-head |
| PodCpu | Integer | 否 | Pod CPU核数 示例值:1 |
| PodMem | Integer | 否 | Pod 内存大小 示例值:2 |
| GpuType | String | 否 | GPU类型 示例值:GPU |
| GpuNum | Integer | 否 | GPU数量 示例值:0 |
| Envs | Array of Env | 否 | 环境变量列表 |
| Labels | Array of Label | 否 | 标签列表 |
| ResourcesLabels | Array of Label | 否 | 资源标签列表(用于追加到 headGroupSpec/workerGroupSpec 的 resources map 中,对应 Ray/K8s 的自定义资源声明),Value 必须为字符串形式的整数 |
| PodNum | Integer | 否 | Pod数量 示例值:1 |
| HighAvailability | Boolean | 否 | 是否支持高级可用 示例值:true |
| ResourceType | String | 否 | 资源类型,CPU,GPU 示例值:GPU |
| InstanceType | String | 否 | 机型 示例值:GN10Xp |
| Spec | Integer | 否 | 规格数量 示例值:1 |
| BillingItem | String | 否 | 资源ID(唯一) 示例值:sv_dlc_standard_cu_standard_cu |
HiveInfo
hive类型数据源的信息
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| MetaStoreUrl | String | 是 | hive metastore的地址 示例值:thrift://127.0.0.1:9083 |
| Type | String | 是 | hive数据源类型,代表数据储存的位置,COS或者HDFS 示例值:COS |
| Location | DatasourceConnectionLocation | 是 | 数据源所在的私有网络信息 |
| User | String | 否 | 如果类型为HDFS,需要传一个用户名 示例值:hadoop |
| HighAvailability | Boolean | 否 | 如果类型为HDFS,需要选择是否高可用 示例值:false |
| BucketUrl | String | 否 | 如果类型为COS,需要填写COS桶连接 示例值:cosn://bucketname/path |
| HdfsProperties | String | 否 | json字符串。如果类型为HDFS,需要填写该字段 示例值:fs.defaultFS=hdfs://ip:port |
| Mysql | MysqlInfo | 否 | Hive的元数据库信息 注意:此字段可能返回 null,表示取不到有效值。 |
| InstanceId | String | 否 | emr集群Id 注意:此字段可能返回 null,表示取不到有效值。 示例值:emr-adp0c9v8 |
| InstanceName | String | 否 | emr集群名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:testEmr |
| HiveVersion | String | 否 | EMR集群中hive组件的版本号 示例值:2.3.7 |
| KerberosInfo | KerberosInfo | 否 | Kerberos详细信息 注意:此字段可能返回 null,表示取不到有效值。 |
| KerberosEnable | Boolean | 否 | 是否开启Kerberos 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
HiveTablePartition
Hive表分区信息
被如下接口引用:DescribeTablePartitions。
| 名称 | 类型 | 描述 |
|---|---|---|
| Partition | String | 分区信息名称 示例值:pt=20240520 |
| Records | Integer | 分区记录数 示例值:1000 |
| DataFileStorage | Integer | 分区数据文件存储量 示例值:100 |
| CreateTime | String | 分区创建时间 示例值:2025-06-03T22:07:11.733+08:00 |
| ModifiedTime | String | 分区schema更新时间 示例值:2025-06-03T22:07:11.733+08:00 |
| LastAccessTime | String | 最后一次分区更新的访问时间 示例值:2025-06-03T22:07:11.733+08:00 |
HouseEventsInfo
集群事件日志
被如下接口引用:DescribeDataEngineEvents。
| 名称 | 类型 | 描述 |
|---|---|---|
| Time | Array of String | 事件时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:2025-01-16 13:18:45 |
| EventsAction | Array of String | 事件类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:["集群开始扩容"] |
| ClusterInfo | Array of String | 集群信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:["缩容前:集群个数1个,集群规模256CU,缩容后:集群个数0个,集群规模256CU"] |
IcebergTablePartition
Iceberg表分区信息
被如下接口引用:DescribeTablePartitions。
| 名称 | 类型 | 描述 |
|---|---|---|
| Partition | String | 分区信息名称 示例值:pt=20240520 |
| Records | Integer | 分区记录数 示例值:1000 |
| DataFileSize | Integer | 分区数据文件数量 示例值:100 |
| DataFileStorage | Integer | 分区数据文件存储量 示例值:100 |
| CreateTime | String | 分区创建时间 示例值:2025-06-03T22:07:11.733+08:00 |
| UpdateTime | String | 分区更新时间 示例值:2025-06-03T22:07:11.733+08:00 |
| LastUpdateSnapshotId | String | 最后一次分区更新的快照ID 示例值:2025-06-03T22:07:11.733+08:00 |
| Location | LocationInfo | 分区的location |
ImageDto
镜像响应类
被如下接口引用:ListImages。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | Integer | 否 | 镜像ID 示例值:6 |
| Name | String | 否 | 镜像名称 示例值:tcray-3.0.0.dev0-py311-cpu |
| Url | String | 否 | 镜像地址 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:3.0.0.dev0-py311-cpu |
| Description | String | 否 | 镜像描述 示例值:podman 测试镜像 |
| Type | String | 否 | 镜像类型(Ray/Workspace) 示例值:Workspace |
| RayVersion | String | 否 | 镜像内置的 Ray 版本号 示例值:3.0.0 |
| CreateTime | Integer | 否 | 创建时间 示例值:1772610372061 |
| UpdateTime | Integer | 否 | 更新时间 示例值:1773052310425 |
InferenceEngineInfo
推理引擎具体信息
被如下接口引用:DescribeModelEngines, ListInferenceEngines。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| EngineId | String | 否 | 引擎标识符 示例值:vllm |
| Name | String | 否 | 引擎名称 示例值:WeProduct |
| Version | String | 否 | 引擎版本 示例值:v1.0 |
| Description | String | 否 | 引擎描述 示例值:腾讯自研商品图像 Embedding 模型,仅支持图片输入,支持多维度输出(768/384/256/128/64),适用于商品图像检索场景 |
| Tags | Array of String | 否 | 标签列表 示例值:["图像检索"] |
| ModelTypes | Array of String | 否 | 支持的模型类型 示例值:["Embedding"] |
| Exclusive | Boolean | 否 | 是否独占,如果为 true,表示自定义模型看不到这个推理引擎,通常用于自研内置模型 示例值:true |
| Enabled | Boolean | 否 | 是否启用 示例值:true |
| Capabilities | EngineCapabilities | 否 | 引擎能力声明 |
InferenceModelInfo
推理模型信息
被如下接口引用:ListInferenceModels。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ModelId | String | 否 | Model ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:48 |
| ModelUid | String | 否 | 模型业务唯一标识 注意:此字段可能返回 null,表示取不到有效值。 示例值:m-xgboost-aaa-6a301c6f-17e6 |
| Name | String | 否 | 模型名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:xgboost_aaa |
| Provider | String | 否 | 模型提供方 注意:此字段可能返回 null,表示取不到有效值。 示例值:个人 |
| Description | String | 否 | 模型描述 注意:此字段可能返回 null,表示取不到有效值。 示例值:0.3BN0.3BN0.3BN0.3BN |
| ModelType | String | 否 | 模型类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:Reranker |
| SupportedEngines | Array of String | 否 | 支持的引擎 示例值:["vllm"] |
| ParameterSize | String | 否 | 参数量 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| Tags | Array of String | 否 | 模型标签 注意:此字段可能返回 null,表示取不到有效值。 示例值:["te=2"] |
| LatestVersion | String | 否 | 最新版本号 注意:此字段可能返回 null,表示取不到有效值。 示例值:3 |
| VersionCount | Integer | 否 | 版本总数 注意:此字段可能返回 null,表示取不到有效值。 示例值:7 |
| ServiceCount | Integer | 否 | 关联的推理服务数量 注意:此字段可能返回 null,表示取不到有效值。 示例值:2 |
| HasStorage | Boolean | 否 | 是否有存储(内置模型和用户上传模型均为 true) 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| StorageRegion | String | 否 | 存储地域 注意:此字段可能返回 null,表示取不到有效值。 示例值:ap-guangzhou |
| HasCustomStorage | Boolean | 否 | 是否使用用户自带存储桶 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| StorageType | String | 否 | 存储后端类型(如 COS、GOOSEFS、CFSTURBO) 注意:此字段可能返回 null,表示取不到有效值。 示例值:COS |
| BuiltIn | Boolean | 否 | 是否是内置模型 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| Tasks | Array of String | 否 | 任务类型列表 注意:此字段可能返回 null,表示取不到有效值。 示例值:["Rerank"] |
| AppId | Integer | 否 | 云账户的 APP ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:260200066 |
| Uin | String | 否 | 云账户的 UIN 注意:此字段可能返回 null,表示取不到有效值。 示例值:700002655694 |
| CreateTime | Integer | 否 | 创建时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1781537914533 |
| UpdateTime | Integer | 否 | 更新时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1781537937432 |
| SubAccountUin | String | 否 | 云账户的 Sub UIN 示例值:700002655694 |
| ResourceTags | Array of Tag | 否 | 系统标签列表(TagKey-TagValue) 注意:此字段可能返回 null,表示取不到有效值。 |
InferenceServiceInfo
推理服务信息
被如下接口引用:ListInferenceServices。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ServiceId | String | 否 | 服务ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:svc-20260610145259-6s6v |
| Name | String | 否 | 服务名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:m-qwen3-5-4b-6a223aba-951c-svczwc |
| ModelId | Integer | 否 | 关联的模型ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:2 |
| ModelUid | String | 否 | 关联的模型UID 注意:此字段可能返回 null,表示取不到有效值。 示例值:m-weclip-v2-base-6a223aba-d1fc |
| ModelName | String | 否 | 关联的模型名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:weclip-v2-base |
| ModelVersion | String | 否 | 关联的模型版本号 注意:此字段可能返回 null,表示取不到有效值。 示例值:2021-01-25 |
| ModelIdentifier | String | 否 | 模型标识符(OpenAI 兼容 API 中的 model 字段) 注意:此字段可能返回 null,表示取不到有效值。 示例值:m-qwen3-5-4b-6a223aba-951c-v12 |
| ModelType | String | 否 | 关联模型的类型(LLM / VLM / Embedding / Reranker / TTS / ASR / CV / NLP / ML) 注意:此字段可能返回 null,表示取不到有效值。 示例值:TimeSeries |
| Status | String | 否 | 服务状态(Running/Stopped/Deploying/Failed) 注意:此字段可能返回 null,表示取不到有效值。 示例值:Deploying |
| EndpointUrl | String | 否 | 服务端点URL 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://tcray-gateway.ap-guangzhou.cloud.tencent.com:443/service/m-qwen3-5-4b-6a223aba-951c-svczwc/v1 |
| UnifiedEndpointUrl | String | 否 | OpenAI 兼容统一入口 URL(通过 API-Key 路由,适用于 LLM/Embedding/Reranker) 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://tcray-gateway.ap-guangzhou.cloud.tencent.com:443/v1 |
| UnifiedV2EndpointUrl | String | 否 | KServe V2 协议统一入口 URL(通过 API-Key + model name 路由,适用于 XGBoost 等传统 ML 模型) 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://tcray-gateway.ap-guangzhou.cloud.tencent.com:443 |
| AppId | Integer | 否 | 应用ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:260200066 |
| Uin | String | 否 | 主账号UIN 注意:此字段可能返回 null,表示取不到有效值。 示例值:700002655694 |
| CreateTime | Integer | 否 | 创建时间(Unix 时间戳,毫秒) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1781074272540 |
| UpdateTime | Integer | 否 | 更新时间(Unix 时间戳,毫秒) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1781074380029 |
| DeploymentCount | Integer | 否 | 部署数量 注意:此字段可能返回 null,表示取不到有效值。 示例值:2 |
| HasRunningDeployment | Boolean | 否 | 是否存在至少一个运行中的部署 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| RayDashboardUrl | String | 否 | Ray Dashboard 访问地址(通过 Ingress 代理) 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://cls-p9d8s1gc.tcray-gateway.ap-guangzhou.cloud.tencent.com:443/dlc-p-jhzmcfna/rayserve-20260609212201-pu9o-f654t/ |
| ApiKeyAuthEnabled | Boolean | 否 | 是否启用 API-Key 鉴权 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| ApiKeyAuthForceEnabled | Boolean | 否 | 是否强制开启 API-Key 鉴权(生产环境为 true,不允许关闭) 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| SkipTlsVerify | Boolean | 否 | 是否跳过 TLS 证书验证(自签证书场景,前端 curl 命令需加 -k 参数) 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| GpuResourceSummary | Array of GpuSummaryItem | 否 | 运行中部署的 GPU 资源汇总 注意:此字段可能返回 null,表示取不到有效值。 |
| SubAccountUin | String | 否 | 子账号UIN(实际操作者) 示例值:700002655694 |
| CpuResourceSummary | CpuSummaryItem | 否 | 运行中部署的 CPU 资源汇总 |
| ResourceConfig | String | 否 | 资源配置(JSON 字符串,取自第一个部署) 示例值:{"workerBillingItem":"sv_dlc_standard_cu_standard_cu","workerSpec":2,"headBillingItem":"sv_dlc_standard_cu_standard_cu","headSpec":1,"gpu":"","gpuNum":0,"cpu":2,"mem":8,"headCpu":1,"headMem":4} |
IpPortPair
ip端口对信息
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Ip | String | 否 | ip信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:192...* |
| Port | Integer | 否 | 端口信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:8080 |
JobLogResult
日志详情
被如下接口引用:DescribeTaskLog, ListTaskJobLogDetail。
| 名称 | 类型 | 描述 |
|---|---|---|
| Time | Integer | 日志时间戳,毫秒 注意:此字段可能返回 null,表示取不到有效值。 示例值:1608794854001 |
| TopicId | String | 日志topic id 注意:此字段可能返回 null,表示取不到有效值。 示例值:topic-id-1 |
| TopicName | String | 日志topic name 注意:此字段可能返回 null,表示取不到有效值。 示例值:topic-name-1 |
| LogJson | String | 日志内容,json字符串 注意:此字段可能返回 null,表示取不到有效值。 示例值:25/01/16 16:13:06 INFO CosFileSystem: begin to close cos file system |
| PkgLogId | String | 日志ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:655368 |
JobPodEntity
任务Pod信息
被如下接口引用:GetRayJobPods。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| PodName | String | 否 | Pod名称 示例值:rayjob-20260323163852-huvy-8qd7h |
| PodIp | String | 否 | Pod IP 示例值:30.1.0.150 |
| Status | String | 否 | Pod状态 示例值:Running |
| Phase | String | 否 | Pod阶段 示例值:Running |
| NodeName | String | 否 | 所属节点 示例值:eklet-subnet-l8wxf43i-bd9cv4ef |
| NodeIp | String | 否 | 节点IP 示例值:169.254.128.2 |
| Namespace | String | 否 | 命名空间 示例值:dlc-p-ofvhyjzn |
| CpuRequest | String | 否 | CPU请求 示例值:1 |
| CpuLimit | String | 否 | CPU限制 示例值:1 |
| MemoryRequest | String | 否 | 内存请求 示例值:2Gi |
| MemoryLimit | String | 否 | 内存限制 示例值:2Gi |
| GpuCount | String | 否 | GPU数量 示例值:0 |
| Image | String | 否 | 容器镜像 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:3.0.0.dev0-py311-cpu |
| Role | String | 否 | Pod角色(head/worker) 示例值:worker |
| CreateTime | Integer | 否 | 创建时间 示例值:1774255590000 |
| StartTime | Integer | 否 | 启动时间 示例值:1774255660000 |
JobSpec
作业配置
被如下接口引用:ListJobSpecs。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | String | 否 | 配置ID 示例值:rayjobspec-tcfokp-9q08 |
| Name | String | 否 | 配置名称 示例值:rayjob-spec-6 |
| Description | String | 否 | 配置描述 示例值:rayjob-spec desc |
| Entrypoint | String | 否 | 入口命令 示例值:sleep 100 |
| Image | String | 否 | 镜像地址 示例值:ccr.ccs.tencentyun.com/tcray-xpark/xpark:0.0.0.dev0-ray2.54.0-py312-cpu |
| ImagePullType | String | 否 | 镜像拉取类型(Builtin: 内置, Custom: 自定义) 示例值:Builtin |
| ImagePullPolicy | String | 否 | 镜像拉取策略 示例值:Always |
| ResourceConfig | String | 否 | 资源配置(JSON) 示例值:{"Head":{"Name":"Head","PodCpu":1,"PodMem":2,"GpuType":"","GpuNum":0,"Envs":[],"Labels":[],"PodNum":1,"HighAvailability":false},"Worker":[{"Name":"Worker01","PodCpu":1,"PodMem":2,"GpuType":"","GpuNum":0,"Envs":[],"Labels":[],"MinPodNum":1,"MaxPodNum":1}]} |
| RuntimeEnv | String | 否 | 运行时环境配置(JSON) 示例值:{"py_modules":["/path/to/my_module","s3://bucket/my_lib.zip"],"working_dir":"https://common-job-packages-251233710.cos.ap-guangzhou.myqcloud.com/job-packages/260090589/20260324210556/b765a3a7-d630-46a5-bba3-866212d027d4.zip"} |
| Catalog | String | 否 | 存储卷和挂载卷配置(JSON) 示例值:{"COSVolumes":[{"Bucket":"turkey-cos-260090589","VolumeSubPath":"/","SubPathMode":"subPath","SubPath":"d","MountPath":"/data"}]} |
| AutoscalerOptions | String | 否 | 弹性伸缩配置(JSON) 示例值:{"upscalingMode":"Default","idleTimeoutSeconds":60,"resourceSpec":"small","resources":{"cpu":"500m","memory":"512Mi"}} |
| ResourceConfigId | String | 否 | ResourceConfigId 示例值:578827c9-887f-4f2c-8b16-dd366a264ee5 |
| ResourceConfigChanged | Boolean | 否 | 资源配置模板是否变更 示例值:true |
| ResourcePartitionId | String | 否 | 默认资源分区ID 示例值:auto-mock-dlc-p-003 |
| ResourcePartitionName | String | 否 | 默认资源分区名称 示例值:甘露-测试04 |
| Queue | String | 否 | 默认队列名称 示例值:default |
| GroupId | String | 否 | 集群组Id 示例值:rayclustergroup-tfbd8i-6mfm |
| ClusterId | String | 否 | 集群id 示例值:raycluster-20260526114515-qm44 |
| ClusterGroup | String | 否 | 默认计算组名称 示例值:rayCluster |
| JobPackage | String | 否 | 作业包URL 示例值:https://common-job-packages-251233710.cos.ap-guangzhou.myqcloud.com/job-packages/260090589/20260324210556/b765a3a7-d630-46a5-bba3-866212d027d4.zip |
| JobPackageName | String | 否 | 作业包名称 示例值:282.zip |
| Priority | Integer | 否 | 优先级 示例值:6 |
| AppId | Integer | 否 | 应用ID 示例值:260090589 |
| Uin | String | 否 | 创建者UIN 示例值:700002467852 |
| SubAccountUin | String | 否 | 子用户UIN 示例值:600000563453 |
| CreateTime | Integer | 否 | 创建时间 示例值:1774406185752 |
| UpdateTime | Integer | 否 | 更新时间 示例值:1774406396642 |
| JobInstanceCount | Integer | 否 | 该配置产生的作业实例数量 示例值:0 |
| HasRunningJobs | Boolean | 否 | 是否有运行中的作业实例 示例值:true |
| AdvancedOptions | String | 否 | 高级参数,JSON 字符串 示例值:{"spec.suspend":"false"} |
| Tags | Array of Tag | 否 | 标签列表(TagKey-TagValue),用于将资源与腾讯云标签系统中的标签绑定 |
| DispatchStrategy | String | 否 | 集群分派策略 示例值:RANDOM |
| SubmissionTarget | String | 否 | 作业提交目标:GROUP(按计算组分派)/ CLUSTER(指定集群)/ SERVERLESS(按 Serverless 拉起) 示例值:GROUP |
| GroupName | String | 否 | 集群组名称 示例值:group-mao |
| ClusterName | String | 否 | 集群名称 示例值:qzzhu |
JobStatusHistory
任务状态历史记录
被如下接口引用:GetRayJobHistory。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | Integer | 否 | 历史记录ID 示例值:665 |
| JobId | String | 否 | 作业ID 示例值:2036666366345482240 |
| JobName | String | 否 | 作业名称 示例值:rayjob-5k01-1772774904 |
| FromState | String | 否 | 源状态 示例值:RUNNING |
| ToState | String | 否 | 目标状态 示例值:SUCCEEDED |
| Event | String | 否 | 触发事件 示例值:SUCCESS |
| Message | String | 否 | 消息 示例值:RayJob CR not found in K8s after 3 consecutive checks (possibly manually deleted). Last message: RayJob not found in K8s |
| TransitionTime | Integer | 否 | 转换时间(毫秒时间戳) 示例值:1774419332256 |
KVPair
配置格式
被如下接口引用:AddDMSPartitions, AlterDMSDatabase, AlterDMSPartition, AlterDMSTable, CancelTasks, CreateDMSDatabase, CreateDMSTable, CreateExportTask, CreateImportTask, CreateNotebookSession, CreateNotebookSessionStatement, CreateSparkAppTask, CreateSparkSessionBatchSQL, CreateSparkSubmitTask, CreateTask, CreateTasks, CreateTasksInOrder, DescribeDMSDatabase, DescribeDMSPartitions, DescribeDMSTable, DescribeLakeFsInfo, DescribeNotebookSession, DescribeNotebookSessionStatement, DescribeSparkSessionBatchSqlLog, DropDMSTable, GetLabServiceUrls, ImportExternalCluster, ImportTkeCluster。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Key | String | 是 | 配置的key值 示例值:format-version |
| Value | String | 是 | 配置的value值 示例值:1 |
KafkaInfo
Kafka连接信息
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InstanceId | String | 是 | kafka实例Id 示例值:*** |
| Location | DatasourceConnectionLocation | 是 | kafka数据源的网络信息 示例值:{"VpcId":"vpc-***","VpcCidrBlock":"10.0.0.0/16","SubnetId":"subn |
KerberosInfo
Kerberos详细信息
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Krb5Conf | String | 否 | Krb5Conf文件值 示例值:文件内容 |
| KeyTab | String | 否 | KeyTab文件值 示例值:文件内容 |
| ServicePrincipal | String | 否 | 服务主体 示例值:Kerberos principa |
LabResponse
数据实验室
被如下接口引用:ListLabs。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ExampleId | String | 否 | 案例模板ID(startMode=EXAMPLE 时使用) 示例值:rayclustergroup-tfh4u6-bcqz |
| CodeArchiveUrl | String | 否 | 代码包/工程归档地址 示例值:https://common-job-packages.cos.ap-guangzhou.myqcloud.com/models/examples/ |
| Services | Array of TypeKVPair | 否 | 数据实验室服务入口(服务类型 -> 访问地址) |
| LabImage | String | 否 | Lab 镜像地址(必填,用于开发工具如 Jupyter/VSCode/WebShell)。前端在"内置 / 自定义"两态中选择此值;当 Image 字段未显式传入时,后端会基于该字段按 R1(镜像表命中)/R2(同值 fallback)派生 Ray 集群镜像。 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:2.55.1-py311-cpu-torch-lab |
| LabImagePullPolicy | String | 否 | Lab sidecar 镜像拉取策略(Always, IfNotPresent, Never) 示例值:Always |
| LabImagePullType | String | 否 | Lab sidecar 镜像拉取类型(BuiltIn: 内置, Custom: 自定义-TCR, CustomCcr: 自定义-CCR) 示例值:BuiltIn |
| Id | String | 否 | 集群ID 示例值:raylab-20260525224904-g6mm |
| Type | String | 否 | 资源类型:CLUSTER-普通集群;WORKSPACE-数据实验室(开发入口) 示例值:RAY_CLUSTER |
| Name | String | 否 | 集群名称 示例值:ray_core_basics_56tm |
| Description | String | 否 | 集群描述 示例值:测试测试测试 |
| ResourcePartitionId | String | 否 | 所属资源分区ID 示例值:dlc-p-bleurqnv |
| ResourcePartitionName | String | 否 | 默认资源分区名称 示例值:test_andrewmao |
| Queue | String | 否 | 所属队列名称 示例值:default |
| AppId | Integer | 否 | 应用ID 示例值:260200065 |
| Uin | String | 否 | 用户UIN 示例值:700002655693 |
| SubAccountUin | String | 否 | 子用户UIN 示例值:700002668129 |
| SubAccountName | String | 否 | 子用户名称(由聚合层通过 CAM 接口回填) 注意:此字段可能返回 null,表示取不到有效值。 示例值:700002744585 |
| Status | String | 否 | 集群状态 示例值:DELETED |
| StatusMessage | String | 否 | 状态详情/错误信息 示例值:Cluster startup timed out af |
| CreateTime | Integer | 否 | 创建时间 示例值:1779720544298 |
| GroupName | String | 否 | 所属集群组名称 示例值:group_test_sunny |
| GroupId | String | 否 | 计算组 ID 示例值:rayclustergroup-tfh4u6-bcqz |
| ResourceConfig | String | 否 | 资源配置(JSON) 示例值:{"Head":{"Name":"default- |
| ResourceConfigId | String | 否 | 资源配置ID 示例值:11 |
| RuntimeEnv | String | 否 | 运行时环境配置(JSON) 示例值:{ "nsight": "default" } |
| Image | String | 否 | Ray 集群镜像地址(可选,OpenAPI/SDK 高级控制入口)。前端不再传递此字段;为空时后端按 R1(镜像表查询命中)→ R2(同值 fallback)顺序自动派生。非空时直接作为 Ray 集群镜像,跳过派生(EXPLICIT),且后端不校验其与 LabImage 的兼容性。 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:2.55.1-py311-cpu-torch-lab |
| Catalog | String | 否 | 存储卷和挂载卷配置(JSON) 示例值:{"CFSVolumes":[],"CFSTurboVolumes":[],"COSVolumes":[],"GooseFSVolumes":null} |
| HistoryUrl | String | 否 | Dashboard URL / 历史记录链接 示例值:https://test-tcray-historyserver-guangzhou.cloud.tencent.com/history/dlc-p-bleurqnv/raylab-20260602160218-eyem/ |
| ImagePullPolicy | String | 否 | 镜像拉取策略 示例值:Always |
| ImagePullType | String | 否 | 镜像拉取类型(BuiltIn: 内置, Custom: 自定义-TCR, CustomCcr: 自定义-CCR) 示例值:BuiltIn |
| AdvancedOptions | String | 否 | 高级参数(扁平 Key-Value 的 JSON 字符串),Key 以 spec. 开头,按 RayCluster CRD 下钻;详见 ADVANCED_CLUSTER_OPTIONS_DESIGN.md 示例值:{"spec.headGroupSpec.rayStartParams.dashboard-host":"0.0.0.0"} |
| Priority | Integer | 否 | 优先级(1-9,数字越大优先级越高) 示例值:2 |
| StartTime | Integer | 否 | 启动时间(最近一次启动) 示例值:1779720547646 |
| StopTime | Integer | 否 | 停止时间(最近一次停止/休眠) 示例值:1779776943779 |
| DeleteTime | Integer | 否 | 删除时间 示例值:1779967713705 |
| Tags | Array of Tag | 否 | 标签列表(TagKey-TagValue) |
| PersistentWorkDir | PersistentWorkDir | 否 | 持久化工作目录配置(可选)。启用后将 COS/CFS 指定路径挂载到容器内 /workspace 工作目录,与现有 Catalog 的卷配置互斥(不允许同时在 Catalog 中显式声明 MountPath=/workspace)。 |
| EnableToken | Boolean | 否 | 是否开启token认证 示例值:true |
| Token | String | 否 | Token 认证密钥(开启 token 认证时由系统生成) 示例值:4a8814e5ff70429e82ac5e2f7f3d0ec6 |
Label
节点标签模型
被如下接口引用:CreateResourceConfig, GetResourceConfig, UpdateResourceConfig。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 名称 示例值:1 |
| Value | String | 否 | 值 示例值:2 |
LakeFileSystemToken
LakeFileSystem使用的临时token
被如下接口引用:DescribeLakeFsTaskResult。
| 名称 | 类型 | 描述 |
|---|---|---|
| SecretId | String | Token使用的临时密钥的ID 示例值:test_id |
| SecretKey | String | Token使用的临时密钥 示例值:test_key |
| Token | String | Token信息 示例值:test_token |
| ExpiredTime | Integer | 过期时间 示例值:1737016166 |
| IssueTime | Integer | 颁布时间 示例值:1737014366 |
LakeFsInfo
描述DLC托管存储基本信息
被如下接口引用:DescribeLakeFsInfo。
| 名称 | 类型 | 描述 |
|---|---|---|
| Name | String | 托管存储名称 示例值:dlc_bkt |
| Type | String | 托管存储类型 示例值:user_chdfs |
| SpaceUsedSize | Float | 存储用量 示例值:1.0 |
| CreateTimeStamp | Integer | 创建时候的时间戳 示例值:1 |
| DefaultBucket | Integer | 是否是用户默认桶,0:默认桶,1:非默认桶 示例值:0 |
| ShortName | String | 托管存储short name 示例值:DLC-Storage-123456 |
| Description | String | 桶描述信息 示例值:test bucket |
| Status | String | 托管桶状态,当前取值为:creating、bind、readOnly、isolate 示例值:creating |
| TagList | Array of TagInfo | 托管存储桶标签列表 |
| MultiAZ | Boolean | 是否是多AZ存储桶 示例值:false |
| Configuration | Array of KVPair | 存储桶配置信息 |
LbItem
负载均衡条目(字段严格对齐 CLB DescribeLoadBalancers)
被如下接口引用:ListRegionLbs。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| LoadBalancerId | String | 否 | 负载均衡实例 ID,例如 lb-xxxxxxxx 示例值:lb-xxxxxxxx |
| LoadBalancerName | String | 否 | 负载均衡实例名称 示例值:my-lb |
| LoadBalancerType | String | 否 | 网络类型:OPEN=公网属性;INTERNAL=内网属性 示例值:OPEN |
LinkedServiceInfo
关联的推理服务信息
被如下接口引用:CreateModelVersion, ListModelVersions。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ServiceId | String | 否 | 服务 UID 示例值:svc-20260615233939-ayda |
| ServiceName | String | 否 | 服务名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:m-xgboost-aaa-bbb |
LocationInfo
Location信息结构
被如下接口引用:DescribeTablePartitions。
| 名称 | 类型 | 描述 |
|---|---|---|
| Bucket | String | 桶名称 示例值:my_tb |
| DataLocation | String | location路径 示例值:my_tb/data |
LockComponentInfo
元数据加锁内容
被如下接口引用:LockMetaData。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DbName | String | 是 | 数据库名称 示例值:db |
| TableName | String | 否 | 表名称 示例值:table |
| Partition | String | 否 | 分区 示例值:part |
| LockType | String | 否 | 锁类型:SHARED_READ、SHARED_WRITE、EXCLUSIVE 示例值:SHARED_READ |
| LockLevel | String | 否 | 锁级别:DB、TABLE、PARTITION 示例值:DB |
| DataOperationType | String | 否 | 锁操作:SELECT,INSERT,UPDATE,DELETE,UNSET,NO_TXN 示例值:SELECT |
| IsAcid | Boolean | 否 | 是否保持Acid 示例值:false |
| IsDynamicPartitionWrite | Boolean | 否 | 是否动态分区写 示例值:false |
MCPTaskInfo
mcp 请求任务详情的返回
被如下接口引用:DescribeMCPTask。
| 名称 | 类型 | 描述 |
|---|---|---|
| Id | String | 任务 ID 示例值:11 |
| BatchId | String | BatchId 示例值:batch-1234567890 |
| State | Integer | 状态 示例值:2 |
| TaskType | String | 任务类型 示例值:SQLTask |
| TaskKind | String | 任务类型 示例值:SQLTask |
| EngineTypeDetail | String | 引擎详情 示例值:SparkSQL |
| SQLType | String | SQL 类型 示例值:DQL |
| SQL | String | SQL 示例值:SELECT * FROM db.table LIMIT 10 |
| IsSQLCutOff | Boolean | 是否截断 示例值:true |
| DatabaseName | String | 数据库名称 示例值:mock_database |
| DataEngineId | String | 引擎 ID 示例值:DataEngine-mock-001 |
| ResourceGroupName | String | 资源组名称 示例值:mock_resource_group |
| SparkJobId | String | JobId 示例值:spark-job-mock-001 |
| SparkJobName | String | Job 名称 示例值:mock_spark_job |
| OperateUin | String | 操作人 Uin 示例值:100000000001 |
| CreateTime | String | 创建时间 示例值:2026-07-16 10:00:00 |
| StartTime | String | 开始时间 示例值:2026-07-16 10:00:01 |
| EndTime | String | 结束时间 示例值:2026-07-16 10:00:10 |
| UpdateTime | String | 更新时间 示例值:2026-07-16 10:00:10 |
| UsedTime | Integer | 引擎耗时 单位:毫秒 示例值:9000 |
| TotalTime | Integer | 执行总耗时 单位:毫秒 示例值:9500 |
| Progress | Integer | 进度 示例值:100 |
| OutputMessage | String | 输出信息 示例值:Mock task completed successfully |
| DataSet | String | 结果集 示例值:[["col1","col2"],["value1","value2"]] |
MCPTaskResultInfo
MCP 任务结果返回
被如下接口引用:DescribeMCPTaskResult。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| TaskId | String | 否 | 任务 ID 示例值:dj210j1-1j2idj |
| State | Integer | 否 | 状态 示例值:2 |
| ResultSchema | Array of Column | 否 | 结果集 Schema |
| ResultSet | String | 否 | 结果集 示例值:[["value1","value2"],["value3","value4"]] |
| NextToken | String | 否 | 是否还有其他结果 示例值:1 |
| RowAffectInfo | String | 否 | 影响行数 示例值:2 |
| OutputMessage | String | 否 | 输出信息 示例值:Mock result query completed |
| DisplayFormat | String | 否 | 展示 format 示例值:table |
| CanDownload | Boolean | 否 | 能否下载 示例值:true |
| QueryResultTime | Float | 否 | 结果花费时间 单位:毫秒 示例值:123.45 |
| IsResultOversize | Boolean | 否 | 是否超大 示例值:true |
MessageItem
校验消息项
被如下接口引用:CheckModifyPartition。
| 名称 | 类型 | 描述 |
|---|---|---|
| BillingItem | String | 计费项标识 示例值:sv_dlc_standard_cu_standard_cu |
| Message | String | 校验失败描述信息 示例值:[标准CU]缩容需要释放20,但default队列仅有min=10可释放,不足10 |
MetaDatabaseInfo
元数据库基本信息
被如下接口引用:CreateMetaDatabase。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DatabaseName | String | 是 | 数据库名称。 示例值:database1 |
| Comment | String | 否 | 数据库描述信息,长度 0~2048。 注意:此字段可能返回 null,表示取不到有效值。 示例值:create by zhangsan |
MetricItem
原始指标键值对
被如下接口引用:DescribeTrainingCheckpoints。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Key | String | 否 | 指标名 示例值:train_loss |
| Value | String | 否 | 指标值(字符串形式) 示例值:4.4762928821879795E-6 |
MetricsData
监控指标数据
被如下接口引用:QueryDashboardServiceList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| RequestsPerSecond | Float | 否 | 每秒请求数(QPS) 示例值:0 |
| ErrorRate | Float | 否 | 错误率(0~1) 示例值:0 |
| P95LatencyMs | Float | 否 | P95 延迟(毫秒) 示例值:0 |
| P99LatencyMs | Float | 否 | P99 延迟(毫秒) 示例值:0 |
| QueueDepth | Float | 否 | 队列深度(排队中的请求数) 示例值:0 |
| TimeToFirstTokenP99Ms | Float | 否 | TTFT P99 延迟(毫秒,仅 vLLM) 示例值:0 |
| TimePerOutputTokenP99Ms | Float | 否 | TPOT P99 延迟(毫秒,仅 vLLM) 示例值:0 |
| TokenThroughput | Float | 否 | Token 吞吐量(tokens/s,仅 vLLM) 示例值:0 |
| GpuUtilization | Float | 否 | GPU 利用率(0~100,百分比) 示例值:0 |
| GpuMemoryUsedMB | Float | 否 | GPU 显存已用(MB) 示例值:0 |
| GpuMemoryTotalMB | Float | 否 | GPU 显存总量(MB) 示例值:0 |
| CpuUtilization | Float | 否 | CPU 利用率(0~100,百分比) 示例值:5.85 |
| MemoryUsedBytes | Float | 否 | 内存已用(字节) 示例值:339243008 |
| MemoryTotalBytes | Float | 否 | 内存总量(字节) 示例值:4294967296 |
| NetworkReceiveMBPerSecond | Float | 否 | 网络接收速度(MB/s) 示例值:0.000652536193076531 |
| NetworkSendMBPerSecond | Float | 否 | 网络发送速度(MB/s) 示例值:0.0033786183012526174 |
MixedTablePartitions
DLC分区信息查询返回数据结构
被如下接口引用:DescribeTablePartitions。
| 名称 | 类型 | 描述 |
|---|---|---|
| TableFormat | String | 数据表格式 示例值:ICEBERG |
| TotalSize | Integer | 分区总数 示例值:100 |
| NextCursor | String | 分页查询的游标信息,在获取下一页信息时需要回传到服务端 示例值:pt=name |
| IcebergPartitions | Array of IcebergTablePartition | iceberg表分区信息 |
| HivePartitions | Array of HiveTablePartition | hive表分区信息 |
MlFlowConfig
MLFlow 实验追踪配置
被如下接口引用:ModifyTrainingJobSpec, SubmitTrainingJob。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| MlFlowMode | String | 否 | MlFlow 追踪模式:local=MlFlow Sidecar / remote=已有 MlFlow Server / none=不启用 示例值:remote |
| MlFlowServerId | String | 否 | 已有MlFlow Server 的 ID(仅 mlFlowMode=remote 时填写,前端下拉选择后传入) 示例值:mlflow-4d55fe42 |
| MlFlowCosPath | String | 否 | MlFlow Sidecar 持久化存储的 COS 路径(仅 mlFlowMode=local 时填写) 示例值:/mlflow/experiments |
MlFlowResourceConfig
资源配置(规格模式 BillingItem+Spec,或手动模式 PodCpu+PodMem,二选一)。" + "未传时使用默认值(4C8G)
被如下接口引用:CreateMlflowServer。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| BillingItem | String | 否 | 资源 ID(规格模式必填) 示例值:sv_dlc_standard_cu_standard_cu |
| Spec | Integer | 否 | 购买份数(规格模式必填,每 Pod 的规格倍数) 示例值:2 |
| PodCpu | Integer | 否 | pod CPU 核数(手动模式必填,单 Pod 粒度) 示例值:2 |
| PodMem | Integer | 否 | pod 内存大小 GB(手动模式必填,单 Pod 粒度) 示例值:8 |
MlFlowServerInfo
MlFlow Server 业务信息
被如下接口引用:CreateMlflowServer, DescribeMlflowServer, ListMlflowServers, StartMlflowServer。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ServerId | String | 否 | MLflow 实例的 ID 示例值:mlflow-ce4b7f14 |
| ServerName | String | 否 | 实例名称 示例值:test_mlflow_1 |
| ResourcePartitionId | String | 否 | 资源分区 ID 示例值:dlc-p-pcpjozsy |
| ResourcePartitionName | String | 否 | 资源包名 示例值:cpu-pool-test |
| Queue | String | 否 | 资源组(逻辑队列名,可选) 示例值:default |
| TrackingUri | String | 否 | 集群内MLflow访问地址。用于训练作业上报 metrics 示例值:http://mlflow-ce4b7f14-mlflow-svc.dlc-p-pcpjozsy.svc.cluster.local:5000 |
| UiUrl | String | 否 | 集群外访问地址(Ingress URL) 示例值:https://cls-p9d8s1gc.tcray-gateway.ap-guangzhou.cloud.tencent.com/mlflow/mlflow-ce4b7f14/ |
| Status | String | 否 | 状态:CREATED / CREATING / RUNNING / FAILED / STOPPED 枚举值:
示例值:CREATING |
| ErrorMessage | String | 否 | 仅失败时展示错误信息 示例值:error msg test |
| Image | String | 否 | MLflow 镜像地址 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:2.55.1-py311-cpu |
| StorageConfig | String | 否 | 存储配置 JSON,具体结构按 storageMode 解释(cos / cfs / local) 示例值:{"fileSystemId":"cfs-99dt0xbn","path":""} |
| StorageMode | String | 否 | 存储模式 枚举值:
示例值:cos |
| AppId | Integer | 否 | 应用 ID 示例值:260200065 |
| Uin | String | 否 | 创建者 UIN 示例值:700002655693 |
| CreateTime | Integer | 否 | 创建时间(epoch 毫秒) 单位:毫秒 示例值:1786446930117 |
| UpdateTime | Integer | 否 | 更新时间(epoch 毫秒) 单位:毫秒 示例值:1786446930117 |
| ResourceConfig | String | 否 | 资源配置 JSON 示例值:{"PodCpu":2,"PodMem":4} |
| Tags | Array of Tag | 否 | 标签列表(TagKey-TagValue) 注意:此字段可能返回 null,表示取不到有效值。 |
ModelVersionInfo
模型版本信息
被如下接口引用:ListModelVersions。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| VersionId | String | 否 | 版本ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:90 |
| ModelId | String | 否 | 关联的模型ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:68 |
| Version | String | 否 | 版本号(如 v1, v2) 注意:此字段可能返回 null,表示取不到有效值。 示例值:v4 |
| StorageUri | String | 否 | 该版本的存储 URI 注意:此字段可能返回 null,表示取不到有效值。 示例值:common-job-packages-251233710.cos.ap-guangzhou.myqcloud.com/models/m-generatemodeluid-6a3109a3-f09c/v1/ |
| Description | String | 否 | 版本说明 注意:此字段可能返回 null,表示取不到有效值。 示例值:test model, 7B |
| CreateTime | Integer | 否 | 创建时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1781598645959 |
| UpdateTime | Integer | 否 | 更新时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1781598645959 |
| LinkedServices | Array of LinkedServiceInfo | 否 | 关联的推理服务列表 注意:此字段可能返回 null,表示取不到有效值。 |
| UseCustomStorage | Boolean | 否 | 是否使用用户自带存储桶(true=用户自带桶,false=平台托管) 示例值:true |
MountPointAssociates
绑定融合桶信息
被如下接口引用:CreateCHDFSBindingProduct。
| 名称 | 类型 | 描述 |
|---|---|---|
| BucketId | String | 桶Id 示例值:dlc-**** |
| VpcId | String | vpcId 示例值:vpc-hbaksjzx |
| VpcCidrBlock | String | 子网地址 示例值:10.0.0.0/24 |
| AccessGroupId | String | 权限组Id 示例值:ag-dlcagid |
| AccessRuleId | Integer | 权限规则Id 示例值:1855 |
MysqlInfo
Mysql类型数据源信息
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| JdbcUrl | String | 是 | 连接mysql的jdbc url 示例值:jdbc:mysql://ip:port |
| User | String | 是 | 用户名 示例值:root |
| Password | String | 是 | mysql密码 示例值:** |
| Location | DatasourceConnectionLocation | 是 | mysql数据源的网络信息 |
| DbName | String | 否 | 数据库名称 示例值:MetaDb |
| InstanceId | String | 否 | 数据库实例ID,和数据库侧保持一致 注意:此字段可能返回 null,表示取不到有效值。 示例值:cdb-xxxxx |
| InstanceName | String | 否 | 数据库实例名称,和数据库侧保持一致 注意:此字段可能返回 null,表示取不到有效值。 示例值:mySql |
NetWork
网络配置信息
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ClbIp | String | 否 | 服务clbip 示例值:127.0.0.1 |
| ClbPort | String | 否 | 服务clbPort 示例值:11808 |
| VpcId | String | 否 | vpc实例id 示例值:vpc-test |
| VpcCidrBlock | String | 否 | vpc网段 示例值:10.0.0.1/12 |
| SubnetId | String | 否 | 子网实例id 示例值:subnet-test |
| SubnetCidrBlock | String | 否 | 子网网段 示例值:10.0.0.1/24 |
NetworkConnection
网络配置
被如下接口引用:DescribeDataEngine, DescribeDataEngines, DescribeDatasourceConnection, DescribeNetworkConnections。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | Integer | 否 | 网络配置id 示例值:89876 |
| AssociateId | String | 否 | 网络配置唯一标志符 示例值:e7b3c1f2---- |
| HouseId | String | 否 | 计算引擎id 示例值:DataEngine-0dxxxxbk2 |
| DatasourceConnectionId | String | 否 | 数据源id(已废弃) |
| State | Integer | 否 | 网络配置状态(0-初始化,1-正常) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| CreateTime | Integer | 否 | 创建时间 示例值:1732278163 |
| UpdateTime | Integer | 否 | 修改时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:1732278165 |
| Appid | Integer | 否 | 创建用户Appid 注意:此字段可能返回 null,表示取不到有效值。 示例值:131****187 |
| HouseName | String | 否 | 计算引擎名称 示例值:dlc-saprk |
| DatasourceConnectionName | String | 否 | 网络配置名称 示例值:net_dlc-saprk |
| NetworkConnectionType | Integer | 否 | 网络配置类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:4 |
| Uin | String | 否 | 创建用户uin 注意:此字段可能返回 null,表示取不到有效值。 示例值:1000****1843 |
| SubAccountUin | String | 否 | 创建用户SubAccountUin 注意:此字段可能返回 null,表示取不到有效值。 示例值:1000****2111 |
| NetworkConnectionDesc | String | 否 | 网络配置描述 注意:此字段可能返回 null,表示取不到有效值。 示例值:网络配置 |
| DatasourceConnectionVpcId | String | 否 | 数据源vpcid 注意:此字段可能返回 null,表示取不到有效值。 示例值:vpc-nmxxxx |
| DatasourceConnectionSubnetId | String | 否 | 数据源SubnetId 注意:此字段可能返回 null,表示取不到有效值。 示例值:subnet-5roxxxxn |
| DatasourceConnectionCidrBlock | String | 否 | 数据源SubnetId 注意:此字段可能返回 null,表示取不到有效值。 示例值:10.0.0.0/16 |
| DatasourceConnectionSubnetCidrBlock | String | 否 | 数据源SubnetCidrBlock 注意:此字段可能返回 null,表示取不到有效值。 示例值:10.../ |
| EGSupport | Integer | 否 | 支持 eg 示例值:1 |
NotebookSessionInfo
Notebook Session详细信息。
被如下接口引用:DescribeNotebookSession。
| 名称 | 类型 | 描述 |
|---|---|---|
| Name | String | Session名称 示例值:session1 |
| Kind | String | 类型,当前支持:spark、pyspark、sparkr、sql 示例值:spark |
| DataEngineName | String | DLC Spark作业引擎名称 示例值:data_engine_1 |
| Arguments | Array of KVPair | Session相关配置,当前支持:eni、roleArn以及用户指定的配置 注意:此字段可能返回 null,表示取不到有效值。 |
| ProgramDependentFiles | Array of String | 运行程序地址,当前支持:cosn://和lakefs://两种路径 注意:此字段可能返回 null,表示取不到有效值。 示例值:["cosn://xxx"] |
| ProgramDependentJars | Array of String | 依赖的jar程序地址,当前支持:cosn://和lakefs://两种路径 注意:此字段可能返回 null,表示取不到有效值。 示例值:["cosn://xxx"] |
| ProgramDependentPython | Array of String | 依赖的python程序地址,当前支持:cosn://和lakefs://两种路径 注意:此字段可能返回 null,表示取不到有效值。 示例值:["cosn://xxx"] |
| ProgramArchives | Array of String | 依赖的pyspark虚拟环境地址,当前支持:cosn://和lakefs://两种路径 注意:此字段可能返回 null,表示取不到有效值。 示例值:["cosn://xxx"] |
| DriverSize | String | 指定的Driver规格,当前支持:small(默认,1cu)、medium(2cu)、large(4cu)、xlarge(8cu) 示例值:small |
| ExecutorSize | String | 指定的Executor规格,当前支持:small(默认,1cu)、medium(2cu)、large(4cu)、xlarge(8cu) 示例值:small |
| ExecutorNumbers | Integer | 指定的Executor数量,默认为1 示例值:1 |
| ProxyUser | String | 代理用户,默认为root 示例值:root |
| TimeoutInSecond | Integer | 指定的Session超时时间,单位秒,默认3600秒 示例值:3600 |
| SparkAppId | String | Spark任务返回的AppId 示例值:spark-123 |
| SessionId | String | Session唯一标识 示例值:d3018ad4-9a7e-4f64-a3f4-f38507c69742 |
| State | String | Session状态,包含:not_started(未启动)、starting(已启动)、idle(等待输入)、busy(正在运行statement)、shutting_down(停止)、error(异常)、dead(已退出)、killed(被杀死)、success(正常停止) 示例值:not_started |
| CreateTime | String | Session创建时间 示例值:2006-01-02 15:04:05 |
| AppInfo | Array of KVPair | 其它信息 注意:此字段可能返回 null,表示取不到有效值。 |
| SparkUiUrl | String | Spark ui地址 示例值:http://xxx |
| ExecutorMaxNumbers | Integer | 指定的Executor数量(最大值),默认为1,当开启动态分配有效,若未开启,则该值等于ExecutorNumbers 示例值:1 |
| SessionType | String | session类型,group:资源组下session independent:独立资源session, 不依赖资源组 示例值:group |
| DataEngineId | String | 引擎id 示例值:dataengine-xxx |
| ResourceGroupId | String | 资源组id 示例值:rg-xxx |
| ResourceGroupName | String | 资源组名称 示例值:rg-xxx |
| PodSize | Integer | session,pod大小 示例值:16 |
| PodNumbers | Integer | pod数量 示例值:1 |
| SparkAppName | String | spark app名称 示例值:sparkapp_2026-03-13_12-01-21 |
NotebookSessionStatementBatchInformation
按批提交Statement运行SQL任务。
被如下接口引用:CreateNotebookSessionStatementSupportBatchSQL, DescribeNotebookSessionStatements。
| 名称 | 类型 | 描述 |
|---|---|---|
| NotebookSessionStatementBatch | Array of NotebookSessionStatementInfo | 任务详情列表 注意:此字段可能返回 null,表示取不到有效值。 示例值:复杂类型 |
| IsAvailable | Boolean | 当前批任务是否运行完成 示例值:true |
| SessionId | String | Session唯一标识 示例值:d3018ad4-9a7e-4f64-a3f4-f38507c69742 |
| BatchId | String | Batch唯一标识 注意:此字段可能返回 null,表示取不到有效值。 示例值:skdelad4-9a7e-4f64-a3f4-f38507c69742 |
NotebookSessionStatementInfo
NotebookSessionStatement详情。
被如下接口引用:CreateNotebookSessionStatement, CreateNotebookSessionStatementSupportBatchSQL, DescribeNotebookSessionStatement, DescribeNotebookSessionStatements。
| 名称 | 类型 | 描述 |
|---|---|---|
| Completed | Integer | 完成时间戳 示例值:1662635695652 |
| Started | Integer | 开始时间戳 示例值:1662635695652 |
| Progress | Float | 完成进度,百分制 示例值:100 |
| StatementId | String | Session Statement唯一标识 示例值:d3018ad4-9a7e-4f64-a3dj-f38507c697dj |
| State | String | Session Statement状态,包含:waiting(排队中)、running(运行中)、available(正常)、error(异常)、cancelling(取消中)、cancelled(已取消) 示例值:running |
| OutPut | StatementOutput | Statement输出信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:复杂类型 |
| BatchId | String | 批任务id 示例值:dks18ad4-9a7e-4f64-a3dj-f38507c697dj |
| Code | String | 运行语句 示例值:select 1; |
| TaskId | String | 任务ID 示例值:dks18ad4-9a7e-4f64-a3dj-f38507c697dj |
NotebookSessions
notebook session列表信息。
被如下接口引用:DescribeNotebookSessions。
| 名称 | 类型 | 描述 |
|---|---|---|
| Kind | String | 类型,当前支持:spark、pyspark、sparkr、sql 示例值:spark |
| SessionId | String | Session唯一标识 示例值:d3018ad4-9a7e-4f64-a3f4-f38507c69742 |
| ProxyUser | String | 代理用户,默认为root 示例值:root |
| State | String | Session状态,包含:not_started(未启动)、starting(已启动)、idle(等待输入)、busy(正在运行statement)、shutting_down(停止)、error(异常)、dead(已退出)、killed(被杀死)、success(正常停止) 示例值:not_started |
| SparkAppId | String | Spark任务返回的AppId 示例值:spark-123 |
| Name | String | Session名称 示例值:session1 |
| CreateTime | String | Session创建时间 示例值:2006-01-02 15:04:05 |
| DataEngineName | String | 引擎名称 示例值:data_engine_1 |
| LastRunningTime | String | 最新的运行时间 示例值:2006-01-02 15:04:05 |
| Creator | String | 创建者 示例值:1000****040 |
| SparkUiUrl | String | spark ui地址 示例值:http://xxx |
| SessionType | String | session类型,group:资源组session independent:独立资源session,不依赖资源组 示例值:group |
| DataEngineId | String | 引擎id 示例值:dataengine-xxx |
| ResourceGroupId | String | 资源组id 示例值:rg-xxx |
| ResourceGroupName | String | 资源组名字 示例值:rg-xxx |
| KernelId | String | Kernel id 示例值:d4bb0573-ccfa-4bc4-9a7e-67f989c5226b |
| SparkAppName | String | spark app名称 示例值:sparkapp_2026-03-13_12-01-21 |
OpendThirdAccessUserInfo
开通了第三方访问的用户信息
被如下接口引用:DescribeThirdPartyAccessUser。
| 名称 | 类型 | 描述 |
|---|---|---|
| Id | Integer | id信息 示例值:5 |
| Uin | String | 用户主UIN 示例值:130****831 |
| AppId | String | 用户AppId 示例值:1000****6626 |
| CreateTime | String | 开通时间 示例值:2024-10-18T15:29:36+08:00 |
OperateEngineResourceGroupFailMessage
操作资源组,返回的操作失败信息
被如下接口引用:LaunchStandardEngineResourceGroups, PauseStandardEngineResourceGroups。
| 名称 | 类型 | 描述 |
|---|---|---|
| EngineResourceGroupName | String | 引擎资源组名称 |
| FailMessage | String | 操作失败的提示信息 |
OptimizerEngineInfo
数据优化引擎信息
被如下接口引用:AddOptimizerEngines。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| HouseName | String | 是 | 引擎资源名称 示例值:test_engine |
| HouseId | String | 是 | 引擎资源ID 示例值:DataEngine-123456 |
| HouseSize | Integer | 否 | 该参数仅针对spark作业引擎有效,用于执行数据优化任务的资源大小,不填时将采用该引擎所有资源 注意:此字段可能返回 null,表示取不到有效值。 示例值:36 |
Other
数据格式其它类型。
被如下接口引用:CreateTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Format | String | 否 | 枚举类型,默认值为Json,可选值为[Json, Parquet, ORC, AVRD]之一。 示例值:Json |
OtherCHDFSBinding
非DLC产品CHDFS绑定
被如下接口引用:DescribeOtherCHDFSBindingList。
| 名称 | 类型 | 描述 |
|---|---|---|
| ProductName | String | 产品名称 示例值:dlc |
| SuperUser | Array of String | 用户名称(该字段已废弃) 示例值:root |
| VpcInfo | Array of CHDFSProductVpcInfo | vpc配置信息 示例值:[{"VpcId":"id", "VpcName":"name", "VpcCidrBlock":{}}] |
| IsBind | Boolean | 是否与该桶绑定(该字段已废弃) 示例值:false |
OtherDatasourceConnection
其他数据源
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Location | DatasourceConnectionLocation | 是 | 网络参数 |
OverviewItem
概览数据项,用于监控
被如下接口引用:QueryMonitorOverview。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ChartType | String | 否 | 图表类型(与请求中的 ChartTypes 对应) 示例值:HTTP_QPS |
| Value | Float | 否 | 当前瞬时值(如 QPS=15.2、延迟=120.5ms、利用率=85.0%)。查询失败或无数据时为 null 示例值:0 |
ParallelKeyMapping
ParallelKeyMapping 用于 inference engine 并行配置参数 key 映射
被如下接口引用:DescribeModelEngines, ListInferenceEngines。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Type | String | 否 | 并行类型 示例值:TensorParallelSize |
| Keys | Array of String | 否 | 该并行类型对应的参数 key 列表 示例值:["tensor-parallel-size"] |
Param
对指定参数的更新、增加、删除
被如下接口引用:UpdateStandardEngineResourceGroupConfigInfo。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ConfigItem | String | 否 | 参数key,例如: 示例值:spark.sql.shuffle.partitions |
| ConfigValue | String | 否 | 参数值 示例值:200 |
| Operate | String | 否 | 下发操作,支持:ADD、DELETE、MODIFY 示例值:ADD |
Partition
数据表分块信息。
被如下接口引用:CreateTable, DescribeTable, DescribeTables。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 分区列名。 示例值:col1 |
| Type | String | 否 | 分区类型。 示例值:string |
| Comment | String | 否 | 对分区的描述。 示例值:create by zhangsan |
| Transform | String | 否 | 隐式分区转换策略 示例值:truncate |
| TransformArgs | Array of String | 否 | 转换策略参数 注意:此字段可能返回 null,表示取不到有效值。 示例值:["3"] |
| CreateTime | Integer | 否 | 创建时间 示例值:100000 |
PartitionDetail
资源分区详情
被如下接口引用:DescribePartitionDetail。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| PartitionCode | String | 否 | 分区编码 示例值:dlc-p-ofvhyjzn |
| PartitionName | String | 否 | 分区名称 示例值:甘露-测试04 |
| Description | String | 否 | 分区描述 注意:此字段可能返回 null,表示取不到有效值。 示例值:测试环境 |
| Region | Integer | 否 | 地域 示例值:1 |
| ProductInfo | String | 否 | 产品信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:[{"name":"名称","value":"甘露-测试04"},{"name":"地域","value":"广州"},{"name":"描述","value":"测试环境"}] |
| ResourcePoolCode | String | 否 | 资源池编码 注意:此字段可能返回 null,表示取不到有效值。 示例值:dlc-a1fa1ed6 |
| ResourceQuota | Array of ResourceQuota | 否 | 资源配额列表 注意:此字段可能返回 null,表示取不到有效值。 |
| PayMode | Integer | 否 | 付费模式 示例值:10 |
| RenewFlag | Integer | 否 | 续费标志 示例值:0 |
| Scheduler | String | 否 | 调度器类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:KUEUE |
| Status | Integer | 否 | 状态 示例值:1 |
PartitionInfo
资源分区信息
被如下接口引用:DescribePartitions。
| 名称 | 类型 | 描述 |
|---|---|---|
| Name | String | 分区名称 示例值:jyunnkolitest |
| PartitionCode | String | 分区编码 示例值:dlc-p-pojjeefi |
| Description | String | 描述 注意:此字段可能返回 null,表示取不到有效值。 示例值:测试环境 |
| Status | Integer | 状态:11-发货中,1-运行中,2-隔离中,3-已销毁 示例值:11 |
| QueueCount | Integer | 队列数量 示例值:16 |
| ResourceQuota | Array of ResourceQuota | 资源配置(配额) 注意:此字段可能返回 null,表示取不到有效值。 |
| PayMode | Integer | 计费类型:1-包年包月,0-按量计费 示例值:10 |
| CreateTime | String | 创建时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:2026-03-19 18:00:49 |
| UpdateTime | String | 更新时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:2026-03-27T12:58:28 |
| ExpireTime | String | 过期时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:2026-04-19 00:16:25 |
PersistentWorkDir
Workspace 持久化工作目录配置
被如下接口引用:CreateLab, GetLabDetail, ListLabs, ModifyLabPriority, StartLab, StopLab, UpdateLab。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Enabled | Boolean | 否 | 是否启用持久化工作目录;为空或 false 时沿用 emptyDir 行为 示例值:true |
| Type | String | 否 | 持久化存储类型:COS / CFS 示例值:COS |
| Bucket | String | 否 | COS Bucket 名称(Type=COS 时必填) 示例值:qzzhu-260200065 |
| FileSystemId | String | 否 | CFS 文件系统 ID(Type=CFS 时必填) 示例值:cfs-eikhdf8b |
| VolumeSubPath | String | 否 | Bucket / 文件系统下的子路径,必须以 '/' 开头且不含 '..' 示例值:/sdfds |
PodItem
MlFlow Server Pod 信息
被如下接口引用:DescribeMlflowServerPods。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| PodName | String | 否 | Pod 名称 示例值:mlflow-fe2455ce-mlflow-server-79469f5756-vbcks |
| Namespace | String | 否 | 命名空间 示例值:dlc-p-ikzmoqyv |
| Phase | String | 否 | K8s Pod Phase 示例值:Running |
| Status | String | 否 | 计算后的状态 示例值:Running |
| PodIp | String | 否 | Pod IP 示例值:30.0.1.39 |
| NodeName | String | 否 | 调度节点名 示例值:30.0.0.13 |
| Image | String | 否 | 容器镜像 示例值:ccr.ccs.tencentyun.com/emr-image/mlflow:v3.12.0 |
| CpuRequest | String | 否 | CPU 请求 示例值:1 |
| CpuLimit | String | 否 | CPU 限制 示例值:4 |
| MemoryRequest | String | 否 | 内存请求 示例值:2Gi |
| MemoryLimit | String | 否 | 内存限制 示例值:8Gi |
| CreateTime | Integer | 否 | 创建时间(epoch millis) 示例值:1785244273000 |
| StartTime | Integer | 否 | 启动时间(epoch millis) 示例值:1785244344000 |
Policy
权限对象
被如下接口引用:AttachDataMaskPolicy, AttachUserPolicy, AttachWorkGroupPolicy, CreateUser, CreateWorkGroup, DescribeUserInfo, DescribeUsers, DescribeWorkGroupInfo, DescribeWorkGroups, DetachUserPolicy, DetachWorkGroupPolicy, UpdateRowFilter。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Database | String | 是 | 需要授权的数据库名,填 * 代表当前Catalog下所有数据库。当授权类型为管理员级别时,只允许填 “*”,当授权类型为数据连接级别时只允许填空,其他类型下可以任意指定数据库。 示例值:test_database |
| Catalog | String | 是 | 需要授权的数据源名称,管理员级别下只支持填 * (代表该级别全部资源);数据源级别和数据库级别鉴权的情况下,只支持填COSDataCatalog或者*;在数据表级别鉴权下可以填写用户自定义数据源。不填情况下默认为DataLakeCatalog。注意:如果是对用户自定义数据源进行鉴权,DLC能够管理的权限是用户接入数据源的时候提供的账户的子集。 示例值:DataLakeCatalog |
| Table | String | 是 | 需要授权的表名,填 * 代表当前Database下所有表。当授权类型为管理员级别时,只允许填“*”,当授权类型为数据连接级别、数据库级别时只允许填空,其他类型下可以任意指定数据表。 示例值:test_table |
| Operation | String | 是 | 授权的权限操作,对于不同级别的鉴权提供不同操作。管理员权限:ALL,不填默认为ALL;数据连接级鉴权:CREATE;数据库级别鉴权:ALL、CREATE、ALTER、DROP;数据表权限:ALL、SELECT、INSERT、ALTER、DELETE、DROP、UPDATE。注意:在数据表权限下,指定的数据源不为COSDataCatalog的时候,只支持SELECT操作。 示例值:ALL |
| PolicyType | String | 否 | 授权类型,现在支持八种授权类型:ADMIN:管理员级别鉴权 DATASOURCE:数据连接级别鉴权 DATABASE:数据库级别鉴权 TABLE:表级别鉴权 VIEW:视图级别鉴权 FUNCTION:函数级别鉴权 COLUMN:列级别鉴权 ENGINE:数据引擎鉴权。不填默认为管理员级别鉴权。 示例值:ADMIN |
| Function | String | 否 | 需要授权的函数名,填 * 代表当前Catalog下所有函数。当授权类型为管理员级别时,只允许填“*”,当授权类型为数据连接级别时只允许填空,其他类型下可以任意指定函数。 注意:此字段可能返回 null,表示取不到有效值。 示例值:fun1 |
| View | String | 否 | 需要授权的视图,填 * 代表当前Database下所有视图。当授权类型为管理员级别时,只允许填“*”,当授权类型为数据连接级别、数据库级别时只允许填空,其他类型下可以任意指定视图。 注意:此字段可能返回 null,表示取不到有效值。 示例值:view1 |
| Column | String | 否 | 需要授权的列,填 * 代表当前所有列。当授权类型为管理员级别时,只允许填“*” 注意:此字段可能返回 null,表示取不到有效值。 示例值:column1 |
| DataEngine | String | 否 | 需要授权的数据引擎,填 * 代表当前所有引擎。当授权类型为管理员级别时,只允许填“*” 注意:此字段可能返回 null,表示取不到有效值。 示例值:dataEngine1 |
| ReAuth | Boolean | 否 | 用户是否可以进行二次授权。当为true的时候,被授权的用户可以将本次获取的权限再次授权给其他子用户。默认为false 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
| Source | String | 否 | 权限来源,入参不填。USER:权限来自用户本身;WORKGROUP:权限来自绑定的工作组 注意:此字段可能返回 null,表示取不到有效值。 示例值:USER |
| Mode | String | 否 | 授权模式,入参不填。COMMON:普通模式;SENIOR:高级模式。 注意:此字段可能返回 null,表示取不到有效值。 示例值:COMMON |
| Operator | String | 否 | 操作者,入参不填。 注意:此字段可能返回 null,表示取不到有效值。 示例值:600000563084 |
| CreateTime | String | 否 | 权限创建的时间,入参不填 注意:此字段可能返回 null,表示取不到有效值。 示例值:2021-07-28 16:19:32 |
| SourceId | Integer | 否 | 权限所属工作组的ID,只有当该权限的来源为工作组时才会有值。即仅当Source字段的值为WORKGROUP时该字段才有值。 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| SourceName | String | 否 | 权限所属工作组的名称,只有当该权限的来源为工作组时才会有值。即仅当Source字段的值为WORKGROUP时该字段才有值。 注意:此字段可能返回 null,表示取不到有效值。 示例值:test_group |
| Id | Integer | 否 | 策略ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| EngineGeneration | String | 否 | 引擎类型 示例值:SuperSQL/Native |
| Model | String | 否 | 需要授权的Model名,填 * 代表当前Database下所有表。当授权类型为管理员级别时,只允许填“*”,当授权类型为数据连接级别、数据库级别时只允许填空,其他类型下可以任意指定数据表。 示例值:model1 |
| IsAdminPolicy | Boolean | 否 | 权限来源是否为管理员 示例值:false |
| PolicyId | String | 否 | user和workgroup对应的确定性字符串PolicyId 示例值:v1|USER|700**925|DATABASE|COMMON|DataLakeCatalog|t0_lotuss||||||ASSAYER |
Policys
策略集合
被如下接口引用:DescribeUserInfo, DescribeWorkGroupInfo。
| 名称 | 类型 | 描述 |
|---|---|---|
| PolicySet | Array of Policy | 策略集合 注意:此字段可能返回 null,表示取不到有效值。 |
| TotalCount | Integer | 策略总数 示例值:10 |
PostTrainingResources
后训练资源规格配置
被如下接口引用:DescribePostTrainingPreset。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Head | HeadSpecDTO | 否 | Head 节点资源规格 |
| Worker | Array of WorkerSpecDTO | 否 | Worker 节点资源规格 |
PrestoMonitorMetrics
Presto监控指标
被如下接口引用:DescribeSparkAppTasks, DescribeTaskDetail, DescribeTaskList, DescribeTasks。
| 名称 | 类型 | 描述 |
|---|---|---|
| LocalCacheHitRate | Float | Alluxio本地缓存命中率 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| FragmentCacheHitRate | Float | Fragment缓存命中率 注意:此字段可能返回 null,表示取不到有效值。 示例值:null |
PrometheusInstanceItem
Prometheus 实例概览
被如下接口引用:DescribeBindablePrometheus。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InstanceId | String | 否 | Prometheus 实例 ID,例如 prom-xxxxxxxx 示例值:prom-7edj1s60 |
| InstanceName | String | 否 | 实例名称 示例值:irvintest |
| VpcId | String | 否 | 所属 VPC ID 示例值:vpc-9duymxd7 |
| SubnetId | String | 否 | 所属子网 ID 示例值:subnet-bdhdx9ks |
| InstanceStatus | Integer | 否 | 实例状态:1=创建中, 2=运行中, 3=异常, 4=重启中, 5=销毁中, 6=已停机, 7=已删除, 8=欠费停服中, 9=欠费已停服 示例值:2 |
| SameVpcWithTke | Boolean | 否 | 是否与 TKE 集群同 VPC;true 会被前置排序 示例值:true |
Property
数据库和数据表属性信息
被如下接口引用:AssignMangedTableProperties, CreateDatabase, CreateInternalTable, CreateTcIcebergTable, DescribeDatabase, DescribeDatabases, DescribeTable, DescribeTables, DescribeViews, GenerateCreateMangedTableSql, GenerateInternalTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Key | String | 是 | 属性key名称。 示例值:owner |
| Value | String | 是 | 属性key对应的value。 示例值:create by zhangsan |
PythonSparkImage
python-spark镜像信息。
被如下接口引用:DescribeDataEnginePythonSparkImages。
| 名称 | 类型 | 描述 |
|---|---|---|
| SparkImageId | String | spark镜像唯一id 示例值:d3018ad4-9a7e-4f64-a3f4-f38507c69742 |
| ChildImageVersionId | String | 集群小版本镜像id 示例值:d3dfgtr4-9a7e-4f64-a3f4-f38507c69742 |
| SparkImageVersion | String | spark镜像名称 示例值:pysaprk-1.1 |
| Description | String | spark镜像描述信息 示例值:pysaprk-1.1 |
| CreateTime | String | 创建时间 示例值:2020-01-01 01:01:01 |
| UpdateTime | String | 更新时间 示例值:2020-01-01 01:01:01 |
QueueInfo
队列信息
被如下接口引用:DescribePartitionQueues。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | Integer | 否 | 队列ID 示例值:0 |
| QueueName | String | 否 | 队列名称 示例值:default |
| ResourceUsage | Array of ResourceUsage | 否 | 资源用量列表 注意:此字段可能返回 null,表示取不到有效值。 |
| Description | String | 否 | 队列描述 注意:此字段可能返回 null,表示取不到有效值。 示例值:description |
| IsDefault | Integer | 否 | 是否为默认队列 示例值:0 |
| QueueType | Integer | 否 | 队列类型:1-独占型,2-共享型 示例值:1 |
RayClusterEntity
Ray集群实体
被如下接口引用:DescribeClusterGroupClusters, ListRayClusters。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | String | 否 | 集群ID 示例值:raycluster-20260523125319-m9qh |
| Type | String | 否 | 资源类型:CLUSTER-普通集群;WORKSPACE-数据实验室(开发入口) 示例值:RAY_CLUSTER |
| Name | String | 否 | 集群名称 示例值:raycluster_callan_20 |
| ResourcePartitionId | String | 否 | 所属资源分区ID 示例值:dlc-p-nsnqhoqi |
| ResourcePartitionName | String | 否 | 默认资源分区名称 示例值:test_qzzhu |
| Queue | String | 否 | 所属队列名称 示例值:mao-group |
| AppId | Integer | 否 | 应用ID 示例值:260200065 |
| Uin | String | 否 | 用户UIN 示例值:700002655693 |
| SubAccountUin | String | 否 | 子用户UIN 示例值:700002655693 |
| SubAccountName | String | 否 | 子用户名称(由聚合层通过 CAM 接口回填) 示例值:700002744585 |
| Status | String | 否 | 集群状态 示例值:RUNNING |
| StatusMessage | String | 否 | 状态详情/错误信息 示例值:VPC对等连接打通失败: VPC对等连接打通网络失败: Failed to call ResourceManager action=EnsureVpcPeering: I/O error on POST request for "http://21.196.203.71:8081/api/v3/resourcemanager": Read timed out |
| CreateTime | Integer | 否 | 创建时间 示例值:1779511955602 |
| GroupId | String | 否 | 计算组 ID 示例值:rayclustergroup-tfbd8i-6mfm |
| GroupName | String | 否 | 所属集群组名称 示例值:group_aidanyxu |
| ResourceConfig | String | 否 | 资源配置(JSON) 示例值:{"Head":{},"Worker":[{}]} |
| ResourceConfigId | String | 否 | 资源配置ID 示例值:bd526bf9-8599-4d66-985d-d90b8ddbe7ff |
| Image | String | 否 | 镜像地址 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:2.55.1-py311-cpu-extra |
| Catalog | String | 否 | 存储卷和挂载卷配置(JSON) 示例值:{"CFSVolumes":[],"CFSTurboVolumes":[],"COSVolumes":[{}],"GooseFSVolumes":[]} |
| HistoryUrl | String | 否 | Dashboard URL / 历史记录链接 示例值:https://cls-pdb9lgk2.tcray-gateway.ap-guangzhou.cloud.tencent.com/dlc-p-iiwkbxkl/raycluster-20260523122928-r8er/ |
| ImagePullPolicy | String | 否 | 镜像拉取策略 示例值:Always |
| ImagePullType | String | 否 | 镜像拉取类型(BuiltIn: 内置, Custom: 自定义-TCR, CustomCcr: 自定义-CCR) 示例值:BuiltIn |
| AdvancedOptions | String | 否 | 高级参数(规范化后的扁平 KV JSON) 示例值:{"spec.workerGroupSpecs.lifecycleHooks.preInit":"[{"name":"w-pre-init","inlineScript":"echo w-pre-init","timeoutSeconds":30,"ignoreFailure":false}]"} |
| Priority | Integer | 否 | 优先级(1-9,数字越大优先级越高) 示例值:7 |
| StartTime | Integer | 否 | 启动时间(最近一次启动) 示例值:1779510575211 |
| StopTime | Integer | 否 | 停止时间(最近一次停止/休眠) 示例值:1779700014752 |
| Tags | Array of Tag | 否 | 标签列表(TagKey-TagValue) |
RayClusterHistory
集群状态历史详情
被如下接口引用:GetLabHistory, GetRayClusterHistory。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | Integer | 否 | 历史记录ID 示例值:885 |
| ClusterId | String | 否 | 集群/数据实验室ID 示例值:171 |
| ClusterName | String | 否 | 集群/数据实验室名称 示例值:aidanyxu-test |
| FromState | String | 否 | 源状态 示例值:STARTING |
| ToState | String | 否 | 目标状态 示例值:FAILED |
| Event | String | 否 | 触发事件 示例值:FAIL |
| Message | String | 否 | 消息 示例值:kubernetes.namespace is not configured and resourcePartitionId is null. Cannot determine target namespace. |
| TransitionTime | Integer | 否 | 转换时间(毫秒时间戳) 示例值:1780402599183 |
RayJobEventItem
Ray 任务事件项
被如下接口引用:GetRayJobEvent。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| EventTime | Integer | 否 | 事件时间(Unix 时间戳,毫秒) 示例值:1774256065032 |
| Component | String | 否 | 组件名称,来源于 event.involvedObject.kind 示例值:RayJob |
| Level | String | 否 | 事件级别,来源于 event.type 的原始值(如 Normal、Warning) 示例值:Normal |
| Message | String | 否 | 事件内容,来源于 event.message 示例值:Created RayCluster rayjob-xxx |
| InvolvedObjectName | String | 否 | 关联的 K8s 对象名称,来源于 event.involvedObject.name 示例值:rayjob-20260708160826-k1qp-4tcc5-head-ingress |
| SourceComponent | String | 否 | 事件来源组件,来源于 event.source.component 示例值:kubelet |
| Reason | String | 否 | 事件原因,来源于 event.reason 示例值:SuccessfulOccupyENIIP |
RayJobSubmitEntity
Ray任务提交实体
被如下接口引用:ListJobsBySpec, ListRayClusterJobs, ListRayJobs。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | String | 否 | 任务ID 示例值:rayjob-20260325114517-sg2m |
| ResourcePartitionId | String | 否 | 所属资源分区ID 示例值:dlc-p-ofvhyjzn |
| ResourcePartitionName | String | 否 | 默认资源分区名称 示例值:甘露-测试04 |
| Queue | String | 否 | 所属队列名称 示例值:default |
| Status | String | 否 | 任务状态 示例值:SUBMITTED |
| Entrypoint | String | 否 | 入口命令 示例值:echo 'turkey' |
| JobName | String | 否 | 任务名称 示例值:test1111-20260325114517-sg2m |
| AppId | Integer | 否 | 应用ID 示例值:1300057089 |
| Uin | String | 否 | 用户主账号UIN 示例值:600000563453 |
| SubAccountUin | String | 否 | 子用户UIN 示例值:700002467852 |
| SubAccountName | String | 否 | 子用户名称(由聚合层通过 CAM 接口回填) 示例值:700002744585 |
| HistoryUrl | String | 否 | 历史记录链接 示例值:https://test-tcray-historyserver-guangzhou.cloud.tencent.com/history/dlc-p-ofvhyjzn/rayjob-20260325114517-sg2m/ |
| RunningTime | Integer | 否 | 运行时间(ms) 示例值:304 |
| FinishTime | Integer | 否 | 完成时间 示例值:1774410319640 |
| CreateTime | Integer | 否 | 创建时间 示例值:1774410317712 |
| ErrorMessage | String | 否 | 失败原因/错误信息 示例值:Cannot invoke "String.startsWith(String)" because "masterUrl" is null |
| RuntimeEnv | String | 否 | 运行时环境配置(JSON) 示例值:{"py_modules":["/path/to/my_module","s3://bucket/my_lib.zip"],"working_dir":"https://common-job-packages-251233710.cos.ap-guangzhou.myqcloud.com/job-packages/260090589/20260324210556/b765a3a7-d630-46a5-bba3-866212d027d4.zip"} |
| Image | String | 否 | 镜像地址 示例值:ccr.ccs.tencentyun.com/tcray-xpark/xpark:0.0.0.dev0-ray2.54.0-py312-cpu |
| ResourceConfig | String | 否 | 资源配置(JSON) 示例值:{"Head":{"Name":"default-head","PodCpu":1,"PodMem":2,"PodNum":1,"GpuType":"","GpuNum":0,"Envs":[],"Labels":[]},"Worker":[{"Name":"default-worker","PodCpu":1,"PodMem":2,"MinPodNum":1,"MaxPodNum":1,"GpuType":"","GpuNum":0,"Envs":[],"Labels":[]}]} |
| Catalog | String | 否 | 存储卷和挂载卷配置(JSON) 示例值:{"CFSVolumes":[],"COSVolumes":[]} |
| ImagePullPolicy | String | 否 | 镜像拉取策略 示例值:Always |
| AutoscalerOptions | String | 否 | 弹性伸缩配置(JSON) 示例值:{"upscalingMode":"Default","idleTimeoutSeconds":60,"resourceSpec":"small","resources":{"cpu":"500m","memory":"512Mi"}} |
| SpecId | String | 否 | 来源配置ID 示例值:rayjobspec-tcfqaq-hez2 |
| SpecName | String | 否 | 来源配置名称 示例值:test1111 |
| AdvancedOptions | String | 否 | 高级参数,JSON 字符串(透传到 Neutrino) 示例值:{"spec.submitterPodTemplate.metadata.labels.test":"test"} |
| Priority | Integer | 否 | 作业优先级(1-9,数字越大优先级越高) 示例值:2 |
| Tags | Array of Tag | 否 | 标签列表(TagKey-TagValue),用于将资源与腾讯云标签系统中的标签绑定 |
| JobSource | String | 否 | 作业来源(如 RAY_JOB / RAY_SERVE / 平台直提交等) 示例值:ray-nexus |
RecommendedAdvancedParams
推荐的推理高级参数
被如下接口引用:DescribeRecommendedParams。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| EnableRemoteCode | Boolean | 否 | 是否启用 trust_remote_code 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| GpuMemoryUtilization | Integer | 否 | GPU 显存利用率(百分比,例如 90 表示 90%) 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| TensorParallelSize | Integer | 否 | Tensor 并行度 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| PipelineParallelSize | Integer | 否 | Pipeline 并行度 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| DataParallelSize | Integer | 否 | Data 并行度 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| EngineArgs | Array of RecommendedKeyValue | 否 | 推理引擎参数列表 注意:此字段可能返回 null,表示取不到有效值。 |
| EnvVars | Array of RecommendedKeyValue | 否 | 环境变量列表 注意:此字段可能返回 null,表示取不到有效值。 |
| RayOptions | Array of RecommendedKeyValue | 否 | Ray Actor Options 列表 注意:此字段可能返回 null,表示取不到有效值。 |
RecommendedKeyValue
Key-Value 键值对
被如下接口引用:DescribeRecommendedParams。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Key | String | 否 | 键 注意:此字段可能返回 null,表示取不到有效值。 示例值:booster |
| Value | String | 否 | 值 注意:此字段可能返回 null,表示取不到有效值。 示例值:gbtree |
RegionInfo
可售卖地域信息
被如下接口引用:DescribeSaleRegions。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| RegionCode | String | 否 | 地域编码,如 ap-chongqing 示例值:ap-guangzhou |
| RegionName | String | 否 | 地域名称,如 重庆 示例值:广州 |
| Status | String | 否 | 地域状态:AVAILABLE-可用,UNAVAILABLE-不可用 示例值:AVAILABLE |
ReplicaInfo
副本信息
被如下接口引用:QueryDashboardServiceList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Desired | Integer | 否 | 期望副本数 示例值:4 |
| Available | Integer | 否 | 可用(就绪)副本数 示例值:0 |
ResourceConf
数据治理资源配置项
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Parallelism | Integer | 否 | 当为TCLake优化资源时,优化任务的并行度 示例值:16 |
ResourceConfig
资源配置响应
被如下接口引用:ListResourceConfigs。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Id | String | 否 | 模板ID 示例值:37e3efd5-db40-4e76-b280-76d49f7d9714 |
| Name | String | 否 | 模板名称 示例值:ce |
| Description | String | 否 | 描述 示例值:ce |
| Type | String | 否 | 模板类型(ray,spark) 示例值:RAY |
| Head | HeadSpecDTO | 否 | Head节点配置 |
| Worker | Array of WorkerSpecDTO | 否 | Worker节点配置 |
| AppId | Integer | 否 | 应用ID 示例值:1300057089 |
| Uin | String | 否 | 创建者UIN 示例值:600000563453 |
| SubAccountUin | String | 否 | 子用户UIN 示例值:600000563453 |
| CreateTime | Integer | 否 | 创建时间 示例值:1773815368182 |
| UpdateTime | Integer | 否 | 更新时间 示例值:1773815368185 |
ResourceInfo
数据优化资源信息结构
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| AttributionType | String | 否 | 归属类型 示例值:group |
| ResourceType | String | 否 | 资源类型 示例值:spark-sql |
| Name | String | 否 | 引擎名称 示例值:引擎名称 |
| Instance | String | 否 | 如资源类型为spark-sql 取值为Name, 如为spark-batch 取值为session app_name 示例值:spark-sql |
| Favor | Array of FavorInfo | 否 | 亲和性 注意:此字段可能返回 null,表示取不到有效值。 |
| Status | Integer | 否 | 状态 示例值:1 |
| ResourceGroupName | String | 否 | 标准引擎资源组信息 示例值:rg-test |
| ResourceConf | ResourceConf | 否 | 资源配置信息 |
ResourceQuota
资源配额
被如下接口引用:CheckModifyPartition, CreatePartition, DescribePartitionDetail, DescribePartitions。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ResourceSpec | ResourceSpec | 否 | 可售卖资源规格 |
| Quota | Integer | 否 | 配额数量 请注意,CPU类型计费项为32的整数倍,GPU类型计费项为1的整数倍。 示例值:32 |
ResourceSaleInfo
可售卖资源规格信息
被如下接口引用:DescribeSaleResourceInfo。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ResourceSpec | ResourceSpec | 否 | 可售卖资源规格 |
| Step | Integer | 否 | 规格步长 注意:此字段可能返回 null,表示取不到有效值。 示例值:32 |
| MaxSpec | Integer | 否 | 最大资源数量,仅GU有值 注意:此字段可能返回 null,表示取不到有效值。 示例值:192 |
| StatusCategory | String | 否 | 库存情况,对当前地域该计费项实时可新增数量的分级预估。取值复用 BcpConstants 库存状态常量:
该值为底层提供的预估值,不代表保证可发货量,仅用于展示库存概况。当请求 Region 与资源池地域不一致、cold-start 缓存未 ready、或该计费项在快照中缺失时返回 null。 注意:此字段可能返回 null,表示取不到有效值。 示例值:EnoughStock |
ResourceSpec
资源规格
被如下接口引用:CheckModifyPartition, CreatePartition, CreatePartitionQueue, DescribeSaleResourceInfo, ModifyPartitionQueue。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ResourceType | String | 否 | 资源包类型 示例值:GPU |
| InstanceType | String | 否 | 机型,例如X40/T20,仅GU有值 注意:此字段可能返回 null,表示取不到有效值。 示例值:PNV6 |
| BillingItem | String | 否 | 四层计费项 枚举值:
若您想要了解更多的计费规格和产品细节,欢迎联系我们。 示例值:sv_dlc_standard_cu_standard_cu |
| SpecDesc | String | 否 | 规格描述 示例值:1 GU = 1 × T4 · 16GB VRAM · 20vCPU · 80GB Memory |
| Spec | String | 否 | 规格,格式为 {gpu}:{cpu}:{mem}:{vram} 示例值:1:16:160:96 |
| GpuType | String | 否 | GPU类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:H20 |
| MaxCardPerNode | Integer | 否 | 单个物理节点上该计费项对应的最大 GPU 卡数,CPU / HM_CPU 恒为 0 示例值:8 |
ResourceUsage
资源用量信息,描述某种资源类型的用量范围
被如下接口引用:CreatePartitionQueue, DescribePartitionQueues, ModifyPartitionQueue。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ResourceSpec | ResourceSpec | 否 | 资源规格 |
| Min | Integer | 否 | 最小用量 示例值:0 |
| Max | Integer | 否 | 最大用量 示例值:100 |
SQLTask
SQL查询任务
被如下接口引用:CreateTask。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| SQL | String | 是 | base64加密后的SQL语句 示例值:U0VMRUNUICogRlJPTSBgdGVzdGA7 |
| Config | Array of KVPair | 否 | 任务的配置信息 |
ScheduleElasticityConf
引擎资源弹性伸缩策略
被如下接口引用:DescribeDataEngine, DescribeDataEngines, UpdateDataEngine。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ScheduledElasticityEnabled | Boolean | 否 | 是否开启弹性伸缩:true/false 示例值:true |
| ScheduleType | String | 否 | 调度类型:ONCE(一次性调度),DAILY(每日调度),WEEKLY(每周调度),MONTHLY(每月调度) 示例值:WEEKLY |
| ScheduleDays | Array of Integer | 否 | 调度日期:WEEKLY传:1 示例值:[1] |
| TimeZone | String | 否 | 调度时区 示例值:UTC+08:00(北京) |
| ElasticPlans | Array of ElasticPlan | 否 | 弹性伸缩计划 |
Script
script实例。
被如下接口引用:DescribeScripts。
| 名称 | 类型 | 描述 |
|---|---|---|
| ScriptId | String | 脚本Id,长度36字节。 示例值:89570c65-49de-4bbd-ac0a-a67c724fc80f |
| ScriptName | String | 脚本名称,长度0-25。 示例值:89570c65-49de-4bbd-ac0a-a67c724fc80f |
| ScriptDesc | String | 脚本描述,长度0-50。 注意:此字段可能返回 null,表示取不到有效值。 示例值:create by zhangsan |
| DatabaseName | String | 默认关联数据库。 示例值:database1 |
| SQLStatement | String | SQL描述,长度0-10000。 注意:此字段可能返回 null,表示取不到有效值。 示例值:U0VMRUNUICogRlJPTSBgdGVzdGA7 |
| UpdateTime | Integer | 更新时间戳, 单位:ms。 示例值:1611646962000 |
ServiceMetricsItem
服务监控指标
被如下接口引用:QueryDashboardServiceList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ServiceId | String | 否 | 服务 UID,服务唯一标识 示例值:svc-20260606214706-paqu |
| ServiceName | String | 否 | 服务显示名称 示例值:xgboost-xgbxgb |
| Status | String | 否 | 服务状态 示例值:Failed |
| Engine | String | 否 | 推理引擎 示例值:vllm |
| ModelName | String | 否 | 模型名称 示例值:xgboost |
| ModelIdentifier | String | 否 | OpenAI 兼容的模型标识符 示例值:xgbxgb |
| Replicas | ReplicaInfo | 否 | 副本信息 |
| Metrics | MetricsData | 否 | 监控指标数据 |
SessionResourceTemplate
Spark批作业集群Session资源配置模板;
被如下接口引用:CreateDataEngine, DescribeDataEngine, DescribeDataEngines, DescribeUserDataEngineConfig, UpdateDataEngine, UpdateUserDataEngineConfig。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DriverSize | String | 否 | driver规格:small,medium,large,xlarge;内存型(引擎类型):m.small,m.medium,m.large,m.xlarge 示例值:small |
| ExecutorSize | String | 否 | executor规格:small,medium,large,xlarge;内存型(引擎类型):m.small,m.medium,m.large,m.xlarge 示例值:small |
| ExecutorNums | Integer | 否 | 指定executor数量,最小值为1,最大值小于集群规格 示例值:1 |
| ExecutorMaxNumbers | Integer | 否 | 指定executor max数量(动态配置场景下),最小值为1,最大值小于集群规格(当ExecutorMaxNumbers小于ExecutorNums时,改值设定为ExecutorNums) 示例值:1 |
| RunningTimeParameters | Array of DataEngineConfigPair | 否 | 运行时参数 示例值:复杂类型 |
SharedMountFileItem
共享挂载文件/目录项
被如下接口引用:DescribeTrainingCheckpoints。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | 文件或目录名 示例值:.validate_storage_marker |
| Type | String | 否 | 类型:file / directory 示例值:file |
| Size | Integer | 否 | 文件大小(字节,仅 Type=file 时有值) 示例值:1127 |
| LastModified | Integer | 否 | 最后修改时间(毫秒时间戳,仅 Type=file 时有值) 示例值:1785495869000 |
| Path | String | 否 | 相对 MountPath 的完整路径 示例值:sft_ray_training/.validate_storage_marker |
| Metrics | CheckpointMetrics | 否 | Checkpoint 训练指标(仅 checkpoint 目录且 snapshot 存在时有值) |
SmartOptimizerChangeTablePolicy
混合表中,change表的数据保存时间,单位为天
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DataRetentionTime | Integer | 否 | change表的数据保存时间,单位为天 示例值:8 |
SmartOptimizerIndexPolicy
SmartOptimizerIndexPolicy
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| IndexEnable | String | 否 | 开启索引 示例值:none/enable/disable/default |
SmartOptimizerLifecyclePolicy
SmartOptimizerLifecyclePolicy
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| LifecycleEnable | String | 否 | 生命周期启用 示例值:none/enable/disable/default |
| Expiration | Integer | 否 | 过期时间 示例值:100 |
| ExpiredField | String | 否 | 过期字段 示例值:pt |
| ExpiredFieldFormat | String | 否 | 过期字段格式 示例值:yyyy-MM-dd |
SmartOptimizerPolicy
SmartOptimizerPolicy
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Inherit | String | 否 | 是否继承 示例值:true |
| Resources | Array of ResourceInfo | 否 | 数据治理资源 注意:此字段可能返回 null,表示取不到有效值。 |
| Written | SmartOptimizerWrittenPolicy | 否 | 数据重写策略 注意:此字段可能返回 null,表示取不到有效值。 |
| Lifecycle | SmartOptimizerLifecyclePolicy | 否 | 数据过期策略 注意:此字段可能返回 null,表示取不到有效值。 |
| Index | SmartOptimizerIndexPolicy | 否 | SmartOptimizerIndexPolicy 注意:此字段可能返回 null,表示取不到有效值。 |
| ChangeTable | SmartOptimizerChangeTablePolicy | 否 | SmartOptimizerChangeTablePolicy 注意:此字段可能返回 null,表示取不到有效值。 |
| TableExpiration | TableExpirationPolicy | 否 | 表过期策略 |
SmartOptimizerWrittenPolicy
SmartOptimizerWrittenPolicy
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| WrittenEnable | String | 否 | none/enable/disable/default 示例值:enable |
| AdvancePolicy | WrittenAdvancePolicy | 否 | 用户自定义高级参数 注意:此字段可能返回 null,表示取不到有效值。 |
SmartPolicy
SmartPolicyRequest
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| BaseInfo | SmartPolicyBaseInfo | 否 | 基础信息 注意:此字段可能返回 null,表示取不到有效值。 |
| Policy | SmartOptimizerPolicy | 否 | 策略描述 注意:此字段可能返回 null,表示取不到有效值。 |
SmartPolicyBaseInfo
SmartPolicyBaseInfo
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Uin | String | 是 | 用户uin 示例值:100011282005 |
| PolicyType | String | 否 | Catalog/Database/Table 示例值:Table |
| Catalog | String | 否 | Catalog名称 示例值: DataLakeCatalog |
| Database | String | 否 | 数据库名称 示例值:dbtest |
| Table | String | 否 | 表名称 示例值:tbtest |
| AppId | String | 否 | 用户appid 示例值:1 |
Sort
排序结构
被如下接口引用:DescribeTablePartitions。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Field | String | 是 | 排序字段 示例值:create_time |
| Asc | Boolean | 是 | 是否按照ASC排序,否则DESC排序 示例值:true |
SortField
排序字段定义
被如下接口引用:DescribeMlflowServerEvents, DescribePartitionQueues, DescribePartitions, GetLabEvent, GetLabPods, GetRayClusterEvent, GetRayClusterPods, GetRayJobEvent, GetRayJobPods, ListApiKeys, ListBenchmarkSummary, ListBenchmarkTasks, ListClusterGroups, ListDeploymentReplicas, ListDeployments, ListInferenceEngines, ListInferenceModels, ListInferenceServices, ListJobSpecs, ListJobsBySpec, ListLabs, ListMlflowServerTrainingInstances, ListMlflowServers, ListModelVersions, ListRayClusterJobs, ListRayClusters, ListRayJobs, ListResourceConfigs, ListServiceApiKeys, ListTrainingJobInstance, ListTrainingJobSpec, QueryDashboardServiceList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Field | String | 否 | 排序字段名,对应实体属性名(驼峰命名) 示例值:createTime |
| Order | String | 否 | 排序方向:ASC(升序)或DESC(降序),默认ASC 示例值:DESC |
SortOrder
合并策略sort类型的规则定义
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Column | String | 否 | sort的数据表列名称 示例值:id |
| SortDirection | String | 否 | 按照升序或者降序进行排序 示例值:ASC |
| NullOrder | String | 否 | null值放在开头或者末尾 示例值:NULLS FIRST |
SparkJobInfo
spark作业详情。
被如下接口引用:DescribeSparkAppJob, DescribeSparkAppJobs。
| 名称 | 类型 | 描述 |
|---|---|---|
| JobId | String | spark作业ID 示例值:4a7cad6bb86211ec9c616e6f30623d72 |
| JobName | String | spark作业名 示例值:test-app |
| JobType | Integer | spark作业类型,可去1或者2,1表示batch作业, 2表示streaming作业 示例值:1 |
| DataEngine | String | 引擎名 示例值:spark-engine |
| Eni | String | 该字段已下线,请使用字段Datasource 示例值:kafka |
| IsLocal | String | 程序包是否本地上传,cos或者lakefs 示例值:cos |
| JobFile | String | 程序包路径 示例值:cosn://bucket/example.jar |
| RoleArn | Integer | 角色ID 示例值:1 |
| MainClass | String | spark作业运行主类 示例值:org.tencent.Example |
| CmdArgs | String | 命令行参数,spark作业命令行参数,空格分隔 示例值:1 2 |
| JobConf | String | spark原生配置,换行符分隔 示例值:spark.network.timeout=120s |
| IsLocalJars | String | 依赖jars是否本地上传,cos或者lakefs 示例值:cos |
| JobJars | String | spark作业依赖jars,逗号分隔 示例值:example.jar |
| IsLocalFiles | String | 依赖文件是否本地上传,cos或者lakefs 示例值:cos |
| JobFiles | String | spark作业依赖文件,逗号分隔 示例值:cos |
| JobDriverSize | String | spark作业driver资源大小 示例值:small |
| JobExecutorSize | String | spark作业executor资源大小 示例值:small |
| JobExecutorNums | Integer | spark作业executor个数 示例值:1 |
| JobMaxAttempts | Integer | spark流任务最大重试次数 示例值:3 |
| JobCreator | String | spark作业创建者 示例值:100**9064 |
| JobCreateTime | Integer | spark作业创建时间 示例值:1 |
| JobUpdateTime | Integer | spark作业更新时间 示例值:1 |
| CurrentTaskId | String | spark作业最近任务ID 示例值:4a7cad6bb86211ec9c616e6f30623d72 |
| JobStatus | Integer | spark作业最近运行状态,初始化:0,运行中:1,成功:2,数据写入中: 3, 排队中: 4, 失败: -1, 已删除: -3,已过期: -5 示例值:0 |
| StreamingStat | StreamingStatistics | spark流作业统计 注意:此字段可能返回 null,表示取不到有效值。 |
| DataSource | String | 数据源名 注意:此字段可能返回 null,表示取不到有效值。 示例值:kafka-datasource |
| IsLocalPythonFiles | String | pyspark:依赖上传方式,1、cos;2、lakefs(控制台使用,该方式不支持直接接口调用) 注意:此字段可能返回 null,表示取不到有效值。 示例值:cos |
| AppPythonFiles | String | 注:该返回值已废弃 注意:此字段可能返回 null,表示取不到有效值。 示例值:test.py |
| IsLocalArchives | String | archives:依赖上传方式,1、cos;2、lakefs(控制台使用,该方式不支持直接接口调用) 注意:此字段可能返回 null,表示取不到有效值。 示例值:cos |
| JobArchives | String | archives:依赖资源 注意:此字段可能返回 null,表示取不到有效值。 示例值:file1.tar.gz#abc |
| SparkImage | String | Spark Image 版本 注意:此字段可能返回 null,表示取不到有效值。 示例值:1.0 |
| JobPythonFiles | String | pyspark:python依赖, 除py文件外,还支持zip/egg等归档格式,多文件以逗号分隔 注意:此字段可能返回 null,表示取不到有效值。 示例值:test.py |
| TaskNum | Integer | 当前job正在运行或准备运行的任务个数 注意:此字段可能返回 null,表示取不到有效值。 示例值:5 |
| DataEngineStatus | Integer | 引擎状态:-100(默认:未知状态),-2~11:引擎正常状态; 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| JobExecutorMaxNumbers | Integer | 指定的Executor数量(最大值),默认为1,当开启动态分配有效,若未开启,则该值等于JobExecutorNums 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| SparkImageVersion | String | 镜像版本 注意:此字段可能返回 null,表示取不到有效值。 示例值:pyspark3.2 |
| SessionId | String | 查询脚本关联id 注意:此字段可能返回 null,表示取不到有效值。 示例值:931a72aa-4f83-4d6a-adf1-2sdda0234a655 |
| DataEngineClusterType | String | spark_emr_livy 注意:此字段可能返回 null,表示取不到有效值。 示例值:引擎类型 |
| DataEngineImageVersion | String | Spark 3.2-EMR 注意:此字段可能返回 null,表示取不到有效值。 示例值:引擎镜像版本 |
| IsInherit | Integer | 任务资源配置是否继承集群模板,0(默认)不继承,1:继承 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| IsSessionStarted | Boolean | 是否使用session脚本的sql运行任务:false:否,true:是 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
| EngineTypeDetail | String | 引擎详细类型:SparkSQL、PrestoSQL、SparkBatch、StandardSpark、StandardPresto 注意:此字段可能返回 null,表示取不到有效值。 示例值:SparkSQL |
SparkMonitorMetrics
Spark监控数据
被如下接口引用:DescribeSparkAppTasks, DescribeTaskDetail, DescribeTaskList, DescribeTasks。
| 名称 | 类型 | 描述 |
|---|---|---|
| ShuffleWriteBytesCos | Integer | shuffle写溢出到COS数据量,单位:byte 注意:此字段可能返回 null,表示取不到有效值。 示例值:0 |
| ShuffleWriteBytesTotal | Integer | shuffle写数据量,单位:byte 注意:此字段可能返回 null,表示取不到有效值。 示例值:59174754650 |
SparkSessionBatchLog
SparkSQL批任务运行日志
被如下接口引用:DescribeSparkSessionBatchSqlLog。
| 名称 | 类型 | 描述 |
|---|---|---|
| Step | String | 日志步骤:BEG/CS/DS/DSS/DSF/FINF/RTO/CANCEL/CT/DT/DTS/DTF/FINT/EXCE 示例值:BEG |
| Time | String | 时间 示例值:2023-03-20 12:12:12 |
| Message | String | 日志提示 示例值:开始 |
| Operate | Array of SparkSessionBatchLogOperate | 日志操作 注意:此字段可能返回 null,表示取不到有效值。 示例值:复杂类型 |
SparkSessionBatchLogOperate
SparkSQL批任务日志操作信息。
被如下接口引用:DescribeSparkSessionBatchSqlLog。
| 名称 | 类型 | 描述 |
|---|---|---|
| Text | String | 操作提示 示例值:4xlarge |
| Operate | String | 操作类型:COPY、LOG、UI、RESULT、List、TAB 示例值:COPY |
| Supplement | Array of KVPair | 补充信息:如:taskid、sessionid、sparkui等 注意:此字段可能返回 null,表示取不到有效值。 示例值:d3018ad4-9a7e-4f64-a3f4-f38507c69742 |
SparkSessionInfo
spark session详细信息
被如下接口引用:DescribeNativeSparkSessions。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| SparkSessionId | String | 否 | spark session id 示例值:session-xxx |
| SparkSessionName | String | 否 | spark session名称 示例值:test_session |
| ResourceGroupId | String | 否 | 资源组id 示例值:rg-xxxx |
| EngineSessionId | String | 否 | engine session id 示例值:session-id |
| EngineSessionName | String | 否 | engine session 示例值:session-name |
| IdleTimeoutMin | Integer | 否 | 自动销毁时间 示例值:1 |
| DriverSpec | String | 否 | driver规格 示例值:small(1CU) |
| ExecutorSpec | String | 否 | executor规格 示例值:small(1CU) |
| ExecutorNumMin | Integer | 否 | executor最小数量 示例值:1 |
| ExecutorNumMax | Integer | 否 | executor最大数量 示例值:3 |
| TotalSpecMin | Integer | 否 | 总规格最小 示例值:1 |
| TotalSpecMax | Integer | 否 | 总规格最大 示例值:3 |
| State | String | 否 | 状态,STARTING、RUNNING、TERMINATED 示例值:RUNNING |
| ApplicationId | String | 否 | 应用 ID 示例值:1**01 |
| ApplicationStartTime | Integer | 否 | 应用启动时间 示例值:0 |
SpecInfo
节点规格信息
被如下接口引用:DescribeEngineNodeSpec。
| 名称 | 类型 | 描述 |
|---|---|---|
| Name | String | 规格名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:small |
| Cu | Integer | 当前规格的cu数 注意:此字段可能返回 null,表示取不到有效值。 示例值:8 |
| Cpu | Integer | 当前规格的cpu数 注意:此字段可能返回 null,表示取不到有效值。 示例值:8 |
| Memory | Integer | 当前规格的内存数,单位G 注意:此字段可能返回 null,表示取不到有效值。 示例值:32 |
StandardEngineResourceGroupConfigInfo
标准引擎资源组,配置相关信息
被如下接口引用:DescribeStandardEngineResourceGroupConfigInfo。
| 名称 | 类型 | 描述 |
|---|---|---|
| ResourceGroupId | String | 引擎资源组 ID |
| DataEngineId | String | 引擎ID |
| StaticConfigPairs | Array of EngineResourceGroupConfigPair | 资源组静态参数,需要重启资源组生效 |
| DynamicConfigPairs | Array of EngineResourceGroupConfigPair | 资源组动态参数,下一个任务生效。 |
| CreateTime | Integer | 创建时间 |
| UpdateTime | Integer | 更新时间 |
StandardEngineResourceGroupInfo
用户标准引擎资源组信息
被如下接口引用:DescribeStandardEngineResourceGroups。
| 名称 | 类型 | 描述 |
|---|---|---|
| EngineResourceGroupId | String | 标准引擎资源组ID |
| EngineResourceGroupName | String | 标准引擎资源组名称,支持1-50个英文、汉字、数字、连接线-或下划线_ |
| Creator | String | 创建者 |
| ResourceGroupState | Integer | 资源组 状态,-1--删除、0--启动中、2--运行、3--暂停、4--暂停中、7--切换引擎中、8--配置修改中。9--资源组重启中,10--因为变配导致资源组启动、11--因为隔离导致资源组挂起、12- 资源配置下发中、 13-接入点隔离导致资源组挂起中 |
| AutoLaunch | Integer | 自动启动,(任务提交自动拉起资源组)0-自动启动,1-不自动启动 |
| AutoPause | Integer | 自动挂起资源组。0-自动挂起,1-不自动挂起 |
| AutoPauseTime | Integer | 自动挂起时间,单位分钟,取值范围在1-999(在无任务AutoPauseTime后,资源组自动挂起) |
| DriverCuSpec | String | driver的cu规格: 当前支持:small(默认,1cu)、medium(2cu)、large(4cu)、xlarge(8cu),内存型cu为cpu:men=1:8,m.small(1cu内存型)、m.medium(2cu内存型)、m.large(4cu内存型)、m.xlarge(8cu内存型) |
| ExecutorCuSpec | String | executor的cu规格: 当前支持:small(默认,1cu)、medium(2cu)、large(4cu)、xlarge(8cu),内存型cu为cpu:men=1:8,m.small(1cu内存型)、m.medium(2cu内存型)、m.large(4cu内存型)、m.xlarge(8cu内存型) |
| MaxConcurrency | Integer | 任务并发数 |
| MinExecutorNums | Integer | executor最小数量, |
| MaxExecutorNums | Integer | executor最大数量, |
| CreateTime | Integer | 创建时间戳 |
| UpdateTime | Integer | 更新时间戳 |
| NeedRestart | Integer | 是否待重启,作为有资源参数,静态参数修改未重启生效的标识;0-- 不需要重启、1--因为资源参数待重启、2--因静态参数重启、3--因资源和静态参数而待重启、4--因网络配置而待重启、5--因网络配置和资源配置而待重启、6--因网络配置和静态参数而待重启、7--因网络配置,资源参数和静态参数而待重启、 |
| DataEngineName | String | 绑定的引擎名称 |
| DataEngineId | String | 绑定的引擎ID |
| DataEngineState | Integer | 绑定的引擎状态 注意:此字段可能返回 null,表示取不到有效值。 |
| AccessPointId | String | 接入点ID 注意:此字段可能返回 null,表示取不到有效值。 |
| AccessPointName | String | 接入点名称 注意:此字段可能返回 null,表示取不到有效值。 |
| AccessPointState | Integer | 接入点状态 注意:此字段可能返回 null,表示取不到有效值。 |
| ResourceGroupType | String | 资源组类型,console/ default 注意:此字段可能返回 null,表示取不到有效值。 示例值:default |
| EngineNetworkId | String | 引擎网络ID 注意:此字段可能返回 null,表示取不到有效值。 |
| NetworkConfigNames | Array of String | 网络配置名称 注意:此字段可能返回 null,表示取不到有效值。 |
| FrameType | String | AI类型资源组的框架类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:python |
| ImageType | String | AI类型资源组的镜像类型,内置:bulit-in,自定义:custom 注意:此字段可能返回 null,表示取不到有效值。 示例值:bulit-in |
| ImageName | String | 镜像名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:image-xxx |
| ImageVersion | String | 镜像id 注意:此字段可能返回 null,表示取不到有效值。 示例值:imageid-xxx |
| Size | Integer | AI资源组的可用资源上限 注意:此字段可能返回 null,表示取不到有效值。 示例值:64 |
| IsDefault | Boolean | 是否是默认资源组 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| ResourceGroupScene | String | 资源组场景 注意:此字段可能返回 null,表示取不到有效值。 示例值:SparkSQL |
| PythonCuSpec | String | python类型资源组python单机节点资源上限,该值要小于资源组的资源上限.small:1cu medium:2cu large:4cu xlarge:8cu 4xlarge:16cu 8xlarge:32cu 16xlarge:64cu,如果是高内存型资源,在类型前面加上m. 注意:此字段可能返回 null,表示取不到有效值。 示例值:small |
| SparkSpecMode | String | Spark类型资源组资源配置模式,fast:快速模式,custom:自定义模式 注意:此字段可能返回 null,表示取不到有效值。 示例值:custom |
| SparkSize | Integer | Spark类型资源组资源上限 注意:此字段可能返回 null,表示取不到有效值。 示例值:64 |
| SparkMinSize | Integer | Spark类型资源组资源最小值 注意:此字段可能返回 null,表示取不到有效值。 示例值:16 |
| PublicDomain | String | 自定义镜像容器镜像服务domain 名称 示例值:test.tencentcloudcr.com |
| RegistryId | String | 自定义镜像容器镜像服务tcr实例id 示例值:tcr-xxxxx |
| RegionName | String | 容器镜像服务tcr所在地域 示例值:ap-beijing |
| LaunchTime | String | 资源组启动耗时 示例值:1min30s |
StatementInformation
statement信息
被如下接口引用:CreateSparkSessionBatchSQL。
| 名称 | 类型 | 描述 |
|---|---|---|
| TaskId | String | SQL任务唯一ID 示例值:09ei23ea-d6c0-4cd9-bbed-2e909jef04dc |
| SQL | String | SQL内容 示例值:select 1; |
StatementOutput
notebook session statement输出信息。
被如下接口引用:CreateNotebookSessionStatement, DescribeNotebookSessionStatement。
| 名称 | 类型 | 描述 |
|---|---|---|
| ExecutionCount | Integer | 执行总数 示例值:1 |
| Data | Array of KVPair | Statement数据 注意:此字段可能返回 null,表示取不到有效值。 示例值:["key":"testKey","value":"testValue"] |
| Status | String | Statement状态:ok,error 示例值:ok |
| ErrorName | String | 错误名称 示例值:compute fail |
| ErrorValue | String | 错误类型 注意:此字段可能返回 null,表示取不到有效值。 示例值:InternalError |
| ErrorMessage | Array of String | 错误堆栈信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:["internal Error"] |
| SQLResult | String | SQL类型任务结果返回 示例值:{"application/json":{ "schema":{ "type":"struct", "fields":[ {"name":"1", "type":"integer", "nullable":false, "metadata"{ } } ] }}} |
StreamingStatistics
spark流任务统计信息
被如下接口引用:DescribeSparkAppJob, DescribeSparkAppJobs。
| 名称 | 类型 | 描述 |
|---|---|---|
| StartTime | String | 任务开始时间 示例值:2022-05-16 00:00:00 |
| Receivers | Integer | 数据接收器数 示例值:1 |
| NumActiveReceivers | Integer | 运行中的接收器数 示例值:1 |
| NumInactiveReceivers | Integer | 不活跃的接收器数 示例值:0 |
| NumActiveBatches | Integer | 运行中的批数 示例值:1 |
| NumRetainedCompletedBatches | Integer | 待处理的批数 示例值:1 |
| NumTotalCompletedBatches | Integer | 已完成的批数 示例值:1 |
| AverageInputRate | Float | 平均输入速率 示例值:0.2 |
| AverageSchedulingDelay | Float | 平均等待时长 示例值:1.0 |
| AverageProcessingTime | Float | 平均处理时长 示例值:2.0 |
| AverageTotalDelay | Float | 平均延时 示例值:3.0 |
TCHouseD
Doris数据源详细信息
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InstanceId | String | 否 | 数据源实例的唯一ID 示例值:datasource-test |
| InstanceName | String | 否 | 数据源名称 示例值:test_datasource |
| JdbcUrl | String | 否 | 数据源的JDBC 示例值:jdbc:mysql// |
| User | String | 否 | 用于访问数据源的用户 示例值:root |
| Password | String | 否 | 数据源访问密码,需要base64编码 示例值:xaskdowq+= |
| Location | DatasourceConnectionLocation | 否 | 数据源的VPC和子网信息 注意:此字段可能返回 null,表示取不到有效值。 |
| DbName | String | 否 | 默认数据库名 示例值:default |
| AccessInfo | String | 否 | 访问信息 示例值:"[{"address":"10.0.0.6:9030","protocol":"tcp"},{"address":"10.0.0.6:8030","protocol":"http"},{"address":"10.0.0.6:8040","protocol":"be_http"}]" |
TCHousePInfo
TCHouseP 结构
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InstanceId | String | 否 | 实例id 注意:此字段可能返回 null,表示取不到有效值。 示例值:cdwpg-3xngvacw |
| InstanceName | String | 否 | 实例名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:friend |
| JdbcUrl | String | 否 | JdbcUrl 注意:此字段可能返回 null,表示取不到有效值。 示例值:jdbc:postgresql://10.0.0.4:9000 |
| User | String | 否 | 用户名 注意:此字段可能返回 null,表示取不到有效值。 示例值:dbadmin |
| Password | String | 否 | 密码 注意:此字段可能返回 null,表示取不到有效值。 示例值:123456myq! |
| Location | DatasourceConnectionLocation | 否 | 地址 注意:此字段可能返回 null,表示取不到有效值。 |
| DbName | String | 否 | 数据库名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:postgres |
| AccessInfo | String | 否 | 地址信息 注意:此字段可能返回 null,表示取不到有效值。 示例值:"[{"address":"10.0.0.4:9000","protocol":"tcp"}]" |
TColumn
表字段描述信息
被如下接口引用:AssignMangedTableProperties, CreateInternalTable, CreateTcIcebergTable, GenerateCreateMangedTableSql, GenerateInternalTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 是 | 字段名称 示例值:column1 |
| Type | String | 是 | 字段类型 示例值:string |
| Comment | String | 否 | 字段描述 示例值:test comment |
| Default | String | 否 | 字段默认值 示例值:ddefault value |
| NotNull | Boolean | 否 | 字段是否是非空 示例值:true |
| Precision | Integer | 否 | 表示整个 numeric 的长度,取值1-38 示例值:10 |
| Scale | Integer | 否 | 表示小数部分的长度 Scale小于Precision 示例值:2 |
| Position | Integer | 否 | 字段位置,小的在前 示例值:1 |
| IsPartition | Boolean | 否 | 是否为分区字段 示例值:false |
TPartition
表分区字段信息
被如下接口引用:AssignMangedTableProperties, CreateInternalTable, CreateTcIcebergTable, GenerateCreateMangedTableSql, GenerateInternalTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 是 | 字段名称 示例值:patition1 |
| Type | String | 否 | 字段类型 示例值:string |
| Comment | String | 否 | 字段描述 示例值:default comment |
| PartitionType | String | 否 | 分区类型(已废弃) 示例值:string |
| PartitionFormat | String | 否 | 分区格式(已废弃) 示例值:bucket |
| PartitionDot | Integer | 否 | 分区分隔数(已废弃) 示例值:2 |
| Transform | String | 否 | 分区转换策略 示例值:bucket |
| TransformArgs | Array of String | 否 | 策略参数 示例值:2 |
TableBaseInfo
数据表配置信息
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateTable, CreateTcIcebergTable, DeleteTable, DescribeTable, DescribeTables, GenerateCreateMangedTableSql, GenerateInternalTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DatabaseName | String | 是 | 该数据表所属数据库名字 示例值:database1 |
| TableName | String | 是 | 数据表名字 示例值:table |
| DatasourceConnectionName | String | 否 | 该数据表所属数据源名字 示例值:CosDataCatalog |
| TableComment | String | 否 | 该数据表备注 注意:此字段可能返回 null,表示取不到有效值。 示例值:tb1501 描述aaa |
| Type | String | 否 | 具体类型,表or视图 示例值:table |
| TableFormat | String | 否 | 数据格式类型,hive,iceberg等 示例值:hive |
| UserAlias | String | 否 | 建表用户昵称 示例值:aliaName |
| UserSubUin | String | 否 | 建表用户ID 示例值:100019878767 |
| SmartPolicy | SmartPolicy | 否 | 智能数据治理配置项 注意:此字段可能返回 null,表示取不到有效值。 |
| PrimaryKeys | Array of String | 否 | T-ICEBERG表的主键 注意:此字段可能返回 null,表示取不到有效值。 示例值:id |
TableExpirationPolicy
表过期策略
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Enabled | Boolean | 是 | 是否启用策略 示例值:true |
| Expiration | Integer | 是 | 表过期时间,单位:天 示例值:30 |
TableInfo
返回数据表的相关信息。
被如下接口引用:CreateTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| TableBaseInfo | TableBaseInfo | 是 | 数据表配置信息。 |
| DataFormat | DataFormat | 是 | 数据表格式。每次入参可选如下其一的KV结构,[TextFile,CSV,Json, Parquet, ORC, AVRD]。 |
| Columns | Array of Column | 是 | 数据表列信息。 |
| Partitions | Array of Partition | 是 | 数据表分块信息。 |
| Location | String | 是 | 数据存储路径。当前仅支持cos路径,格式如下:cosn://bucket-name/filepath。 示例值:cosn://test-bucket-1123423/csvdata/ |
TableResponseInfo
查询表信息对象
被如下接口引用:DescribeTable, DescribeTables。
| 名称 | 类型 | 描述 |
|---|---|---|
| TableBaseInfo | TableBaseInfo | 数据表基本信息。 示例值:{"name":"test"} |
| Columns | Array of Column | 数据表列信息。 注意:此字段可能返回 null,表示取不到有效值。 示例值:[{"name":"aa"}] |
| Partitions | Array of Partition | 数据表分块信息。 注意:此字段可能返回 null,表示取不到有效值。 示例值:[{"day":"a"}] |
| Location | String | 数据存储路径。 示例值:cosn://test-bucket-123242/csvdata/ |
| Properties | Array of Property | 数据表属性信息。 注意:此字段可能返回 null,表示取不到有效值。 示例值:[{"day":"a"}] |
| ModifiedTime | String | 数据表更新时间, 单位: ms。 示例值:1611579344000 |
| CreateTime | String | 数据表创建时间,单位: ms。 示例值:1611579344000 |
| InputFormat | String | 数据格式。 示例值:org.apache.hadoop.hive.ql.io.parquet.MapredParquetInputFormat |
| StorageSize | Integer | 数据表存储大小(单位:Byte) 示例值:1024 |
| RecordCount | Integer | 数据表行数 示例值:10 |
| MapMaterializedViewName | String | xxxx 示例值:DataLakeCatalog |
| HeatValue | Integer | 访问热点 示例值:1 |
| InputFormatShort | String | InputFormat的缩写 示例值:orc |
Tag
标签
被如下接口引用:CancelTrainingJobInstance, CopyJobSpec, CreateInferenceModel, CreateInferenceService, CreateJobSpec, CreateLab, CreateMlflowServer, CreateRayCluster, CreateTrainingJobInstance, DescribeClusterGroupClusters, DescribeMlflowServer, DescribeTrainingJobInstance, DescribeTrainingJobSpec, GetInferenceModel, GetInferenceService, GetJobSpec, GetLabDetail, GetRayCluster, GetRayJob, ListInferenceModels, ListJobSpecs, ListJobsBySpec, ListLabs, ListMlflowServerTrainingInstances, ListMlflowServers, ListRayClusterJobs, ListRayClusters, ListRayJobs, ListTrainingJobInstance, ListTrainingJobSpec, ModifyClusterPriority, ModifyLabPriority, ModifyTrainingJobSpec, RestartInferenceService, ResumeTrainingJobInstance, RunJobSpec, StartLab, StartMlflowServer, StartRayCluster, StopInferenceService, StopLab, StopRayCluster, SubmitTrainingJob, UpdateInferenceModel, UpdateJobSpec, UpdateJobSpecPriority, UpdateLab, UpdateRayCluster, UpdateRayJobPriority。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| TagKey | String | 否 | 标签键 示例值:env |
| TagValue | String | 否 | 标签值 示例值:prod |
TagInfo
标签对信息
被如下接口引用:CreateDataEngine, DescribeDataEngine, DescribeDataEngines, DescribeLakeFsInfo。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| TagKey | String | 否 | 标签键 示例值:tagKey1 |
| TagValue | String | 否 | 标签值 示例值:tagValue1 |
Task
任务类型,任务如SQL查询等。
被如下接口引用:CreateTask。
TaskFullRespInfo
任务实例。
被如下接口引用:DescribeTaskDetail, DescribeTaskList。
| 名称 | 类型 | 描述 |
|---|---|---|
| DatabaseName | String | 任务所属Database的名称。 示例值:database1 |
| DataAmount | Integer | 任务数据量。 示例值:1024 |
| Id | String | 任务Id。 示例值:89570c65-49de-4bbd-ac0a-a67c724fc80f |
| UsedTime | Integer | 计算耗时,单位: ms 示例值:60000 |
| OutputPath | String | 任务输出路径。 示例值:cosn://test-bucket-123434324234/result/ |
| CreateTime | String | 任务创建时间。 示例值:1611646962000 |
| State | Integer | 任务状态:0 初始化, 1 执行中, 2 执行成功,3 数据写入中,4 排队中。-1 执行失败,-3 已取消。 示例值:2 |
| SQLType | String | 任务SQL类型,DDL|DML等 示例值:DDL |
| SQL | String | 任务SQL语句 示例值:U0VMRUNUICogRlJPTSBgdGVzdGA7 |
| ResultExpired | Boolean | 结果是否过期。 示例值:false |
| RowAffectInfo | String | 数据影响统计信息。 示例值:500 rows selected (0.077 seconds) |
| DataSet | String | 任务结果数据表。 注意:此字段可能返回 null,表示取不到有效值。 示例值:{"Schema":["name","age"],"Data":[{"name":"29","age":"Michael"}]} |
| Error | String | 失败信息, 例如:errorMessage。该字段已废弃。 示例值:errorMessage |
| Percentage | Integer | 任务执行进度num/100(%) 示例值:100 |
| OutputMessage | String | 任务执行输出信息。 示例值:Invalid compression codec: ,Available codecs are none,bzip2,gzip,deflate. |
| TaskType | String | 执行SQL的引擎类型 示例值:SparkBatchSQL |
| ProgressDetail | String | 任务进度明细 注意:此字段可能返回 null,表示取不到有效值。 示例值:[{"jobId":1,"stages":[{"stageId":1,"numTasks":3,"numActiveTasks" |
| UpdateTime | String | 任务结束时间 注意:此字段可能返回 null,表示取不到有效值。 示例值:1611646962000 |
| DataEngineId | String | 计算资源id 注意:此字段可能返回 null,表示取不到有效值。 示例值:resource-1gghpd1t |
| OperateUin | String | 执行sql的子uin 注意:此字段可能返回 null,表示取不到有效值。 示例值:**** |
| DataEngineName | String | 计算资源名字 注意:此字段可能返回 null,表示取不到有效值。 示例值:shared_presto |
| InputType | String | 导入类型是本地导入还是cos 注意:此字段可能返回 null,表示取不到有效值。 示例值:local |
| InputConf | String | 导入配置 注意:此字段可能返回 null,表示取不到有效值。 示例值:[{"Key":"paths","Value":"lakefs://20000003366d155f79a522c8349496 |
| DataNumber | Integer | 数据条数 注意:此字段可能返回 null,表示取不到有效值。 示例值:925 |
| CanDownload | Boolean | 查询数据能不能下载 注意:此字段可能返回 null,表示取不到有效值。 示例值:false |
| UserAlias | String | 用户别名 注意:此字段可能返回 null,表示取不到有效值。 示例值:testname |
| SparkJobName | String | spark应用作业名 注意:此字段可能返回 null,表示取不到有效值。 示例值:spark_app |
| SparkJobId | String | spark应用作业Id 注意:此字段可能返回 null,表示取不到有效值。 示例值:batch_sdafa |
| SparkJobFile | String | spark应用入口jar文件 注意:此字段可能返回 null,表示取不到有效值。 示例值:example.jar |
| UiUrl | String | spark ui url 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://dlc-spark-ui.cloud.tencent.com/history/spark-893c606226b |
| TotalTime | Integer | 任务耗时,单位: ms 注意:此字段可能返回 null,表示取不到有效值。 示例值:80000 |
| CmdArgs | String | spark app job执行task的程序入口参数 注意:此字段可能返回 null,表示取不到有效值。 示例值:spark.sql.shuffle.partitions |
| ImageVersion | String | 集群镜像大版本名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:SuperSQL P 1.0 |
| DriverSize | String | driver规格:small,medium,large,xlarge;内存型(引擎类型):m.small,m.medium,m.large,m.xlarge 注意:此字段可能返回 null,表示取不到有效值。 示例值:small |
| ExecutorSize | String | executor规格:small,medium,large,xlarge;内存型(引擎类型):m.small,m.medium,m.large,m.xlarge 注意:此字段可能返回 null,表示取不到有效值。 示例值:small |
| ExecutorNums | Integer | 指定executor数量,最小值为1,最大值小于集群规格 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| ExecutorMaxNumbers | Integer | 指定executor max数量(动态配置场景下),最小值为1,最大值小于集群规格(当ExecutorMaxNumbers小于ExecutorNums时,改值设定为ExecutorNums) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1 |
| CommonMetrics | CommonMetrics | 任务公共指标数据 注意:此字段可能返回 null,表示取不到有效值。 |
| SparkMonitorMetrics | SparkMonitorMetrics | spark任务指标数据 注意:此字段可能返回 null,表示取不到有效值。 |
| PrestoMonitorMetrics | PrestoMonitorMetrics | presto任务指标数据 注意:此字段可能返回 null,表示取不到有效值。 |
| ResultFormat | String | 结果文件格式:默认为csv 注意:此字段可能返回 null,表示取不到有效值。 示例值:csv |
| EngineTypeDetail | String | 引擎类型,SparkSQL:SparkSQL 引擎;SparkBatch:Spark作业引擎;PrestoSQL:Presto引擎 注意:此字段可能返回 null,表示取不到有效值。 示例值:SparkSQL |
| ResourceGroupName | String | spark引擎资源组名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:ResourceGroupName1 |
| Source | String | 任务来源信息,如thirdPartyApi,dataExploration, sparkAppTask等 示例值:thirdPartyApi |
| SourceExtra | String | 子渠道信息,一般由第三方调用定义 示例值:4c022a43-9ed6-46cc-836c-44994a0bf959 |
| CreatorUin | String | 创建人uin 示例值:100039223798 |
| CreatorAlias | String | 创建人名字 示例值:小明 |
| CustomizedConf | String | 引擎参数 示例值:query_max_execution_time=6m |
| TaskTimeSum | Integer | 单位秒,累计 CPU* 秒 ( 累计 CPU * 时 = 累计 CPU* 秒/ 3600),统计参与计算所用 Spark Executor 每个 core 的 CPU 执行时长总和 示例值:215 |
| StageStartTime | Integer | 引擎执行时间 示例值:1736009241127 |
| InputRecordsSum | Integer | 数据扫描条数 示例值:1210 |
| AnalysisStatusType | Integer | 健康状态 示例值:1 |
| OutputRecordsSum | Integer | 输出总行数 示例值:2087 |
| OutputBytesSum | Integer | 输出总大小 示例值:24 |
| OutputFilesNum | Integer | 输出文件个数 示例值:7 |
| OutputSmallFilesNum | Integer | 输出小文件个数 示例值:5 |
| ShuffleReadRecordsSum | Integer | 数据shuffle行数 示例值:502 |
| ShuffleReadBytesSum | Integer | 数据shuffle大小 示例值:67 |
| SparkAppId | String | spark作业id 示例值:batch_8d1fa0f3-4da7-4bd2-a3d0-72e83582e70b |
| TaskCategory | String | 任务大类,DLC2.0中任务区分为两大类,sql任务和作业任务 示例值:SQL |
| TaskName | String | 任务名称 示例值:import_20241126212510_f2a65wk1 |
| EngineType | String | 引擎类型,用做任务详情页跳转引擎tab 示例值:spark |
| EngineHasListenerConfig | Boolean | 引擎是否支持洞察数据采集 示例值:true |
| ResourceGroupId | String | spark引擎资源组id 示例值:default-rg-js8kdi6xzt |
| JobTimeSum | Integer | 任务计算耗时 示例值:6000 |
| LaunchTime | String | 任务启动耗时 示例值:1min30s |
| GpuDriverSize | Integer | Gpu Driver 规格 示例值:1 |
| GpuExecutorSize | Integer | Gpu Executor 规格 示例值:1 |
| ShuffleWriteBytesSum | Integer | ShuffleWrite数据量 示例值:1000 |
| ActiveCore | Integer | 活跃core 示例值:1 |
| QueueTime | Integer | 排队时间 单位:毫秒 示例值:1000 |
| ResourceGroupType | String | 资源组类型 示例值:SparkSQL |
TaskMonitorInfo
任务监控信息
被如下接口引用:DescribeTaskMonitorInfos。
| 名称 | 类型 | 描述 |
|---|---|---|
| TaskId | String | 任务id 示例值:3c2c581afe4d11efbde1525400b3a056 |
| HouseName | String | 引擎名称 示例值:engine1 |
| QuerySQL | String | sql语句 示例值:select 1; |
| CreateTime | String | 任务时间 示例值:2023-08-10T12:35:02.123Z |
| UsedTime | String | 执行时间 示例值:100 |
| DataAmount | String | 数据扫描量 示例值:1024 |
| QueryStats | String | 指标信息 示例值:{"elapsedTime": "5.34s", "executionTime": "4.89s", "cumulativeUserMemory": 1234567.89, "peakUserMemoryReservation": "64MB", "totalBytes": "1.23MB", "totalRows": 1000 } |
TaskOptions
各模型类型对应的可选任务列表
被如下接口引用:DescribeModelTaskOptions。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ModelType | String | 否 | 模型类型 示例值:LLM |
| Tasks | Array of String | 否 | 任务场景 示例值:["Text Generation"] |
TaskResponseInfo
任务实例。
被如下接口引用:DescribeSparkAppTasks, DescribeTasks。
| 名称 | 类型 | 描述 |
|---|---|---|
| DatabaseName | String | 任务所属Database的名称。 示例值:database1 |
| DataAmount | Integer | 任务数据量。 示例值:1024 |
| Id | String | 任务Id。 示例值:89570c65-49de-4bbd-ac0a-a67c724fc80f |
| UsedTime | Integer | 计算耗时,单位: ms 示例值:60000 |
| OutputPath | String | 任务输出路径。 示例值:cosn://test-bucket-1/result/ |
| CreateTime | String | 任务创建时间。 示例值:1611646962000 |
| State | Integer | 任务状态:0 初始化, 1 执行中, 2 执行成功,3 数据写入中,4 排队中。-1 执行失败,-3 已取消。 示例值:2 |
| SQLType | String | 任务SQL类型,DDL|DML等 示例值:DDL |
| SQL | String | 任务SQL语句 示例值:U0VMRUNUICogRlJPTSBgdGVzdGA7 |
| ResultExpired | Boolean | 结果是否过期。 示例值:false |
| RowAffectInfo | String | 数据影响统计信息。 示例值:500 rows selected (0.077 seconds) |
| DataSet | String | 任务结果数据表。 示例值:{"Schema":["name","age"],"Data":[{"name":"29","age":"Michael"}]} |
| Error | String | 失败信息, 例如:errorMessage。该字段已废弃。 示例值:errorMessage |
| Percentage | Integer | 任务执行进度num/100(%) 示例值:100 |
| OutputMessage | String | 任务执行输出信息。 示例值:Invalid compression codec: ,Available codecs are none,bzip2 |
| TaskType | String | 执行SQL的引擎类型 示例值:SparkBatchSQL |
| ProgressDetail | String | 任务进度明细 示例值:[{"jobId":1,"stages":[{"stageId":1,"numTasks":3,"numActiveTasks" |
| UpdateTime | String | 任务结束时间 示例值:1611646962000 |
| DataEngineId | String | 计算资源id 示例值:resource-1gghpd1t |
| OperateUin | String | 执行sql的子uin 示例值:**** |
| DataEngineName | String | 计算资源名字 示例值:shared_presto |
| InputType | String | 导入类型是本地导入还是cos 示例值:local |
| InputConf | String | 导入配置 示例值:[{"Key":"paths","Value":"lakefs://20000003366d155f79a522c8349496 |
| DataNumber | Integer | 数据条数 示例值:925 |
| CanDownload | Boolean | 查询数据能不能下载 示例值:false |
| UserAlias | String | 用户别名 示例值:testname |
| SparkJobName | String | spark应用作业名 示例值:spark_app |
| SparkJobId | String | spark应用作业Id 示例值:batch_sdafa |
| SparkJobFile | String | spark应用入口jar文件 示例值:example.jar |
| UiUrl | String | spark ui url 示例值:https://dlc-spark-ui.cloud.tencent.com/history/spark-893c606226b |
| TotalTime | Integer | 任务耗时,单位: ms 示例值:80000 |
| CmdArgs | String | spark app job执行task的程序入口参数 示例值:spark.sql.shuffle.partitions |
| ImageVersion | String | 集群镜像大版本名称 示例值:SuperSQL P 1.0 |
| DriverSize | String | driver规格:small,medium,large,xlarge;内存型(引擎类型):m.small,m.medium,m.large,m.xlarge 示例值:small |
| ExecutorSize | String | executor规格:small,medium,large,xlarge;内存型(引擎类型):m.small,m.medium,m.large,m.xlarge 示例值:small |
| ExecutorNums | Integer | 指定executor数量,最小值为1,最大值小于集群规格 示例值:1 |
| ExecutorMaxNumbers | Integer | 指定executor max数量(动态配置场景下),最小值为1,最大值小于集群规格(当ExecutorMaxNumbers小于ExecutorNums时,改值设定为ExecutorNums) 示例值:1 |
| CommonMetrics | CommonMetrics | 任务公共指标数据 注意:此字段可能返回 null,表示取不到有效值。 |
| SparkMonitorMetrics | SparkMonitorMetrics | spark任务指标数据 注意:此字段可能返回 null,表示取不到有效值。 |
| PrestoMonitorMetrics | PrestoMonitorMetrics | presto任务指标数据 注意:此字段可能返回 null,表示取不到有效值。 |
| ResultFormat | String | 结果文件格式:默认为csv 示例值:csv |
| EngineTypeDetail | String | 引擎类型,SparkSQL:SparkSQL 引擎;SparkBatch:Spark作业引擎;PrestoSQL:Presto引擎 示例值:SparkSQL |
| ResourceGroupName | String | spark引擎资源组名称 示例值:ResourceGroupName1 |
| JobTimeSum | Integer | 任务执行耗时 示例值:1206 |
TaskResultInfo
任务结果信息。
被如下接口引用:DescribeTaskResult。
| 名称 | 类型 | 描述 |
|---|---|---|
| TaskId | String | 任务唯一ID 示例值:fdd9c5fa21ca11eca6fb5254006c64af |
| DatasourceConnectionName | String | 数据源名称,当前任务执行时候选中的默认数据源 示例值:COSDataCatalog |
| DatabaseName | String | 数据库名称,当前任务执行时候选中的默认数据库 示例值:database1 |
| SQL | String | 当前执行的SQL,一个任务包含一个SQL 示例值:select * from test limit 10; |
| SQLType | String | 执行任务的类型,现在分为DDL、DML、DQL 示例值:DQL |
| State | Integer | 任务当前的状态,0:初始化 1:任务运行中 2:任务执行成功 3:数据写入中 4:排队中 -1:任务执行失败 -3:用户手动终止 。只有任务执行成功的情况下,才会返回任务执行的结果 示例值:2 |
| DataAmount | Integer | 扫描的数据量,单位byte 示例值:1024 |
| UsedTime | Integer | 计算耗时,单位: ms 示例值:42 |
| OutputPath | String | 任务结果输出的COS桶地址 示例值:cosn://dlc-nj-125849872/test/DLCQueryResults/2021/09/ |
| CreateTime | String | 任务创建时间,时间戳 示例值:1632991895728 |
| OutputMessage | String | 任务执行信息,成功时返回success,失败时返回失败原因 示例值:success |
| RowAffectInfo | String | 被影响的行数 示例值:OK, No rows affected (0.000000 seconds) |
| ResultSchema | Array of Column | 结果的schema信息 注意:此字段可能返回 null,表示取不到有效值。 |
| ResultSet | String | 结果信息,反转义后,外层数组的每个元素为一行数据 示例值:[["3","kk"],["3","kk"]] |
| NextToken | String | 分页信息,如果没有更多结果数据,nextToken为空 示例值:nextMarker=\u0026nextKey=test/DLCQueryResults/2021/10/15/*** |
| Percentage | Integer | 任务执行进度num/100(%) 示例值:100 |
| ProgressDetail | String | 任务进度明细 示例值:[{"jobId":1,"stages":[{"stageId":1,"numTasks":3,"numActiveTasks" |
| DisplayFormat | String | 控制台展示格式。table:表格展示 text:文本展示 示例值:table |
| TotalTime | Integer | 任务耗时,单位: ms 示例值:1000 |
| QueryResultTime | Float | 获取结果消耗的时间 示例值:150.1 |
| ResultSetEncode | String | base64 编码结果集 示例值:fd19j9u1jc1j |
TasksInfo
批量顺序执行任务集合
被如下接口引用:CreateTasks, CreateTasksInOrder。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| TaskType | String | 是 | 任务类型,SQLTask:SQL查询任务。SparkSQLTask:Spark SQL查询任务 示例值:SQLTask |
| FailureTolerance | String | 是 | 容错策略。Proceed:前面任务出错/取消后继续执行后面的任务。Terminate:前面的任务出错/取消之后终止后面任务的执行,后面的任务全部标记为已取消。 示例值:Proceed |
| SQL | String | 是 | base64加密后的SQL语句,用";"号分隔每个SQL语句,一次最多提交50个任务。严格按照前后顺序执行 示例值:U0VMRUNUICogRlJPTSBgdGVzdGA7 |
| Config | Array of KVPair | 否 | 任务的配置信息,当前仅支持SparkSQLTask任务。 |
| Params | Array of KVPair | 否 | 任务的用户自定义参数信息 |
TasksOverview
任务概览
被如下接口引用:DescribeTasks, DescribeTasksOverview。
| 名称 | 类型 | 描述 |
|---|---|---|
| TaskQueuedCount | Integer | 正在排队的任务个数 示例值:1 |
| TaskInitCount | Integer | 初始化的任务个数 示例值:1 |
| TaskRunningCount | Integer | 正在执行的任务个数 示例值:1 |
| TotalTaskCount | Integer | 当前时间范围的总任务个数 示例值:1 |
TccHive
TccHive数据结构
被如下接口引用:AssociateDatasourceHouse, CreateDatasourceConnection。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InstanceId | String | 否 | 实例ID 示例值:tcc-wiot2q1i |
| InstanceName | String | 否 | 实例名称 示例值:测试实例 |
| EndpointServiceId | String | 否 | 终端节点服务ID 示例值:vpcs-9shj2xs1 |
| MetaStoreUrl | String | 否 | thrift连接地址 示例值:thrift://127.0.0.1:7004 |
| HiveVersion | String | 否 | hive版本 示例值:3.1.3 |
| TccConnection | NetWork | 否 | 网络信息 示例值:复杂类型 |
| HmsEndpointServiceId | String | 否 | Hms终端节点服务ID 示例值:vpcsvc-6jsiek7s |
TextFile
文本格式
被如下接口引用:CreateTable。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Format | String | 否 | 文本类型,本参数取值为TextFile。 示例值:TextFile |
| Regex | String | 否 | 处理文本用的正则表达式。 示例值:"("[^]]") ("[0-9]") (-|[^ ]*)" |
TrainingJobInstance
训练作业实例详情
被如下接口引用:CancelTrainingJobInstance, CreateTrainingJobInstance, DescribeTrainingJobInstance, ListMlflowServerTrainingInstances, ListTrainingJobInstance, ResumeTrainingJobInstance。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| InstanceId | String | 否 | 实例 ID(即 RayJob UUID) 示例值:rayjob-20260804155605-tmr5 |
| SpecId | String | 否 | 关联配置 ID 示例值:raytrain-spec-tj8i36-q65j |
| SpecName | String | 否 | 配置名称 示例值:sft-train80-qzzhu_checkpoints_v2_Clone |
| Priority | Integer | 否 | 作业优先级(1-9,数字越大优先级越高) 示例值:6 |
| Status | String | 否 | 综合状态 示例值:SUBMITTING |
| ErrorMessage | String | 否 | 错误信息 示例值:Job rayjob-20260803211559-51zu failed on partition=dlc-p-axzbtgug: xxx |
| JobCreateTime | Integer | 否 | RayJob 实际启动时间(毫秒) 示例值:1785830167864 |
| JobRunningTime | Integer | 否 | RayJob 运行时长(毫秒) 示例值:113136 |
| HistoryUrl | String | 否 | Ray Dashboard History 链接 示例值:https://cls-pdb9lgk2.tcray-gateway.ap-guangzhou.cloud.tencent.com/dlc-p-axzbtgug/rayjob-20260804155605-tmr5/ |
| Creator | String | 否 | 创建人 示例值:700002655693 |
| CreateTime | Integer | 否 | 创建时间(毫秒时间戳) 示例值:1785830165062 |
| ResourcePartitionId | String | 否 | 资源分区 ID 示例值:dlc-p-axzbtgug |
| ResourcePartitionName | String | 否 | 资源分区名称 示例值:gpu-t4 |
| Queue | String | 否 | 队列名称 示例值:default |
| RuntimeEnv | String | 否 | 提交时 runtime_env JSON 示例值:{"env_vars":{"MLFLOW_TRACKING_URI":"xxx"} |
| Entrypoint | String | 否 | 提交时 entrypoint 示例值:python /workspace/ray_post_training_entry.py --num-workers 1 --gpus-per-worker 1 --cpus-per-worker 20 |
| Image | String | 否 | 提交时镜像 示例值:ccr.ccs.tencentyun.com/emr-image/tcray:2.55.1-py311-cu125-torch2.10.0-tfm5.6 |
| ResourceConfig | String | 否 | 提交时资源配置 JSON 示例值:{"Head":{"Name":"Head","PodCpu":2,"PodMem":8,"GpuType":"","GpuNum":0,"Envs":[],"Labels":[],"ResourcesLabels":[],"ResourceType":"CPU","InstanceType":"","Spec":2,"BillingItem":"xxx","PodNum":1,"HighAvailability":false},"Worker":[]} |
| Catalog | String | 否 | 提交时存储卷挂载配置 JSON 示例值:{"COSVolumes":[{"Region":"ap-guangzhou","Bucket":"xx","VolumeSubPath":"/datasets","SubPathMode":null,"SubPath":null,"MountPath":"/datas","PersistVolumeName":"xx","VolumeMountMode":null,"Source":"dataset","Origin":"platform_upload"}]} |
| AdvancedOptions | String | 否 | 提交时高级参数 JSON 示例值:{"spec.rayClusterSpec.headGroupSpec.template.spec.initContainers":"[]"} |
| Kind | String | 否 | 训练子类型快照(LAB / CUSTOM_CODE / POST_TRAINING) 示例值:POST_TRAINING |
| CodePackageUrl | String | 否 | 提交时代码包 URL 示例值:job-packages/260200065/20260724134025/b5555d51-563c-4519-b5b5-c57c53e6b3eb.zip |
| MlFlowConfig | String | 否 | 提交时 MLflow 配置 JSON 示例值:{"MlFlowMode":"local"} |
| CheckpointMountInfo | CheckpointMountInfo | 否 | Checkpoint 挂载摘要(实例级) |
| Mode | String | 否 | 训练方式(sft / dpo / cpt / grpo),仅 POST_TRAINING 有值 示例值:dpo |
| BaseModelUid | String | 否 | 基础模型 modelUid(仅 POST_TRAINING 有值,用于关联推理模型仓库) 示例值:m-qwen35-zerodot8b-6a705b58-dc17 |
| BaseModelName | String | 否 | 基础模型名称(仅 POST_TRAINING 有值) 示例值:Qwen3.5-4B |
| Tags | Array of Tag | 否 | 标签列表(TagKey-TagValue) |
| Datasets | Array of DatasetMount | 否 | 创建实例时的数据集挂载列表快照(List<DatasetMount>,仅详情返回) |
| Checkpoint | CheckpointConfig | 否 | 创建实例时的 Checkpoint 产出配置快照(仅详情返回) |
| TuningParams | TrainingTuningParams | 否 | 创建实例时的调优参数快照(仅 POST_TRAINING,仅详情返回) |
| ResumeTraining | Boolean | 否 | 创建实例时的断点续训意图声明快照(仅详情返回) 示例值:true |
TrainingJobSpec
训练作业配置
被如下接口引用:DescribeTrainingJobSpec, ListTrainingJobSpec, ModifyTrainingJobSpec, SubmitTrainingJob。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| SpecId | String | 否 | 训练作业配置 ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:raytrain-spec-tjdv45-r92q |
| SpecName | String | 否 | 训练作业配置名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:sft_cfs01 |
| Description | String | 否 | 配置描述 注意:此字段可能返回 null,表示取不到有效值。 示例值:sft_cfs01 |
| Kind | String | 否 | 提交模式(LAB / CUSTOM_CODE / POST_TRAINING / UNKNOWN) 注意:此字段可能返回 null,表示取不到有效值。 示例值:LAB |
| Entrypoint | String | 否 | 启动命令 注意:此字段可能返回 null,表示取不到有效值。 示例值:bash -c 'cd sft_demo && python -m sft_demo.train_local --storage-path /shared' |
| Image | String | 否 | 镜像地址 注意:此字段可能返回 null,表示取不到有效值。 示例值:ccr.ccs.tencentyun.com/ray-nexus/post-training:latest |
| ImagePullType | String | 否 | 镜像拉取类型(BuiltIn / Custom / CustomCcr) 示例值:BuiltIn |
| ImagePullPolicy | String | 否 | 镜像拉取策略(Always / IfNotPresent / Never) 示例值:IfNotPresent |
| CodePackageUrl | String | 否 | 代码包 COS URL 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://common-job-packages-251233710.cos.ap-guangzhou.myqcloud.com/job-packages/260200065/20260807125615/f6fee416-ab5c-4eaa-ac76-1cdbe52ebd16.zip/sft_demo.zip |
| RuntimeEnv | String | 否 | Ray runtime_env 配置 JSON 注意:此字段可能返回 null,表示取不到有效值。 示例值:{"env_vars":{},"pip":[]} |
| ResourceConfigId | String | 否 | 资源配置模板 ID 示例值:0453d291-7b46-4b04-a989-f659d419b8a5 |
| ResourceConfig | String | 否 | 资源配置 JSON 注意:此字段可能返回 null,表示取不到有效值。 示例值:{"Head":{"Name":"Head","ResourceType":"CPU","BillingItem":"xx","Spec":2,"HighAvailability":false,"PodNum":1},"Worker":[{"Name":"WorkerGroup01","ResourceType":"CPU","BillingItem":"xx","Spec":2,"MinPodNum":1,"MaxPodNum":1,"EnableAutoScaling":false}]} |
| ResourcePartitionId | String | 否 | 资源分区 ID 注意:此字段可能返回 null,表示取不到有效值。 示例值:dlc-p-rxrumrvj |
| ResourcePartitionName | String | 否 | 资源分区名称 示例值:cpu-pool-test |
| Queue | String | 否 | 队列名称 注意:此字段可能返回 null,表示取不到有效值。 示例值:default |
| CheckpointMountInfo | CheckpointMountInfo | 否 | Checkpoint 挂载摘要 注意:此字段可能返回 null,表示取不到有效值。 |
| Catalog | String | 否 | 存储卷挂载配置 JSON 注意:此字段可能返回 null,表示取不到有效值。 示例值:{"CFSVolumes":[{"FileSystemId":"cfs-x","VolumeSubPath":"/","SubPathMode":"subPath","SubPath":"x","MountPath":"/shared","FSId":null,"Host":null,"PersistVolumeName":null,"VpcId":null,"Source":"checkpoint","Origin":null,"AutoCreateSubDir":true}]} |
| Creator | String | 否 | 创建人 注意:此字段可能返回 null,表示取不到有效值。 示例值:700002655693 |
| CreateTime | Integer | 否 | 创建时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1786078661099 |
| UpdateTime | Integer | 否 | 更新时间(毫秒时间戳) 注意:此字段可能返回 null,表示取不到有效值。 示例值:1786675241119 |
| InstanceCount | Integer | 否 | 关联实例总数 注意:此字段可能返回 null,表示取不到有效值。 示例值:15 |
| HasRunningInstances | Boolean | 否 | 是否存在运行中实例 注意:此字段可能返回 null,表示取不到有效值。 示例值:true |
| Priority | Integer | 否 | 作业优先级(1-9,数字越大优先级越高) 注意:此字段可能返回 null,表示取不到有效值。 示例值:6 |
| MlFlowConfig | String | 否 | 提交时 MLflow 配置 JSON(含 MlFlowMode / MlFlowTrackingUri 等) 示例值:{"MlFlowMode":"remote"} |
| OutputModelName | String | 否 | 产出模型名称(用于后续模型注册) 示例值:model-test |
| Mode | String | 否 | 训练模式:sft / dpo / cpt / grpo(仅 POST_TRAINING 有值) 示例值:dpo |
| BaseModelUid | String | 否 | 基础模型 modelUid(仅 POST_TRAINING 有值) 示例值:m-qwen35-dot8b-6a7058ca-5d77 |
| BaseModelName | String | 否 | 基础模型名称(仅 POST_TRAINING 有值) 示例值:Qwen35_dot8B |
| Datasets | Array of DatasetMount | 否 | 提交时的数据集挂载列表(List<DatasetMount>,仅详情返回) |
| LastInstanceStatus | String | 否 | 提交时的 Checkpoint 产出配置(仅详情返回) 示例值:SUBMIT_FAILED |
| Tags | Array of Tag | 否 | 标签列表(TagKey-TagValue) |
| Checkpoint | CheckpointConfig | 否 | 提交时的 Checkpoint 产出配置(仅详情返回) |
| TuningParams | TrainingTuningParams | 否 | 提交时的调优参数(仅 POST_TRAINING,仅详情返回) |
| ResumeTraining | Boolean | 否 | 提交时的断点续训意图声明(仅详情返回) 示例值:true |
| AdvancedOptions | String | 否 | 高级参数 JSON(透传给 Neutrino advanced_options) 示例值:{"spec.rayClusterSpec.headGroupSpec.template.spec.initContainers":"[xxx]"} |
TrainingParams
零代码后训练参数
被如下接口引用:DescribePostTrainingPreset。
| 名称 | 类型 | 描述 |
|---|---|---|
| PerDeviceBatchSize | Integer | 每卡 batch size,SFT/DPO 用。GRPO 返回 null 示例值:2 |
| GradientAccumulationSteps | Integer | 梯度累积步数,用于放大有效 batch;GRPO 返回 null。 示例值:4 |
| GradientCheckpointing | Boolean | 是否开启梯度检查点(省显存换计算),GRPO 返回 null。 示例值:true |
| CutoffLen | Integer | 最大序列/上下文长度,所有模式都返回。 示例值:4096 |
| LearningRate | Float | 推荐学习率;SFT/DPO 按算法+微调方式给值,GRPO 返回 null(由入口脚本默认值决定)。 示例值:0.0001 |
| Epochs | Integer | 推荐训练轮次,所有模式都返回。 示例值:3 |
| LoraRank | Integer | 推荐 LoRA rank(仅 finetuneType=lora 有值,全参微调/GRPO 返回 null)。 示例值:8 |
| WarmupRatio | Float | warmup 步数占总步数比例;GRPO 返回 null。 示例值:0.03 |
| TrainBatchSize | Integer | GRPO 每步训练的 prompt 总数;SFT/DPO 返回 null。 示例值:256 |
| PPOMiniBatchSize | Integer | GRPO PPO 阶段 mini-batch 大小;SFT/DPO 返回 null。 示例值:128 |
| GpuMemoryUtilization | Float | GRPO rollout(vLLM/sglang)占用 GPU 显存比例(0~1);SFT/DPO 返回 null。 示例值:0.6 |
| MaxResponseLength | Integer | GRPO rollout 单次最大生成长度;SFT/DPO 返回 null。 示例值:2048 |
| NumSamplesPerPrompt | Integer | GRPO 每个 prompt 的采样数(group size);SFT/DPO 返回 null。 示例值:16 |
TrainingTuningParams
调优参数(高级参数,仅 POST_TRAINING 使用;CUSTOM_CODE / LAB 禁止传入)
被如下接口引用:CancelTrainingJobInstance, CreateTrainingJobInstance, DescribeTrainingJobInstance, DescribeTrainingJobSpec, ListMlflowServerTrainingInstances, ListTrainingJobInstance, ListTrainingJobSpec, ModifyTrainingJobSpec, ResumeTrainingJobInstance, SubmitTrainingJob。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| FineTuneType | String | 否 | 微调方式:lora / full / freeze;默认由算法决定(SFT/DPO=lora,CPT/GRPO=full) 示例值:lora |
| LoraRank | Integer | 否 | LoRA rank,仅 finetuneType=lora 时生效 示例值:8 |
| LoraAlpha | Integer | 否 | LoRA alpha 示例值:32 |
| LoraDropout | Float | 否 | LoRA dropout 示例值:0.1 |
| LoraTarget | String | 否 | LoRA 目标层,默认 all 示例值:all |
| TrainingMode | String | 否 | 训练模式:balanced / quality / speed / custom 示例值:balanced |
| Epochs | Integer | 否 | 训练轮数 示例值:3 |
| LearningRate | Float | 否 | 学习率 示例值:0.0001 |
| PerDeviceBatchSize | Integer | 否 | 每卡 batch size 示例值:4 |
| GradientAccumulationSteps | Integer | 否 | 梯度累积步数 示例值:4 |
| CutoffLen | Integer | 否 | 上下文长度 示例值:4096 |
| MaxSamples | Integer | 否 | 最大样本数 示例值:10000 |
| GradientCheckPointing | Boolean | 否 | 是否启用 gradient checkpointing,默认 true 示例值:true |
| LrScheduler | String | 否 | 学习率调度器类型,默认 cosine 示例值:cosine |
| WarmupRatio | Float | 否 | warmup 比例,默认 0.03 示例值:0.2 |
| DPOBeta | Float | 否 | DPO beta,仅 mode=dpo 时生效 示例值:0.03 |
| DPOLoss | String | 否 | DPO loss:sigmoid / hinge / ipo / kto_pair 示例值:0.1 |
| RewardFunctionCode | String | 否 | 兼容旧请求;当前 GRPO 默认使用 verl 内置 rule reward 示例值:def reward(completion, ground_truth):\n return 1.0 if completion.strip() == ground_truth.strip() else 0.0 |
| RewardFunctionCosPath | String | 否 | 兼容旧请求;当前 GRPO 默认使用 verl 内置 rule reward 示例值:/grpo/reward/my_reward_v1.py |
| KLCoefficient | Float | 否 | GRPO KL 系数,默认 0.001 示例值:0.001 |
| NumSamplesPerPrompt | Integer | 否 | 每个 prompt 的采样数(group size),默认 8 示例值:8 |
| MaxResponseLength | Integer | 否 | 最大响应生成长度,默认 1024 示例值:1024 |
| RollOutTemperature | Float | 否 | rollout 生成温度,默认 1.0 示例值:1 |
| RollOutBackend | String | 否 | rollout backend:vllm / sglang,默认 vllm 示例值:vllm |
| ClipRatio | Float | 否 | PPO clip ratio,默认 0.2 示例值:0.2 |
| PPOMiniBatchSize | Integer | 否 | PPO mini batch size,默认 128 示例值:126 |
| PPOEpochs | Integer | 否 | PPO epochs(每批数据的更新轮数),默认 1 示例值:1 |
| TrainBatchSize | Integer | 否 | 训练总 batch size(每步 prompt 数量),默认 128 示例值:128 |
| TensorModelParallelSize | Integer | 否 | rollout tensor model parallel size,默认 1 示例值:1 |
| GpuMemoryUtilization | Float | 否 | vLLM GPU memory utilization,默认 0.5 示例值:0.5 |
TypeKVPair
通用的键值对数据结构
被如下接口引用:CreateLab, GetLabDetail, ListLabs, ModifyLabPriority, StartLab, StopLab, UpdateLab。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Key | String | 否 | key值 注意:此字段可能返回 null,表示取不到有效值。 示例值:JUPYTER |
| Value | String | 否 | value值 注意:此字段可能返回 null,表示取不到有效值。 示例值:https://cls-pdb9lgk2.tcray-gateway.ap-guangzhou.cloud.tencent.com/dlc-p-bleurqnv/raylab-20260601105931-06dk/lab/jupyter |
UDFPolicyInfo
UDF权限信息
被如下接口引用:DescribeUDFPolicy, UpdateUDFPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Accesses | Array of String | 否 | 权限类型 示例:select,alter,drop 示例值:select |
| Users | Array of String | 否 | 拥有权限的用户信息 示例值:['100026442346', '100018379117'] |
| Groups | Array of String | 否 | 拥有权限的工作组的信息 示例值:['221458'] |
UpdateConfContext
配置下发参数
被如下接口引用:UpdateStandardEngineResourceGroupConfigInfo。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| ConfigType | String | 是 | 参数类型,可选:StaticConfigType,DynamicConfigType 示例值:StaticConfigType |
| Params | Array of Param | 是 | 参数的配置数组 |
UserDetailInfo
用户详细信息
被如下接口引用:DescribeUserInfo。
| 名称 | 类型 | 描述 |
|---|---|---|
| UserId | String | 用户Id 示例值:1208763821 |
| Type | String | 返回的信息类型,Group:返回的当前用户的工作组信息;DataAuth:返回的当前用户的数据权限信息;EngineAuth:返回的当前用户的引擎权限信息 示例值:Group |
| UserType | String | 用户类型:ADMIN:管理员 COMMON:一般用户 示例值:ADMIN |
| UserDescription | String | 用户描述信息 示例值:testUser |
| DataPolicyInfo | Policys | 数据权限信息集合 注意:此字段可能返回 null,表示取不到有效值。 |
| EnginePolicyInfo | Policys | 引擎权限集合 注意:此字段可能返回 null,表示取不到有效值。 |
| WorkGroupInfo | WorkGroups | 绑定到该用户的工作组集合信息 注意:此字段可能返回 null,表示取不到有效值。 |
| UserAlias | String | 用户别名 示例值:testname |
| RowFilterInfo | Policys | 行过滤集合 注意:此字段可能返回 null,表示取不到有效值。 |
| AccountType | String | 账号类型 示例值:UserAccount |
| CatalogPolicyInfo | Policys | 数据源权限集合 注意:此字段可能返回 null,表示取不到有效值。 |
| ModelPolicyInfo | Policys | 模型权限集合 |
UserIdSetOfWorkGroupId
绑定到同一个工作组的用户Id的集合
被如下接口引用:AddUsersToWorkGroup, DeleteUsersFromWorkGroup。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| WorkGroupId | Integer | 是 | 工作组Id 示例值:1 |
| UserIds | Array of String | 是 | 用户Id集合,和CAM侧Uin匹配 示例值:["12345678"] |
UserInfo
授权用户信息
被如下接口引用:DescribeUsers。
| 名称 | 类型 | 描述 |
|---|---|---|
| UserId | String | 用户Id,和子用户uin相同 示例值:12345678 |
| UserDescription | String | 用户描述信息,方便区分不同用户 示例值:测试用户 |
| PolicySet | Array of Policy | 单独给用户绑定的权限集合 注意:此字段可能返回 null,表示取不到有效值。 |
| Creator | String | 当前用户的创建者 示例值:Administrator |
| CreateTime | String | 创建时间,格式如2021-07-28 16:19:32 示例值:2021-07-28 16:19:32 |
| WorkGroupSet | Array of WorkGroupMessage | 关联的工作组集合 注意:此字段可能返回 null,表示取不到有效值。 |
| IsOwner | Boolean | 是否是主账号 示例值:false |
| UserType | String | 用户类型。ADMIN:管理员 COMMON:普通用户。 示例值:ADMIN |
| UserAlias | String | 用户别名 示例值:username |
| AccountType | String | 账号类型 示例值:UserAccount |
UserMessage
用户部分信息
被如下接口引用:DescribeWorkGroupInfo, DescribeWorkGroups。
| 名称 | 类型 | 描述 |
|---|---|---|
| UserId | String | 用户Id,和CAM侧子用户Uin匹配 示例值:7000****1851 |
| UserDescription | String | 用户描述 注意:此字段可能返回 null,表示取不到有效值。 示例值:test user |
| Creator | String | 当前用户的创建者 示例值:Administrator |
| CreateTime | String | 当前用户的创建时间,形如2021-07-28 16:19:32 示例值:2021-07-28 16:19:32 |
| UserAlias | String | 用户别名 示例值:testname |
| AccountType | String | 用户来源类型TencentAccount(普通腾讯云用户) / EntraAccount(微软用户) 示例值:EntraAccount |
UserRole
用户角色
被如下接口引用:DescribeUserRoles。
| 名称 | 类型 | 描述 |
|---|---|---|
| RoleId | Integer | 角色ID 示例值:219124 |
| AppId | String | 用户app ID 示例值:1*9 |
| Uin | String | 用户ID 示例值:1*6 |
| Arn | String | 角色权限 示例值:test_arn |
| ModifyTime | Integer | 最近修改时间戳 示例值:1736953682315 |
| Desc | String | 角色描述信息 示例值:test arn |
| RoleName | String | 角色名称 示例值:arn_name |
| Creator | String | 创建者UIN 示例值:test_user |
| CosPermissionList | Array of CosPermission | cos授权路径列表 |
| PermissionJson | String | cam策略json 示例值:deny |
| IsDefault | Integer | 是否设置为常驻:1非常驻(默认)、2常驻(仅能设置一个常驻) 示例值:2 |
UserVpcConnectionInfo
用户vpc网络连接信息
被如下接口引用:DescribeUserVpcConnection。
| 名称 | 类型 | 描述 |
|---|---|---|
| EngineNetworkId | String | 引擎网络ID 注意:此字段可能返回 null,表示取不到有效值。 |
| UserVpcId | String | 用户vpcid 注意:此字段可能返回 null,表示取不到有效值。 |
| UserVpcEndpointId | String | 用户终端节点ID 注意:此字段可能返回 null,表示取不到有效值。 |
| UserVpcEndpointName | String | 用户终端节点名称 注意:此字段可能返回 null,表示取不到有效值。 |
| AccessConnectionInfos | Array of String | 接入点信息 注意:此字段可能返回 null,表示取不到有效值。 |
Users
用户信息集合
被如下接口引用:DescribeWorkGroupInfo。
| 名称 | 类型 | 描述 |
|---|---|---|
| UserSet | Array of UserMessage | 用户信息集合 注意:此字段可能返回 null,表示取不到有效值。 |
| TotalCount | Integer | 用户总数 示例值:0 |
ViewBaseInfo
视图基本配置信息
被如下接口引用:DescribeViews。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| DatabaseName | String | 是 | 该视图所属数据库名字 示例值:database1 |
| ViewName | String | 是 | 视图名称 示例值:view-test |
| UserAlias | String | 否 | 视图创建人昵称 示例值:testUser |
| UserSubUin | String | 否 | 视图创建人ID 示例值:100019878767 |
ViewResponseInfo
查询视图信息对象
被如下接口引用:DescribeViews。
| 名称 | 类型 | 描述 |
|---|---|---|
| ViewBaseInfo | ViewBaseInfo | 视图基本信息。 |
| Columns | Array of Column | 视图列信息。 注意:此字段可能返回 null,表示取不到有效值。 |
| Properties | Array of Property | 视图属性信息。 注意:此字段可能返回 null,表示取不到有效值。 |
| CreateTime | String | 视图创建时间。 示例值:1611646962 |
| ModifiedTime | String | 视图更新时间。 示例值:1611646962 |
VpcCidrBlock
VPC子网信息
被如下接口引用:DescribeOtherCHDFSBindingList。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| CidrId | String | 否 | 子网Id 示例值:subnet-e4****xj |
| CidrAddr | String | 否 | 子网网段 示例值:10...*/16 |
VpcInfo
vpc信息
被如下接口引用:CreateCHDFSBindingProduct, DeleteCHDFSBindingProduct。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| VpcId | String | 否 | vpc Id 示例值:vpc-f37xxxx |
| VpcCidrBlock | String | 否 | vpc子网 示例值:10.../ |
| RuleId | Integer | 否 | 规则Id 示例值:4549 |
| AccessGroupId | String | 否 | 权限组Id 示例值:ag-cj91234e |
WorkGroupDetailInfo
工作组详细信息
被如下接口引用:DescribeWorkGroupInfo。
| 名称 | 类型 | 描述 |
|---|---|---|
| WorkGroupId | Integer | 工作组Id 示例值:12 |
| WorkGroupName | String | 工作组名称 示例值:testGroup |
| Type | String | 包含的信息类型。User:用户信息;DataAuth:数据权限;EngineAuth:引擎权限 示例值:User |
| UserInfo | Users | 工作组上绑定的用户集合 |
| DataPolicyInfo | Policys | 数据权限集合 |
| EnginePolicyInfo | Policys | 引擎权限集合 |
| WorkGroupDescription | String | 工作组描述信息 示例值:group for admin |
| RowFilterInfo | Policys | 行过滤信息集合 |
| CatalogPolicyInfo | Policy | 数据目录权限集 注意:此字段可能返回 null,表示取不到有效值。 |
| DataCatalogPolicyInfo | Policys | 数据目录权限 |
| ModelPolicyInfo | Policys | 模型权限 |
WorkGroupIdSetOfUserId
同一个用户绑定的工作组集合
被如下接口引用:BindWorkGroupsToUser, UnbindWorkGroupsFromUser。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| UserId | String | 是 | 用户Id,和CAM侧Uin匹配 示例值:“12345678” |
| WorkGroupIds | Array of Integer | 是 | 工作组Id集合 示例值:[1,2,3] |
WorkGroupInfo
工作组信息
被如下接口引用:DescribeWorkGroups。
| 名称 | 类型 | 描述 |
|---|---|---|
| WorkGroupId | Integer | 查询到的工作组唯一Id 示例值:1 |
| WorkGroupName | String | 工作组名称 示例值:testGroup |
| WorkGroupDescription | String | 工作组描述 示例值:default describe |
| UserNum | Integer | 工作组关联的用户数量 示例值:0 |
| UserSet | Array of UserMessage | 工作组关联的用户集合 注意:此字段可能返回 null,表示取不到有效值。 |
| PolicySet | Array of Policy | 工作组绑定的权限集合 注意:此字段可能返回 null,表示取不到有效值。 |
| Creator | String | 工作组的创建人 示例值:Administrator |
| CreateTime | String | 工作组的创建时间,形如2021-07-28 16:19:32 示例值:2021-07-28 16:19:32 |
WorkGroupMessage
工作组部分信息
被如下接口引用:DescribeUserInfo, DescribeUsers。
| 名称 | 类型 | 描述 |
|---|---|---|
| WorkGroupId | Integer | 工作组唯一Id 示例值:1 |
| WorkGroupName | String | 工作组名称 示例值:group1 |
| WorkGroupDescription | String | 工作组描述 示例值:default describe |
| Creator | String | 创建者 示例值:Administrator |
| CreateTime | String | 工作组创建的时间,形如2021-07-28 16:19:32 示例值:2021-07-28 16:19:32 |
WorkGroups
工作组集合
被如下接口引用:DescribeUserInfo。
| 名称 | 类型 | 描述 |
|---|---|---|
| WorkGroupSet | Array of WorkGroupMessage | 工作组信息集合 注意:此字段可能返回 null,表示取不到有效值。 |
| TotalCount | Integer | 工作组总数 示例值:10 |
WorkerSpecDTO
worker组规格
被如下接口引用:CreateResourceConfig, DescribePostTrainingPreset, GetResourceConfig, ListResourceConfigs, UpdateResourceConfig。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| Name | String | 否 | worker名称 示例值:Worker01 |
| PodCpu | Integer | 否 | Pod CPU核数 示例值:1 |
| PodMem | Integer | 否 | Pod 内存大小 示例值:2 |
| GpuType | String | 否 | GPU类型 示例值:GPU |
| GpuNum | Integer | 否 | GPU数量 示例值:0 |
| Envs | Array of Env | 否 | 环境变量列表 |
| Labels | Array of Label | 否 | 标签列表 |
| ResourcesLabels | Array of Label | 否 | 资源标签列表(用于追加到 headGroupSpec/workerGroupSpec 的 resources map 中,对应 Ray/K8s 的自定义资源声明),Value 必须为字符串形式的整数 |
| MinPodNum | Integer | 否 | 最小Pod数量 示例值:2 |
| MaxPodNum | Integer | 否 | 最大Pod数量 示例值:3 |
| EnableAutoScaling | Boolean | 否 | 是否开启弹性伸缩(true=开启,false/null=关闭)。开启后按 MinPodNum/MaxPodNum 弹性伸缩,关闭则按固定副本数运行 示例值:true |
| ResourceType | String | 否 | 资源类型,CPU,GPU 示例值:CPU |
| InstanceType | String | 否 | 机型,例如X40/T20 示例值:sv_dlc_gn10xp_2XLARGE40 |
| Spec | Integer | 否 | 规格数量 示例值:1 |
| BillingItem | String | 否 | 资源ID(唯一) 示例值:sv_dlc_standard_cu_standard_cu |
WrittenAdvancePolicy
Smart Optimizer高级参数配置数据结构
被如下接口引用:AlterTableComment, AssignMangedTableProperties, CreateInternalTable, CreateMetaDatabase, CreateTcIcebergTable, DeleteTable, GenerateCreateMangedTableSql, GenerateInternalTable, GetOptimizerPolicy, SetOptimizerPolicy。
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| CompactEnable | String | 否 | 是否启用合并 示例值:enable |
| DeleteEnable | String | 否 | 是否启用历史数据清理 示例值:enable |
| MinInputFiles | Integer | 否 | 合并最新文件数量 示例值:2 |
| TargetFileSizeBytes | Integer | 否 | 合并文件目录文件大小 示例值:128 |
| RetainLast | Integer | 否 | 保留过期时间的快照数量 示例值:2 |
| BeforeDays | Integer | 否 | 快照过期时间 示例值:2 |
| ExpiredSnapshotsIntervalMin | Integer | 否 | 快照过期执行周期 示例值:600 |
| RemoveOrphanIntervalMin | Integer | 否 | 移除孤立文件执行周期 示例值:1400 |
| CowCompactEnable | String | 否 | 是否开启COW表合并 示例值:enable |
| CompactStrategy | String | 否 | 文件合并策略 示例值:binpack |
| SortOrders | Array of SortOrder | 否 | sort合并策略的规则定义 注意:此字段可能返回 null,表示取不到有效值。 |