获取任务实例详情
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
否 |
地域 ID。 |
cn-beijing |
| DBClusterId |
string |
否 |
任务 ID |
pm-2ze99*** |
| DescribeType |
string |
否 |
查询模式，取值如下：
|
RelatedAITask |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
45D24263-7E3A-4140-9472-************ |
| DBType |
string |
引擎类型 |
polardb_ai |
| DBVersion |
string |
版本，取值如下：
|
3.1 |
| DBClusterId |
string |
任务 ID |
pm-2ze99*** |
| DBClusterStatus |
string |
训练状态，取值如下：
|
COMPLETED |
| ClusterNetworkType |
string |
集群的网络类型。 |
VPC |
| ModelPath |
string |
模型微调场景下输出的模型路径列表 |
/models_train/pm-2ze9***/merged_models_checkpoint-10,/models_train/pm-2ze9***/merged_models_checkpoint-5 |
| CreateTime |
string |
创建时间 |
2025-11-12T03:45:13Z |
| KindCode |
integer |
实例的类型，取值说明：
|
18 |
| MaintainStartTime |
string |
维护开始时间 |
8:00Z |
| MaintainEndTime |
string |
维护结束时间 |
12:00Z |
| DataSets |
array<object> |
数据集。 |
|
|
object |
数据集。 |
||
| DatasetName |
string |
数据集名称 |
dataset02 |
| Path |
string |
数据集路径 |
polardb_ai/datasets/train/grpo/dataset02/test-**.jsonl#1000 |
| SplitDatasetRatio |
string |
从训练集切分的比例 |
0.1 |
| Type |
string |
类型，取值如下：
|
train |
| TaskInfo |
array<object> |
任务信息。 |
|
|
object |
任务信息。 |
||
| ModelName |
string |
基础模型 |
Qwen-1.7B |
| TrainType |
string |
训练方法，取值如下：
|
lora |
| TrainMode |
string |
任务类型，取值如下：
|
stf |
| ModelPath |
string |
自定义模型的路径 |
Qwen-1.7B |
| ModelSource |
string |
模型来源，取值如下：
|
public |
| RunningTimes |
string |
运行参数 |
{"split_dataset_ratio": 0.1,"train_mode": "grpo","train_type": "lora","num_epochs": 1,"batch_size": 2,"eval_batch_size": 2, "num_generations": 2, "learning_rate": "1e-6", "data_file_list": "test-00000-of-00001.jsonl#1000", "lora_rank": 8, "lora_alpha": 32, "external_plugins": "/plugin/train/plugin.py", "reward_funcs": "format,external_countdown", "gpu_memory_utilization": 0.4} |
| StartTime |
string |
任务开始时间。 |
2025-09-10T01:56:00Z |
| CompletedTime |
string |
任务完成时间。 |
2025-09-10T01:56:00Z |
| LockMode |
string |
锁定模式，取值如下：
|
1 |
| DBClusterStatusDesc |
string |
训练状态，取值如下：
|
COMPLETED |
| AccessInfo |
string |
测试部署场景下模型的访问信息 |
{\"networkInterfaceId\":\"eni-2zea***\",\"port\":\"8000\",\"host\":\"192.**.**.**\"} |
| ExtraInfo |
array<object> |
额外信息，包括运行参数等信息 |
|
|
object |
额外信息，包括运行参数等信息 |
{"outputPath":"/output/models_train/pm-2ze9***"} |
|
| VPCId |
string |
专有网络 ID。 |
vpc-********** |
| VSwitchId |
string |
虚拟交换机 ID。 |
vsw-********************* |
| DBClusterDescription |
string |
任务名称 |
task01 |
| TuneArch |
string |
示例
正常返回示例
JSON格式
{
"RequestId": "45D24263-7E3A-4140-9472-************",
"DBType": "polardb_ai",
"DBVersion": "3.1",
"DBClusterId": "pm-2ze99***\n",
"DBClusterStatus": "COMPLETED",
"ClusterNetworkType": "VPC",
"ModelPath": "/models_train/pm-2ze9***/merged_models_checkpoint-10,/models_train/pm-2ze9***/merged_models_checkpoint-5",
"CreateTime": "2025-11-12T03:45:13Z",
"KindCode": 18,
"MaintainStartTime": "8:00Z",
"MaintainEndTime": "12:00Z",
"DataSets": [
{
"DatasetName": "dataset02",
"Path": "polardb_ai/datasets/train/grpo/dataset02/test-**.jsonl#1000",
"SplitDatasetRatio": "0.1",
"Type": "train"
}
],
"TaskInfo": [
{
"ModelName": "Qwen-1.7B",
"TrainType": "lora",
"TrainMode": "stf",
"ModelPath": "Qwen-1.7B",
"ModelSource": "public",
"RunningTimes": "{\"split_dataset_ratio\": 0.1,\"train_mode\": \"grpo\",\"train_type\": \"lora\",\"num_epochs\": 1,\"batch_size\": 2,\"eval_batch_size\": 2, \"num_generations\": 2, \"learning_rate\": \"1e-6\", \"data_file_list\": \"test-00000-of-00001.jsonl#1000\", \"lora_rank\": 8, \"lora_alpha\": 32, \"external_plugins\": \"/plugin/train/plugin.py\", \"reward_funcs\": \"format,external_countdown\", \"gpu_memory_utilization\": 0.4}\n",
"StartTime": "2025-09-10T01:56:00Z",
"CompletedTime": "2025-09-10T01:56:00Z"
}
],
"LockMode": "1",
"DBClusterStatusDesc": "COMPLETED",
"AccessInfo": "{\\\"networkInterfaceId\\\":\\\"eni-2zea***\\\",\\\"port\\\":\\\"8000\\\",\\\"host\\\":\\\"192.**.**.**\\\"}",
"ExtraInfo": [
{
"outputPath": "/output/models_train/pm-2ze9***"
}
],
"VPCId": "vpc-**********",
"VSwitchId": "vsw-*********************",
"DBClusterDescription": "task01",
"TuneArch": ""
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 404 | InvalidDBClusterId.NotFound | The DBInstanceId provided does not exist in our records. | 当前的记录中不存在提供的DBClusterId。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。