KVM / Libvirt DeleteVm

KVM / Libvirt DeleteVm

Certified

Delete or undefine KVM domain

Looks up a libvirt domain by name, stops it if running, and undefines it. Can also delete attached storage volumes parsed from the domain XML when deleteStorage is true (default false). Fails when the domain is missing unless failIfNotFound is set to false (default true).

yaml
type: io.kestra.plugin.kvm.DeleteVm
yaml
id: kvm_lifecycle_ssh
namespace: kvmtest.ssh

tasks:
  - id: delete_vm
    type: io.kestra.plugin.kvm.DeleteVm
    uri: "qemu+ssh://root@167.99.104.163/system"
    name: "kestra-worker-nodes"
    deleteStorage: true
    failIfNotFound: true
Properties

Domain name

Name of the libvirt domain to delete.

Defaultfalse

Delete storage volumes

If true, deletes volumes referenced in the domain XML by pool/name before undefine. Default false.

Defaulttrue

Fail if missing

If true, throws when the domain does not exist; if false, logs a warning and continues. Default true.

Reference (ref) of the pluginDefaults to apply to this task.

Libvirt URI

SubTypestring

Deleted volumes

Volume identifiers removed when deleteStorage is true.

Defaultfalse

Delete succeeded

True when the domain was found and undefined; false when skipped.

More Plugins in this Category

NetBox (EE)
NetBox
Enterprise

Enterprise NetBox tasks to create, update, and query devices, IP addresses, and sites over the NetBox API.

Infrastructure

7 tasks

4 blueprints

AS400
AS400

Tasks that connect to AS400 via JDBC to run queries and loads.

DataInfrastructure

3 tasks