delete protection assembly

Author: Audrey Spaulding

_topic_maps/_topic_map.yml

@@ -4616,6 +4616,8 @@ Topics:
     File: virt-edit-boot-order
   - Name: Deleting virtual machines
     File: virt-delete-vms
+  - Name: Enabling or disabling virtual machine delete protection
+    File: virt-enabling-disabling-vm-delete-protection
   - Name: Exporting virtual machines
     File: virt-exporting-vms
   - Name: Managing virtual machine instances

modules/virt-enabling-disabling-vm-delete-protection-cli.adoc

@@ -0,0 +1,30 @@
+// Module included in the following assemblies:
+//
+// * virt/managing-vms/virt-enabling-disabling-vm-delete-protection.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-enabling-disabling-vm-delete-protection-cli_{context}"]
+
+= Enabling or disabling virtual machine delete protection by using the command line
+
+To prevent the inadvertent deletion of a virtual machine, you can enable virtual machine delete protection by using the command line.
+
+.Prerequisites
+
+* You have installed {VirtProductName} 4.19 or later.
+* You have installed the OpenShift CLI (`oc`).
+
+.Procedure
+
+* Enable delete protection for a VM by running the following command:
+
+[source,terminal]
+----
+$ oc patch vm <vm-name> --type merge -p '{"metadata":{"labels":{"kubevirt.io/vm-delete-protection":"True"}}}' -n <namespace>
+----
+
+* Disable delete protection for a VM by running the following command:
+[source,terminal]
+----
+$ oc patch vm <vm-name> --type json -p '[{"op": "remove", "path": "/metadata/labels/kubevirt.io~1vm-delete-protection"}]' -n <namespace>
+----

modules/virt-enabling-disabling-vm-delete-protection-web.adoc

@@ -0,0 +1,37 @@
+// Module included in the following assemblies:
+//
+// * virt/managing-vms/virt-enabling-disabling-vm-delete-protection.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-enabling-disabling-vm-delete-protection-web_{context}"]
+
+= Enabling or disabling virtual machine delete protection by using the web console
+
+To prevent the inadvertent deletion of a virtual machine, you can enable virtual machine delete protection by using the {product-title} web console.
+
+.Prerequisites
+
+* You have installed {VirtProductName} 4.19 or later.
+* You have installed the OpenShift CLI (`oc`).
+
+.Procedure
+
+. From the {product-title} web console, choose your view:
+
+    * For a virtualization-focused view, select *Administrator* → *Virtualization* → *VirtualMachines*.
+
+    * For a general view, navigate to *Virtualization* → *VirtualMachines*.
+
+. From the *VirtualMachines* list, select the VM whose delete protection you want to enable or disable.
+
+. Click the *Configuration* tab.
+
+. In the *VirtualMachines details*, choose to enable or disable the protection as follows:
+
+* To enable the protection:
+.. Set the *Deletion protection* switch to *On*.
+.. Click *Enable* to confirm the protection.
+
+ * To disable the protection:
+.. Set the *Deletion protection* switch to *Off*.
+.. Click *Disable* to confirm the protection.

virt/managing_vms/virt-enabling-disabling-vm-delete-protection.adoc

@@ -0,0 +1,19 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="virt-enabling-disabling-vm-delete-protection"]
+= Enabling or disabling virtual machine delete protection
+include::_attributes/common-attributes.adoc[]
+:context: virt-enabling-disabling-vm-delete-protection
+
+toc::[]
+
+You can prevent the inadvertent deletion of a virtual machine (VM) by enabling delete protection. You can also disable delete protection.
+
+You enable or disable delete protection from either the {product-title} web console or the command line.
+
+.Prerequisites
+
+* You have installed {VirtProductName} 4.19 or later.
+* You have installed the OpenShift CLI (`oc`).
+
+include::modules/virt-enabling-disabling-vm-delete-protection-web.adoc[leveloffset=+1]
+include::modules/virt-enabling-disabling-vm-delete-protection-cli.adoc[leveloffset=+1]