list

`dpsctl task list` Usage Guide

List ongoing async tasks running in DPS server.

Overview

The task list command displays all currently running asynchronous tasks in the system. This is useful for monitoring long-running operations such as topology activation/deactivation or resource group activation/deactivation.

Each task includes:

id: Unique identifier for the task
name: Task type (e.g., ResourceGroupActivation, TopologyActivation)
status: Current status (running, pending, etc.)
started_at: When the task started
completed_at: When the task completed (if finished)
parent_id: Parent task ID for subtasks

Usage

dpsctl task list

Flags

Includes global dpsctl options.

  --help, -h  show help

Examples

List all running tasks

$ dpsctl task list
[
  {
    "id": "task-abc123",
    "name": "ResourceGroupActivation",
    "status": "running",
    "started_at": "2025-01-22T10:30:00Z",
    "parent_id": ""
  },
  {
    "id": "task-def456",
    "name": "NodeActivation",
    "status": "running",
    "started_at": "2025-01-22T10:30:01Z",
    "parent_id": "task-abc123"
  }
]

No running tasks

When there are no ongoing tasks, the command returns an empty list:

$ dpsctl task list
[]

Use Cases

Monitoring activation progress: Check the status of topology or resource group activation operations
Debugging: Identify stuck or long-running tasks
Automation: Wait for tasks to complete before proceeding with subsequent operations