Merge pull request #275402 from jain-ank/patch-23

Hibernation GA updates

Author: American-Dipper

articles/virtual-machines/hibernate-resume-troubleshooting.md

@@ -4,17 +4,13 @@ description: Learn how to troubleshoot VM hibernation.
 author: mattmcinnes
 ms.service: virtual-machines
 ms.topic: how-to
-ms.date: 10/31/2023
+ms.date: 05/16/2024
 ms.author: jainan
 ms.reviewer: mattmcinnes
 ---
 
 # Troubleshooting hibernation in Azure
 
-> [!IMPORTANT]
-> Azure Virtual Machines - Hibernation is currently in PREVIEW.
-> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
-
 Hibernating a virtual machine allows you to persist the VM state to the OS disk. This article describes how to troubleshoot issues with the hibernation feature, issues creating hibernation enabled VMs, and issues with hibernating a VM.
 
 For information specific to Linux VMs, check out the [Linux VM hibernation troubleshooting guide](./linux/hibernate-resume-troubleshooting-linux.md).
@@ -75,4 +71,4 @@ Starting a hibernated VM is similar to starting a stopped VM. In addition to com
 | ResultCode | errorDetails |
 |--|--|--|
 | OverconstrainedResumeFromHibernatedStateAllocationRequest | Allocation failed. VM(s) with the following constraints can't be allocated, because the condition is too restrictive. Remove some constraints and try again. Constraints applied are: Networking Constraints (such as Accelerated Networking or IPv6), Resuming from hibernated state (retry starting the VM after some time or alternatively stop-deallocate the VM and try starting the VM again). |
-| AllocationFailed | VM allocation failed from hibernated state due to insufficient capacity. Try again later or alternatively stop-deallocate the VM and try starting the VM. |
+| AllocationFailed | VM allocation failed from hibernated state due to insufficient capacity. Try again later or alternatively stop-deallocate the VM and try starting the VM. |

articles/virtual-machines/hibernate-resume.md

@@ -4,7 +4,7 @@ description: Overview of hibernating your VM.
 author: mattmcinnes
 ms.service: virtual-machines
 ms.topic: how-to
-ms.date: 04/10/2024
+ms.date: 05/14/2024
 ms.author: jainan
 ms.reviewer: mattmcinnes
 ms.custom: devx-track-azurecli, devx-track-azurepowershell
@@ -52,30 +52,32 @@ VM sizes with up to 64-GB RAM from the following General Purpose VM series suppo
 - [Edsv5-series](edv5-edsv5-series.md)
 
 VM sizes with up to 112-GB RAM from the following GPU VM series support hibernation.
-- [NVv4-series](../virtual-machines/nvv4-series.md)
-- [NVadsA10v5-series](../virtual-machines/nva10v5-series.md)
+- [NVv4-series](../virtual-machines/nvv4-series.md) (in preview)
+- [NVadsA10v5-series](../virtual-machines/nva10v5-series.md) (in preview)
+
+> [!IMPORTANT]
+> Azure Virtual Machines - Hibernation for GPU VMs is currently in PREVIEW.
+> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
 
 ### General limitations
-- You can't enable hibernation on existing VMs.
-- You can't resize a VM if it has hibernation enabled.
+- You can resize VMs that have hibernation enabled, but not when the VM is in a *Hibernated* state. The VM should either be in a *Running* or *Stopped* state.
 - Hibernation is only supported with Nested Virtualization when Trusted Launch is enabled on the VM
 - When a VM is hibernated, you can't attach, detach, or modify any disks or NICs associated with the VM. The VM must instead be moved to a Stop-Deallocated state.
 -	When a VM is hibernated, there's no capacity guarantee to ensure that there's sufficient capacity to start the VM later. In the rare case that you encounter capacity issues, you can try starting the VM at a later time. Capacity reservations don't guarantee capacity for hibernated VMs.
 -	You can only hibernate a VM using the Azure portal, CLI, PowerShell, SDKs and API. Hibernating the VM using guest OS operations don't result in the VM moving to a hibernated state and the VM continues to be billed.
--	You can't disable hibernation on a VM once enabled.
 
 ### Azure feature limitations
 -	Ephemeral OS disks
 -	Shared disks
 -	Availability Sets
--	Virtual Machine Scale Sets Uniform
+-	Virtual Machine Scale Sets in Uniform orchestration mode are not supported. Virtual Machine Scale Sets in [Flexible orchestration mode](../virtual-machine-scale-sets/virtual-machine-scale-sets-orchestration-modes.md) are supported.
 -	Spot VMs
 -	Managed images
 -	Azure Backup
 -	Capacity reservations
 
 ## Prerequisites to use hibernation
-- Hibernation must be enabled on your VM while creating the VM.
+- Hibernation must be enabled on your VM.
 - A persistent OS disk large enough to store the contents of the RAM, OS and other applications running on the VM is connected.
 - The VM size supports hibernation.
 -	The VM OS supports hibernation.
@@ -104,10 +106,10 @@ Refer to the [Linux hibernation troubleshooting guide](./linux/hibernate-resume-
     - Once a VM is placed in a hibernated state, you aren't charged for the VM, just like how you aren't charged for VMs in a stop (deallocated) state. You're only charged for the OS disk, data disks and any static IPs associated with the VM.
 
 - Can I enable hibernation on existing VMs?
-    - No, you can't enable hibernation on existing VMs. You can only enable hibernation at the time of creating a VM.
+    - Yes, you can enable hibernation on existing VMs.
 
 - Can I resize a VM with hibernation enabled?
-    - No. Once you enable hibernation on a VM, you can't resize the VM. 
+    - Yes, you can resize a VM with hibernation enabled. You cannot resize the VM if it's in a *Hibernated* state. Move the VM to either a *Running* or *Stopped* state before resizing.
 
 - Can I modify a VM once it is in a hibernated state?
     - No, once a VM is in a hibernated state, you can't perform actions like resizing the VM and modifying the disks. Additionally, you can't detach any disks or networking resources that are currently attached to the VM or attach new resources to the VM. You can however stop(deallocate) or delete the VM if you want to detach these resources. 
@@ -117,8 +119,6 @@ Refer to the [Linux hibernation troubleshooting guide](./linux/hibernate-resume-
 
     - When you hibernate a VM, the memory contents are first persisted in the OS disk, then the VM hibernates. You can't resize VMs in a hibernated state, nor detach/attach disks and networking resources to the VM.
 
-- Can you disable hibernation?
-    - No, you can't disable hibernation on a VM. 
 
 - Can I initiate hibernation from within the VM?
     - To hibernate a VM you should use the Azure portal, CLI, PowerShell commands, SDKs and APIs. Triggering hibernation from inside the VM still results in your VM being billed for the compute resources. 

articles/virtual-machines/includes/hibernate-resume-intro.md

@@ -5,16 +5,13 @@
  author: mattmcinnes
  ms.service: virtual-machines
  ms.topic: include
- ms.date: 04/10/2024
+ ms.date: 05/14/2024
  ms.author: jainan
  ms.reviewer: mattmcinnes
  ms.custom: include file
 ---
 
-> [!IMPORTANT]
-> Azure Virtual Machines - Hibernation is currently in PREVIEW.
-> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
 
 Hibernation allows you to pause VMs that aren't being used and save on compute costs. It's an effective cost management feature for scenarios such as:
 - Virtual desktops, dev/test servers, and other scenarios where the VMs don't need to run 24/7.
-- Systems with long boot times due to memory intensive applications. These applications can be initialized on VMs and hibernated. These “prewarmed” VMs can then be quickly started when needed, with the applications already up and running in the desired state.
+- Systems with long boot times due to memory intensive applications. These applications can be initialized on VMs and hibernated. These “prewarmed” VMs can then be quickly started when needed, with the applications already up and running in the desired state.

articles/virtual-machines/includes/hibernate-resume-platform-instructions.md

@@ -20,7 +20,7 @@ Once a VM with hibernation enabled has been created and the guest OS is configur
 
 To hibernate a VM in the Azure portal, click the 'Hibernate' button on the VM Overview page.
 
-![Screenshot of the button to hibernate a VM in the Azure portal.](/azure/virtual-machines/media/hibernate-resume/hibernate-overview-button.png)
+![Screenshot of the button to hibernate a VM in the Azure portal.](/azure/virtual-machines/media/hibernate-resume/hibernate-the-vm.png)
 
 #### [CLI](#tab/CLIDoHiber) 
 
@@ -66,7 +66,7 @@ https://management.azure.com/subscriptions/.../providers/Microsoft.Compute/virtu
 
 To view the state of a VM in the portal, check the 'Status' on the overview page. It should report as "Hibernated (deallocated)"
 
-![Screenshot of the Hibernated VM's status in the Azure portal listing as 'Hibernated (deallocated)'.](/azure/virtual-machines/media/hibernate-resume/is-hibernated-status.png)
+![Screenshot of the Hibernated VM's status in the Azure portal listing as 'Hibernated (deallocated)'.](/azure/virtual-machines/media/hibernate-resume/vm-in-hibernated-state.png)
 
 #### [PowerShell](#tab/PSStatCheck)
 
@@ -193,7 +193,7 @@ You can start hibernated VMs just like how you would start a stopped VM. This ca
 ### [Portal](#tab/PortalStartHiber)
 To start a hibernated VM using the Azure portal, click the 'Start' button on the VM Overview page.
 
-![Screenshot of the Azure portal button to start a hibernated VM with an underlined status listed as 'Hibernated (deallocated)'.](/azure/virtual-machines/media/hibernate-resume/start-hibernated-vm.png)
+![Screenshot of the Azure portal button to start a hibernated VM with an underlined status listed as 'Hibernated (deallocated)'.](/azure/virtual-machines/media/hibernate-resume/start-vm.png)
 
 ### [CLI](#tab/CLIStartHiber)