update error messages

Author: tfitzmac

articles/azure-resource-manager/media/resource-manager-deployment-operations/get-correlation-id.png

@@ -13,7 +13,7 @@ For help with resolving particular deployment errors, see [Resolve common errors
 
 ## Get deployments and correlation ID
 
-To get details about a deployment from the deployment history use portal, PowerShell, Azure CLI, or REST API.
+You can view details about a deployment through the Azure portal, PowerShell, Azure CLI, or REST API. Each deployment has a correlation ID, which is used to track related events. It can be helpful when working with technical support to troubleshoot a deployment.
 
 # [Portal](#tab/azure-portal)
 
@@ -27,7 +27,7 @@ To get details about a deployment from the deployment history use portal, PowerS
 
    ![Select deployment](./media/resource-manager-deployment-operations/select-details.png)
 
-1. A summary of the deployment is displayed, including the correlation ID. The correlation ID is used to track related events, and can be helpful when working with technical support to troubleshoot a deployment.
+1. A summary of the deployment is displayed, including the correlation ID. 
 
     ![Deployment summary](./media/resource-manager-deployment-operations/show-correlation-id.png)
 
@@ -45,7 +45,7 @@ To get a specific deployment from a resource group, add the **DeploymentName** p
 Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment
 ```
 
-The correlation ID is used to track related events. It can be helpful when working with technical support to troubleshoot a deployment. To get the correlation ID, use:
+To get the correlation ID, use:
 
 ```azurepowershell-interactive
 (Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment).CorrelationId
@@ -65,155 +65,141 @@ To get a specific deployment, use the [azure group deployment show](/cli/azure/g
 az group deployment show --resource-group ExampleGroup --name ExampleDeployment
 ```
 
-The correlation ID is used to track related events. It can be helpful when working with technical support to troubleshoot a deployment. To get the correlation ID, use:
+To get the correlation ID, use:
 
 ```azurecli-interactive
 az group deployment show --resource-group ExampleGroup --name ExampleDeployment --query properties.correlationId
 ```
 
 # [HTTP](#tab/http)
 
-To list the deployments for a resource group, use the [Deployments - List By Resource Group](/rest/api/resources/deployments/listbyresourcegroup) operation.
+To list the deployments for a resource group, use the following operation. For the latest API version number to use in the request, see  [Deployments - List By Resource Group](/rest/api/resources/deployments/listbyresourcegroup). 
 
 ```
 GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/?api-version={api-version}
 ```
 
-To get a specific deployment. use the [Deployments - Get](/rest/api/resources/deployments/get) operation.
+To get a specific deployment. use the following operation. For the latest API version number to use in the request, see [Deployments - Get](/rest/api/resources/deployments/get).
 
 ```
 GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}?api-version={api-version}
 ```
 
-The response includes the correlation ID, which is used to track related events. It can be helpful when working with technical support to troubleshoot a deployment.
+The response includes the correlation ID.
 
 ```json
-{ 
+{
  ...
  "properties": {
-   "provisioningState":"Failed",
-   "correlationId":"d5062e45-6e9f-4fd3-a0a0-6b2c56b15757",
+   "mode": "Incremental",
+   "provisioningState": "Failed",
+   "timestamp": "2019-11-26T14:18:36.4518358Z",
+   "duration": "PT26.2091817S",
+   "correlationId": "47ff4228-bf2e-4ee5-a008-0b07da681230",
    ...
-   "error":{
-     "code":"DeploymentFailed","message":"At least one resource deployment operation failed. Please list deployment operations for details. Please see https://aka.ms/arm-debug for usage details.",
-     "details":[{"code":"Conflict","message":"{\r\n  \"error\": {\r\n    \"message\": \"Conflict\",\r\n    \"code\": \"Conflict\"\r\n  }\r\n}"}]
-   }  
  }
 }
 ```
 
 ---
 
-## Get deployment operations
+## Get deployment operations and error message
 
-To get details about a deployment from the deployment history use portal, PowerShell, Azure CLI, or REST API.
+Each deployment can include multiple operations. Each operation represents a step in the deployment process. To see more details about a deployment, view the deployment operations. When a deployment fails, the deployment operations include an error message.
 
 # [Portal](#tab/azure-portal)
 
 1. On the summary for a deployment, select **Operation details**.
 
     ![Select deployment operations](./media/resource-manager-deployment-operations/get-operation-details.png)
 
-1. You see the details for that step of the deployment.
+1. You see the details for that step of the deployment. When an error occurs, the details include the error message.
 
     ![Show operation details](./media/resource-manager-deployment-operations/see-operation-details.png)
 
 # [PowerShell](#tab/azure-powershell)
 
-Each deployment includes multiple operations. Each operation represents a step in the deployment process. To discover what went wrong with a deployment, you usually need to see details about the deployment operations. You can see the status of the operations with **Get-AzResourceGroupDeploymentOperation**.
+To view the deployment operations for deployment to a resource group, use the [Get-AzResourceGroupDeploymentOperation](/powershell/module/az.resources/get-azdeploymentoperation) command.
 
 ```azurepowershell-interactive
-Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName azuredeploy
+Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeploy
 ```
 
-# [Azure CLI](#tab/azure-cli)
-
-To see the operations for a deployment, use:
+To view failed operations, filter operations with **Failed** state.
 
-```azurecli-interactive
-az group deployment operation list -g ExampleGroup -n ExampleDeployment
+```azurepowershell-interactive
+(Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeploy).Properties | Where-Object ProvisioningState -eq Failed
 ```
 
-# [HTTP](#tab/http)
-
-The following example shows how to get deployment operations. For documentation about the latest API version, see the [Deployment Operations - List](/rest/api/resources/deploymentoperations/list) operation.
-
-```
-GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}/operations?$skiptoken={skiptoken}&api-version={api-version}
-```
-   
-The response includes request and/or response information based on what you specified in the **debugSetting** property during deployment.
+To get the status message of failed operations, use the following command:
 
-```json
-{
- ...
- "properties": 
- {
-   ...
-   "request":{
-     "content":{
-       "location":"West US",
-       "properties":{
-         "accountType": "Standard_LRS"
-       }
-     }
-   },
-   "response":{
-     "content":{
-       "error":{
-         "message":"Conflict","code":"Conflict"
-       }
-     }
-   }
- }
-}
+```azurepowershell-interactive
+((Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeploy ).Properties | Where-Object ProvisioningState -eq Failed).StatusMessage.error
 ```
 
----
-
-
-## PowerShell
+# [Azure CLI](#tab/azure-cli)
 
+To view the deployment operations for deployment to a resource group, use the [az group deployment operation list](/cli/azure/group/deployment/operation) command.
 
+```azurecli-interactive
+az group deployment operation list --resource-group ExampleGroup --name ExampleDeployment
+```
 
-To get more details about failed operations, retrieve the properties for operations with **Failed** state.
+To view failed operations, filter operations with **Failed** state.
 
-```azurepowershell-interactive
-(Get-AzResourceGroupDeploymentOperation -DeploymentName azuredeploy -ResourceGroupName ExampleGroup).Properties | Where-Object ProvisioningState -eq Failed
+```azurecli-interactive
+az group deployment operation list --resource-group ExampleGroup --name ExampleDeploy --query "[?properties.provisioningState=='Failed']"
 ```
 
-Which returns all the failed operations with each one in the following format:
+To get the status message of failed operations, use the following command:
 
-```powershell
-provisioningOperation : Create
-provisioningState     : Failed
-timestamp             : 2019-05-13T21:42:40.7151512Z
-duration              : PT3.1449887S
-trackingId            : f4ed72f8-4203-43dc-958a-15d041e8c233
-serviceRequestId      : a426f689-5d5a-448d-a2f0-9784d14c900a
-statusCode            : BadRequest
-statusMessage         : @{error=}
-targetResource        : @{id=/subscriptions/{guid}/resourceGroups/ExampleGroup/providers/
-                       Microsoft.Network/publicIPAddresses/myPublicIP;
-                       resourceType=Microsoft.Network/publicIPAddresses; resourceName=myPublicIP}
+```azurecli-interactive
+az group deployment operation list --resource-group ExampleGroup --name ExampleDeploy --query "[?properties.provisioningState=='Failed'].properties.statusMessage.error"
 ```
 
-Note the serviceRequestId and the trackingId for the operation. The serviceRequestId can be helpful when working with technical support to troubleshoot a deployment. You'll use the trackingId in the next step to focus on a particular operation.
+# [HTTP](#tab/http)
 
-To get the status message of a particular failed operation, use the following command:
+To get deployment operations, use the following operation. For the latest API version number to use in the request, see [Deployment Operations - List](/rest/api/resources/deploymentoperations/list).
 
-```azurepowershell-interactive
-((Get-AzResourceGroupDeploymentOperation -DeploymentName azuredeploy -ResourceGroupName ExampleGroup).Properties | Where-Object trackingId -eq f4ed72f8-4203-43dc-958a-15d041e8c233).StatusMessage.error
+```
+GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}/operations?$skiptoken={skiptoken}&api-version={api-version}
 ```
 
-Which returns:
+The response includes an error message.
 
-```powershell
-code           message                                                                        details
-----           -------                                                                        -------
-DnsRecordInUse DNS record dns.westus.cloudapp.azure.com is already used by another public IP. {}
+```json
+{
+  "value": [
+    {
+      "id": "/subscriptions/xxxx/resourceGroups/examplegroup/providers/Microsoft.Resources/deployments/exampledeploy/operations/13EFD9907103D640",
+      "operationId": "13EFD9907103D640",
+      "properties": {
+        "provisioningOperation": "Create",
+        "provisioningState": "Failed",
+        "timestamp": "2019-11-26T14:18:36.3177613Z",
+        "duration": "PT21.0580179S",
+        "trackingId": "9d3cdac4-54f8-486c-94bd-10c20867b8bc",
+        "serviceRequestId": "01a9d0fe-896b-4c94-a30f-60b70a8f1ad9",
+        "statusCode": "BadRequest",
+        "statusMessage": {
+          "error": {
+            "code": "InvalidAccountType",
+            "message": "The AccountType Standard_LRS1 is invalid. For more information, see - https://aka.ms/storageaccountskus"
+          }
+        },
+        "targetResource": {
+          "id": "/subscriptions/xxxx/resourceGroups/examplegroup/providers/Microsoft.Storage/storageAccounts/storageq2czadzfgizc2",
+          "resourceType": "Microsoft.Storage/storageAccounts",
+          "resourceName": "storageq2czadzfgizc2"
+        }
+      }
+    },
+    ...
+  ]
+}
 ```
 
+---
 
 ## Next steps