Azure · Julie Zhu (yanzhudd) · Aug 21, 2026 · Aug 11, 2026 · Aug 13, 2026 · Aug 17, 2026
diff --git a/Commands/capacity/reservation/_create.md b/Commands/capacity/reservation/_create.md
@@ -23,3 +23,19 @@ Create operation to create or update a capacity reservation. Please note some pr
     ```bash
         capacity reservation create -c ReservationGroupName -n ReservationName -l centraluseuap -g MyResourceGroup  --sku Standard_A1_v2 --capacity 5 --zone 1 --tags key=val
     ```
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30vY2FwYWNpdHlyZXNlcnZhdGlvbnMve30=/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{}/capacityreservations/{} 2026-04-01 -->
+
+#### examples
+
+- Create a capacity reservation.
+    ```bash
+        capacity reservation create -c ReservationGroupName -n ReservationName -g MyResourceGroup --sku Standard_A0
+    ```
+
+- Create a capacity reservation with specific capacity and zones.
+    ```bash
+        capacity reservation create -c ReservationGroupName -n ReservationName -l centraluseuap -g MyResourceGroup  --sku Standard_A1_v2 --capacity 5 --zone 1 --tags key=val
+    ```
diff --git a/Commands/capacity/reservation/_delete.md b/Commands/capacity/reservation/_delete.md
@@ -25,3 +25,14 @@ Delete operation to delete a capacity reservation. This operation is allowed onl
     ```bash
         capacity reservation delete -c ReservationGroupName -n ReservationName -g MyResourceGroup --yes
     ```
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30vY2FwYWNpdHlyZXNlcnZhdGlvbnMve30=/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{}/capacityreservations/{} 2026-04-01 -->
+
+#### examples
+
+- Delete a capacity reservation.
+    ```bash
+        capacity reservation delete -c ReservationGroupName -n ReservationName -g MyResourceGroup --yes
+    ```
diff --git a/Commands/capacity/reservation/_show.md b/Commands/capacity/reservation/_show.md
@@ -23,3 +23,19 @@ Retrieve information about the capacity reservation.
     ```bash
         capacity reservation show -c ReservationGroupName -n ReservationName -g MyResourceGroup --instance-view
     ```
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30vY2FwYWNpdHlyZXNlcnZhdGlvbnMve30=/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{}/capacityreservations/{} 2026-04-01 -->
+
+#### examples
+
+- Get a capacity reservation.
+    ```bash
+        capacity reservation show -c ReservationGroupName -n ReservationName -g MyResourceGroup
+    ```
+
+- Get a capacity reservation containing the instance views.
+    ```bash
+        capacity reservation show -c ReservationGroupName -n ReservationName -g MyResourceGroup --instance-view
+    ```
diff --git a/Commands/capacity/reservation/_update.md b/Commands/capacity/reservation/_update.md
@@ -18,3 +18,14 @@ Update operation to update a capacity reservation.
     ```bash
         capacity reservation update -c ReservationGroupName -n ReservationName -g MyResourceGroup --capacity 5 --tags key=val
     ```
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30vY2FwYWNpdHlyZXNlcnZhdGlvbnMve30=/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{}/capacityreservations/{} 2026-04-01 -->
+
+#### examples
+
+- Update a capacity reservation.
+    ```bash
+        capacity reservation update -c ReservationGroupName -n ReservationName -g MyResourceGroup --capacity 5 --tags key=val
+    ```
diff --git a/Commands/capacity/reservation/group/_create.md b/Commands/capacity/reservation/group/_create.md
@@ -11,3 +11,7 @@ Create operation to create or update a capacity reservation group. When updating
 ### [2024-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30=/2024-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{} 2024-11-01 -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30=/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{} 2026-04-01 -->
diff --git a/Commands/capacity/reservation/group/_delete.md b/Commands/capacity/reservation/group/_delete.md
@@ -25,3 +25,14 @@ Delete operation to delete a capacity reservation group. This operation is allow
     ```bash
         capacity reservation group delete -n ReservationGroupName -g MyResourceGroup --yes
     ```
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30=/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{} 2026-04-01 -->
+
+#### examples
+
+- Delete a capacity reservation group.
+    ```bash
+        capacity reservation group delete -n ReservationGroupName -g MyResourceGroup --yes
+    ```
diff --git a/Commands/capacity/reservation/group/_list.md b/Commands/capacity/reservation/group/_list.md
@@ -20,3 +20,20 @@ List the capacity reservation groups.
     ```bash
         capacity reservation group list -g rg --vm-instance --vmss-instance
     ```
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHM=/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.compute/capacityreservationgroups 2026-04-01 -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups 2026-04-01 -->
+
+#### examples
+
+- List capacity reservation groups
+    ```bash
+        capacity reservation group list -g rg
+    ```
+
+- List the capacity reservation groups containing VM instances and VMSS instance which are associated to capacity reservation group
+    ```bash
+        capacity reservation group list -g rg --vm-instance --vmss-instance
+    ```
diff --git a/Commands/capacity/reservation/group/_show.md b/Commands/capacity/reservation/group/_show.md
@@ -11,3 +11,7 @@ Get operation that retrieves information about a capacity reservation group.
 ### [2024-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30=/2024-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{} 2024-11-01 -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30=/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{} 2026-04-01 -->
diff --git a/Commands/capacity/reservation/group/_update.md b/Commands/capacity/reservation/group/_update.md
@@ -11,3 +11,7 @@ Update operation to update a capacity reservation group. When updating a capacit
 ### [2024-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30=/2024-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{} 2024-11-01 -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL2NhcGFjaXR5cmVzZXJ2YXRpb25ncm91cHMve30=/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/capacityreservationgroups/{} 2026-04-01 -->
diff --git a/Commands/vm/_create.md b/Commands/vm/_create.md
@@ -19,3 +19,7 @@ Create operation to create or update a virtual machine. Please note some propert
 ### [2025-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2025-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2025-11-01 -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2026-04-01 -->
diff --git a/Commands/vm/_delete.md b/Commands/vm/_delete.md
@@ -55,3 +55,19 @@ Delete operation to delete a virtual machine.
     ```bash
         vm delete --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)
     ```
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2026-04-01 -->
+
+#### examples
+
+- Delete a VM without a prompt for confirmation.
+    ```bash
+        vm delete -g MyResourceGroup -n MyVm --yes
+    ```
+
+- Delete all VMs in a resource group.
+    ```bash
+        vm delete --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)
+    ```
diff --git a/Commands/vm/_list-all.md b/Commands/vm/_list-all.md
@@ -7,3 +7,7 @@ List all of the virtual machines in the specified subscription. Use the nextLink
 ### [2024-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcw==/2024-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/providers/microsoft.compute/virtualmachines 2024-11-01 -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcw==/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.compute/virtualmachines 2026-04-01 -->
diff --git a/Commands/vm/_list.md b/Commands/vm/_list.md
@@ -7,3 +7,7 @@ List all of the virtual machines in the specified resource group. Use the nextLi
 ### [2024-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcw==/2024-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines 2024-11-01 -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcw==/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines 2026-04-01 -->
diff --git a/Commands/vm/_show.md b/Commands/vm/_show.md
@@ -19,3 +19,7 @@ Get information about the model view or the instance view of a virtual machine.
 ### [2025-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2025-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2025-11-01 -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2026-04-01 -->
diff --git a/Commands/vm/_update.md b/Commands/vm/_update.md
@@ -21,3 +21,7 @@ Please note some properties can be set only during virtual machine creation
 ### [2025-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2025-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2025-11-01 -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2026-04-01 -->
diff --git a/Commands/vm/identity/_assign.md b/Commands/vm/identity/_assign.md
@@ -15,3 +15,7 @@ Assign the user or system managed identities.
 ### [2025-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2025-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2025-11-01 identity -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2026-04-01 identity -->
diff --git a/Commands/vm/identity/_remove.md b/Commands/vm/identity/_remove.md
@@ -15,3 +15,7 @@ Remove the user or system managed identities.
 ### [2025-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2025-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2025-11-01 identity -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2026-04-01 identity -->
diff --git a/Commands/vm/identity/_show.md b/Commands/vm/identity/_show.md
@@ -15,3 +15,7 @@ Show the details of managed identities.
 ### [2025-11-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2025-11-01.xml) **Stable**
 
 <!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2025-11-01 identity -->
+
+### [2026-04-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5jb21wdXRlL3ZpcnR1YWxtYWNoaW5lcy97fQ==/2026-04-01.xml) **Stable**
+
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.compute/virtualmachines/{} 2026-04-01 identity -->