すべてのプロダクト
Search
ドキュメントセンター

PolarDB:DescribeAIDBClusterTaskAttribute

最終更新日:Jul 09, 2026

タスクインスタンスの詳細を取得します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

polardb:DescribeAIDBClusterTaskAttribute

none

*すべてのリソース。

*

なし なし

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

任意

リージョン ID。

cn-beijing

DBClusterId

string

任意

タスク ID。

pm-2ze99***

DescribeType

string

任意

クエリモード。有効な値:

  • RelatedAITask: タスク詳細を照会します。

RelatedAITask

レスポンスフィールド

フィールド

説明

object

レスポンスのスキーマ。

RequestId

string

リクエスト ID。

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

テスト Deployment シナリオにおけるモデルのアクセス情報。

{\"networkInterfaceId\":\"eni-2zea***\",\"port\":\"8000\",\"host\":\"192.**.**.**\"}

ExtraInfo

array<object>

ランタイムパラメーターを含む追加情報。

object

ランタイムパラメーターを含む追加情報。

{"outputPath":"/output/models_train/pm-2ze9***"}

VPCId

string

仮想非公開クラウド (VPC) の ID。

vpc-**********

VSwitchId

string

vSwitch の ID。

vsw-*********************

DBClusterDescription

string

タスク名。

task01

TuneArch

string

成功レスポンス

JSONJSON

{
  "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 ステータスコード

エラーコード

エラーメッセージ

説明

404 InvalidDBClusterId.NotFound The DBInstanceId provided does not exist in our records. 指定された DBClusterId は現在のレコードに存在しません。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。