remove-entities#

dpsctl topology remove-entities Usage Guide#

Permanently deletes entities from the system.

Note: The entities must not be referenced by any topology (active or inactive). If an entity is part of any topology, the deletion will fail.

Usage#

dpsctl topology remove-entities [entity-names...]

Flags#

Includes global dpsctl options.

   --help, -h          show help

Examples#

Delete Unused Entities#

$ dpsctl topology remove-entities node001 node002
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

Error: Entity in Use#

$ dpsctl topology remove-entities node001
{
  "status": {
    "ok": false,
    "diag_msg": "entit(ies) referenced from existing topologies"
  },
  "entity_topologies": {
     "node001": {
        "topologies": ["my-topology"]
     }
  }
}

Notes#

  • This operation permanently deletes entities from the database.

  • At least one entity name is required.

  • Deletion is global (system-wide), not scoped to a topology.

  • To remove entities from a topology without deleting them from the system, update the topology definition through CreateUpdateTopology. The current Go CLI update limitation is documented in update.