DescribeAIDBClusterTaskAttribute - PolarDB: Central de Documentação do Alibaba Cloud

Obtém os detalhes de uma instância de tarefa.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

polardb:DescribeAIDBClusterTaskAttribute

none

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região.	cn-beijing
DBClusterId	string	Não	O ID da tarefa.	pm-2ze99***
DescribeType	string	Não	O modo de consulta. Valores válidos: RelatedAITask: Consulta os detalhes da tarefa.	RelatedAITask

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	45D24263-7E3A-4140-9472-************
DBType	string	O tipo de mecanismo.	polardb_ai
DBVersion	string	A versão. Valores válidos: 3.1: Ajuste fino do operador do modelo.	3.1
DBClusterId	string	O ID da tarefa.	pm-2ze99***
DBClusterStatus	string	O status do treinamento. Valores válidos: ACTIVATION: Treinamento em andamento. COMPLETED: Treinamento concluído com sucesso. FAILED: Falha no treinamento.	COMPLETED
ClusterNetworkType	string	O tipo de rede do cluster.	VPC
ModelPath	string	A lista de caminhos do modelo de saída no cenário de ajuste fino do modelo.	/models_train/pm-2ze9*/merged_models_checkpoint-10,/models_train/pm-2ze9*/merged_models_checkpoint-5
CreateTime	string	A hora de criação.	2025-11-12T03:45:13Z
KindCode	integer	O tipo da instância. Valores válidos: 18.	18
MaintainStartTime	string	A hora de início da manutenção.	8:00Z
MaintainEndTime	string	A hora de término da manutenção.	12:00Z
DataSets	array<object>	Os conjuntos de dados.
	object	Os conjuntos de dados.
DatasetName	string	O nome do conjunto de dados.	dataset02
Path	string	O caminho do conjunto de dados.	polardb_ai/datasets/train/grpo/dataset02/test-**.jsonl#1000
SplitDatasetRatio	string	A proporção de dados divididos do conjunto de treinamento.	0.1
Type	string	O tipo. Valores válidos: train: Conjunto de treinamento. eval: Conjunto de validação.	train
TaskInfo	array<object>	As informações da tarefa.
	object	As informações da tarefa.
ModelName	string	O modelo base.	Qwen-1.7B
TrainType	string	O método de treinamento. Valores válidos: lora full: Treinamento com parâmetros completos.	lora
TrainMode	string	O tipo de tarefa. Valores válidos: sft: Treinamento eficiente SFT. grpo: Aprendizado por reforço GRPO.	stf
ModelPath	string	O caminho do modelo personalizado.	Qwen-1.7B
ModelSource	string	A origem do modelo. Valores válidos: public: Modelo pré-treinado. custom: Modelo personalizado.	public
RunningTimes	string	Os parâmetros de tempo de execução.	{"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	A hora de início da tarefa.	2025-09-10T01:56:00Z
CompletedTime	string	A hora de conclusão da tarefa.	2025-09-10T01:56:00Z
LockMode	string	O modo de bloqueio. Valores válidos: 0: Bloqueado. 1: Desbloqueado.	1
DBClusterStatusDesc	string	O status do treinamento. Valores válidos: ACTIVATION: Treinamento em andamento. COMPLETED: Treinamento concluído com sucesso. FAILED: Falha no treinamento.	COMPLETED
AccessInfo	string	As informações de acesso do modelo no cenário de implantação de teste.	{\"networkInterfaceId\":\"eni-2zea*\",\"port\":\"8000\",\"host\":\"192...\"}
ExtraInfo	array<object>	As informações adicionais, incluindo parâmetros de tempo de execução.
	object	As informações adicionais, incluindo parâmetros de tempo de execução.	{"outputPath":"/output/models_train/pm-2ze9***"}
VPCId	string	O ID da nuvem privada virtual (VPC).	vpc-**********
VSwitchId	string	O ID do vSwitch.	vsw-*********************
DBClusterDescription	string	O nome da tarefa.	task01
TuneArch	string

Exemplos

Resposta de sucesso

JSON formato

{
  "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": ""
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
404	InvalidDBClusterId.NotFound	The DBInstanceId provided does not exist in our records.	O DBClusterId especificado não existe nos registros atuais.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.