update
dpsctl topology update Usage Guide
Update an existing topology from a JSON file.
Usage
dpsctl topology updateFlags
Includes global dpsctl options.
--filename value JSON import filename (required)
--force force update topology
--help, -h show helpExamples
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
--forceflag 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 validatefirst