DescribeAIDBClusterTaskAttribute - PolarDB

取得任務執行個體詳細資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

polardb:DescribeAIDBClusterTaskAttribute

none

*全部資源。

*

無

請求文法

POST  HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	否	地域 ID。	cn-beijing
DBClusterId	string	否	任務 ID。	pm-2ze99***
DescribeType	string	否	查詢模式，取值如下： RelatedAITask：查詢任務詳細資訊。	RelatedAITask

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	Id of the request	45D24263-7E3A-4140-9472-************
DBType	string	引擎類型。	polardb_ai
DBVersion	string	版本，取值如下： 3.1：模型運算子調優。	3.1
DBClusterId	string	任務 ID。	pm-2ze99***
DBClusterStatus	string	訓練狀態，取值如下： ACTIVATION：訓練中。 COMPLETED：訓練成功。 FAILED：訓練失敗。	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。	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：訓練集。 eval：驗證集。	train
TaskInfo	array<object>	任務資訊。
	object	任務資訊。
ModelName	string	基礎模型。	Qwen-1.7B
TrainType	string	訓練方法，取值如下： lora。 full：全量訓練。	lora
TrainMode	string	任務類型，取值如下： sft：SFT-高效訓練。 grpo：GRPO-強化學習。	stf
ModelPath	string	自訂模型的路徑。	Qwen-1.7B
ModelSource	string	模型來源，取值如下： public：預置模型。 custom：自訂模型。	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	鎖定模式，取值如下： 0：鎖定。 1：未鎖定。	1
DBClusterStatusDesc	string	訓練狀態，取值如下： ACTIVATION：訓練中。 COMPLETED：訓練成功。 FAILED：訓練失敗。	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。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。