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

Container Service for Kubernetes:DescribeTaskInfo

最終更新日:May 12, 2026

DescribeTaskInfo オペレーションでは、クラスタータスクのタスクタイプ、実行状態、実行ステージなどの詳細を照会できます。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cs:DescribeTaskInfo

get

*All Resource

*

なし なし

リクエスト構文

GET /tasks/{task_id} HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

task_id

string

必須

タスク ID。

T-5faa48fb31b6b8078d00****

リクエストパラメーター

パラメーター

必須 / 任意

説明

リクエストパラメーターは必要ありません。

レスポンスフィールド

フィールド

説明

object

応答本文。

task_id

string

タスク ID。

T-5faa48fb31b6b8078d000006

cluster_id

string

クラスター ID。

c78592bfe92244365b3c3ad47f1de****

task_type

string

タスクのタイプ。スケールアウトタスクの場合、この値は cluster_scaleout です。

cluster_scaleout

state

string

タスクの状態。有効な値:

  • running :タスクが進行中です。

  • fail :タスクが失敗しました。

  • success :タスクが成功しました。

running

created

string

タスクが作成された時刻。

2020-11-10T16:02:04+08:00

updated

string

タスクが最後に更新された時刻。

2020-11-10T16:03:06+08:00

target

object

タスクのターゲット。

id

string

タスクターゲットの ID。

c78592bfe92244365b3c3ad47f1de****

type

string

タスクターゲットのタイプ。

cluster

parameters

object

タスクパラメーター。

stages

array<object>

タスクステージ。

array<object>

タスクステージ。

state

string

タスクステージの状態。

running

start_time

string

タスクステージの開始時刻。

2022-12-15 23:00:00

end_time

string

タスクステージの終了時刻。

2022-12-15 23:00:00

message

string

タスクステージのメッセージ。

success to xxxxx

outputs

object

タスクステージの出力。

current_stage

string

タスクの現在のステージ。

DrainNodes

events

array<object>

タスクが生成するイベント。

object

イベントの詳細。

action

string

イベントアクション。

start

level

string

イベントレベル。

Normal

message

string

イベントメッセージ。

start to xxx

reason

string

イベントの理由。

NodePoolUpgradeStart

source

string

イベントのソース。

ACK

timestamp

string

イベントが生成された時刻。

1669706229286

task_result

array<object>

タスク実行の詳細。

object

特定のリソースに関する結果。

data

string

タスクの操作対象となるリソース。例えば、インスタンスを操作するスケールアウトタスクの場合、このフィールドはインスタンス ID です。

i-xxx

status

string

リソースのスケールアウト状態。有効な値:

  • success :スケールアウトは成功です。

  • failed :スケールアウトは失敗です。

  • initial :リソースは初期化中です。

success

error

object

タスクのエラー情報。

code

string

エラーコード。

400

message

string

エラーメッセージ。

failed to xxx

outputs

object

成功レスポンス

JSONJSON

{
  "task_id": "T-5faa48fb31b6b8078d000006",
  "cluster_id": "c78592bfe92244365b3c3ad47f1de****",
  "task_type": "cluster_scaleout",
  "state": "running",
  "created": "2020-11-10T16:02:04+08:00",
  "updated": "2020-11-10T16:03:06+08:00",
  "target": {
    "id": "c78592bfe92244365b3c3ad47f1de****\n",
    "type": "cluster"
  },
  "parameters": {
    "test": "test",
    "test2": 1
  },
  "stages": [
    {
      "state": "running",
      "start_time": "2022-12-15 23:00:00",
      "end_time": "2022-12-15 23:00:00",
      "message": "success to xxxxx",
      "outputs": {
        "test": "test",
        "test2": 1
      }
    }
  ],
  "current_stage": "DrainNodes",
  "events": [
    {
      "action": "start",
      "level": "Normal",
      "message": "start to xxx",
      "reason": "NodePoolUpgradeStart",
      "source": "ACK",
      "timestamp": "1669706229286"
    }
  ],
  "task_result": [
    {
      "data": "i-xxx",
      "status": "success"
    }
  ],
  "error": {
    "code": "400",
    "message": "failed to xxx"
  },
  "outputs": {
    "test": "test",
    "test2": 1
  }
}

エラーコード

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

変更履歴

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