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

Consulta conjuntos de dados.

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:DescribeAIDBClusterDatasets

list

*All Resource

*

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 do cluster PolarDB para serviços de modelo de IA.	pc-2ze88***
DatasetType	string	Não	O tipo do conjunto de dados. Valores válidos: train: conjunto de treinamento. eval: conjunto de avaliação.	train
TrainMode	string	Não	O modo de treinamento. Valores válidos: sft: ajuste fino supervisionado. grpo: aprendizado por reforço. text: geração de texto.	grpo
ContinuationToken	string	Não	O token utilizado para recuperar a próxima página de resultados. Este valor é obtido da resposta de uma solicitação anterior. Para a primeira solicitação, deixe este parâmetro vazio.	EFSDF-DF-***
PageSize	string	Não	O número de entradas a serem retornadas em cada página. Valores válidos: 30, 50 e 100. Valor padrão: 30.	30
PageNumber	string	Não	O número da página a ser retornada. Valor padrão: 1.	1
DatasetId	string	Não	O ID do conjunto de dados.	pds-2ze88***

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
RequestId	string	O ID da solicitação.	2921D843-433A-5FB3-A03B-4EC093B219F8
ContinuationToken	string	O token de continuação da solicitação.	EFSDF-DF-***
RelativeDBClusterId	string	O ID do cluster de banco de dados relativo.	pc-2ze88***
DatasetType	string	O tipo do conjunto de dados. Valores válidos: train: conjunto de treinamento. eval: conjunto de avaliação.	train
DatasetMode	string	O modo de treinamento. Valores válidos: sft: ajuste fino supervisionado (SFT). grpo: aprendizado por reforço (RL). text: geração de texto.	stf
NextContinuationToken	string	O token para recuperar a próxima página de resultados. Este parâmetro é retornado somente se `IsTruncated` for `true`.	EFSDF-DF-***
IsTruncated	boolean	Indica se há mais conjuntos de dados disponíveis. Valores válidos: true: há mais conjuntos de dados disponíveis. false: todos os conjuntos de dados foram listados.	true
TotalCount	string	O número total de conjuntos de dados.	6
PageSize	string	O tamanho da página.	30
Datasets	array<object>	Um array de objetos de conjunto de dados.
	object	Um objeto de conjunto de dados.
FileName	string	O nome do arquivo.	train-***.json
Path	string	O caminho do arquivo.	polardb_ai/datasets/train/sft/dataset01/train-***.json
BucketName	string	O nome do bucket.	pcs-2ze22*-q7*
StorageType	string	O tipo de armazenamento. O único valor válido é: Standard.	Standard
Capacity	string	O tamanho do arquivo em bytes.	2845904
LastModified	string	A hora da última modificação do arquivo, em UTC e formatada conforme ISO 8601.	2025-11-06T06:50:43Z
CreationTime	string	A hora de criação do arquivo, em UTC e formatada conforme ISO 8601.	2025-11-06T06:50:43Z
DatasetId	string	O ID do conjunto de dados.	pds-2ze88***
DatasetType	string	O tipo do conjunto de dados. Valores válidos: train: conjunto de treinamento. eval: conjunto de avaliação.	train
TrainMode	string	O modo de treinamento. Valores válidos: sft: ajuste fino supervisionado (SFT). grpo: aprendizado por reforço (RL). text: geração de texto.	stf
TotalRecords	string	O número total de registros.	6
PageNumber	string	O número da página.	1
DatasetId	string	O ID do conjunto de dados.	pds-2ze88***
DataServiceId	string	O ID do serviço de dados.	pcs-2zeei***
FileCount	string	O número total de arquivos no conjunto de dados.	6

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "2921D843-433A-5FB3-A03B-4EC093B219F8",
  "ContinuationToken": "EFSDF-DF-***",
  "RelativeDBClusterId": "pc-2ze88***",
  "DatasetType": "train",
  "DatasetMode": "stf",
  "NextContinuationToken": "EFSDF-DF-***\n",
  "IsTruncated": true,
  "TotalCount": "6",
  "PageSize": "30",
  "Datasets": [
    {
      "FileName": "train-***.json",
      "Path": "polardb_ai/datasets/train/sft/dataset01/train-***.json",
      "BucketName": "pcs-2ze22***-q7***",
      "StorageType": "Standard\n",
      "Capacity": "2845904",
      "LastModified": "2025-11-06T06:50:43Z",
      "CreationTime": "2025-11-06T06:50:43Z",
      "DatasetId": "pds-2ze88***",
      "DatasetType": "train",
      "TrainMode": "stf"
    }
  ],
  "TotalRecords": "6",
  "PageNumber": "1",
  "DatasetId": "pds-2ze88***",
  "DataServiceId": "pcs-2zeei***",
  "FileCount": "6"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.