update

dpsctl topology update Usage Guide

Update an existing topology from a JSON file.

Usage

dpsctl topology update

Flags

Includes global dpsctl options.

   --filename value    JSON import filename (required)
   --force             force update topology
   --help, -h          show help

Examples

Basic Update

$ dpsctl topology update --filename updated-topology.json
{
  "status": {
    "ok": true,
    "diag_msg": "Topology updated successfully"
  }
}

Force Update

$ dpsctl topology update --filename topology.json --force
{
  "status": {
    "ok": true,
    "diag_msg": "Topology forcefully updated"
  }
}

Update with Validation Errors

$ dpsctl topology update --filename invalid-topology.json
{
  "status": {
    "ok": false,
    "diag_msg": "Topology update failed: validation errors found"
  }
}

Notes

  • Updates modify existing topology configuration
  • The --force flag bypasses certain validation checks
  • Topology must be deactivated before major structural changes
  • Use with caution as updates can affect active resource groups
  • Always validate the JSON file with dpsctl topology validate first