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