Merge pull request #102981 from v-davit/patch-2

Updated file with responses

Author: PRMerger19

articles/virtual-machines/maintenance-control-cli.md

@@ -28,13 +28,13 @@ With maintenance control, you can:
 > Maintenance Control is currently in public preview.
 > This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. 
 > For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
-> 
+>
 
 ## Limitations
 
 - VMs must be on a [dedicated host](./linux/dedicated-hosts.md), or be created using an [isolated VM size](./linux/isolation.md).
 - After 35 days, an update will automatically be applied.
-- User must have **Resource Owner** access.
+- User must have **Resource Contributor** access.
 
 
 ## Install the maintenance extension
@@ -148,6 +148,23 @@ az maintenance assignment list \
 
 Use `az maintenance update list` to see if there are pending updates. Update --subscription to be the ID for the subscription that contains the VM.
 
+If there are no updates, the command will return an error message, which will contain the text: `Resource not found...StatusCode: 404`.
+
+If there are updates, only one will be returned, even if there are multiple updates pending. The data for this update will be returned in an object:
+
+```text
+[
+  {
+    "impactDurationInSec": 9,
+    "impactType": "Freeze",
+    "maintenanceScope": "Host",
+    "notBefore": "2020-03-03T07:23:04.905538+00:00",
+    "resourceId": "/subscriptions/9120c5ff-e78e-4bd0-b29f-75c19cadd078/resourcegroups/DemoRG/providers/Microsoft.Compute/hostGroups/demoHostGroup/hosts/myHost",
+    "status": "Pending"
+  }
+]
+  ```
+
 ### Isolated VM
 
 Check for pending updates for an isolated VM. In this example, the output is formatted as a table for readability.
@@ -163,7 +180,7 @@ az maintenance update list \
 
 ### Dedicated host
 
-To check for pending updates for a dedicated host. In this example, the output is formatted as a table for readability. Replace the values for the resources with your own.
+To check for pending updates for a dedicated host (ADH). In this example, the output is formatted as a table for readability. Replace the values for the resources with your own.
 
 ```azurecli-interactive
 az maintenance update list \
@@ -179,7 +196,7 @@ az maintenance update list \
 
 ## Apply updates
 
-Use `az maintenance apply update` to apply pending updates.
+Use `az maintenance apply update` to apply pending updates. On success, this command will return JSON containing the details of the update.
 
 ### Isolated VM
 
@@ -188,7 +205,7 @@ Create a request to apply updates to an isolated VM.
 ```azurecli-interactive
 az maintenance applyupdate create \
    --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
-   -g myMaintenanceRG\
+   --resource-group myMaintenanceRG \
    --resource-name myVM \
    --resource-type virtualMachines \
    --provider-name Microsoft.Compute
@@ -202,7 +219,7 @@ Apply updates to a dedicated host.
 ```azurecli-interactive
 az maintenance applyupdate create \
    --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
-   -g myHostResourceGroup \
+   --resource-group myHostResourceGroup \
    --resource-name myHost \
    --resource-type hosts \
    --provider-name Microsoft.Compute \
@@ -214,17 +231,17 @@ az maintenance applyupdate create \
 
 You can check on the progress of the updates using `az maintenance applyupdate get`. 
 
-### Isolated VM
+You can use `default` as the update name to see results for the last update, or replace `myUpdateName` with the name of the update that was returned when you ran `az maintenance applyupdate create`.
 
-Replace `myUpdateName` with the name of the update that was returned when you ran `az maintenance applyupdate create`.
+### Isolated VM
 
 ```azurecli-interactive
 az maintenance applyupdate get \
    --resource-group myMaintenanceRG \
    --resource-name myVM \
    --resource-type virtualMachines \
    --provider-name Microsoft.Compute \
-   --apply-update-name myUpdateName 
+   --apply-update-name default 
 ```
 
 ### Dedicated host
@@ -238,7 +255,7 @@ az maintenance applyupdate get \
    --provider-name Microsoft.Compute \
    --resource-parent-name myHostGroup \ 
    --resource-parent-type hostGroups \
-   --apply-update-name default \
+   --apply-update-name myUpdateName \
    --query "{LastUpdate:lastUpdateTime, Name:name, ResourceGroup:resourceGroup, Status:status}" \
    --output table
 ```