Skip to content

Commit b2ea9b4

Browse files
committed
update
1 parent 5c54eb8 commit b2ea9b4

File tree

1 file changed

+18
-35
lines changed

1 file changed

+18
-35
lines changed

articles/azure-resource-manager/resource-manager-deployment-operations.md

Lines changed: 18 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,11 @@ Azure Resource Manager enables you to view your deployment history and examine s
1111

1212
For help with resolving particular deployment errors, see [Resolve common errors when deploying resources to Azure with Azure Resource Manager](resource-manager-common-deployment-errors.md).
1313

14-
## Get deployment
14+
## Get deployments
1515

1616
To get details about a deployment from the deployment history use portal, PowerShell, Azure CLI, or REST API.
1717

18-
#### [Browser](#tab/browser)
18+
# [Portal](#tab/azure-portal)
1919

2020
1. Select the resource group you want to examine.
2121

@@ -31,15 +31,15 @@ To get details about a deployment from the deployment history use portal, PowerS
3131

3232
![Deployment summary](./media/resource-manager-deployment-operations/show-correlation-id.png)
3333

34-
#### [PowerShell](#tab/powershell)
34+
# [PowerShell](#tab/azure-powershell)
3535

3636
To list all deployments for a resource group, use the [Get-AzResourceGroupDeployment](/powershell/module/az.resources/Get-AzResourceGroupDeployment) command.
3737

3838
```azurepowershell-interactive
3939
Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup
4040
```
4141

42-
To get one deployment from a resource group, use the **DeploymentName** parameter.
42+
To get a specific deployment from a resource group, use the **DeploymentName** parameter.
4343

4444
```azurepowershell-interactive
4545
Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment
@@ -51,12 +51,18 @@ The correlation ID is used to track related events. It can be helpful when worki
5151
(Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment).CorrelationId
5252
```
5353

54-
#### [Bash](#tab/bash)
54+
# [Azure CLI](#tab/azure-cli)
5555

56-
To get the overall status of a deployment, use the **azure group deployment show** command.
56+
To list the deployment for a resource group, use [az group deployment list](/cli/azure/group/deployment).
5757

5858
```azurecli-interactive
59-
az group deployment show -g ExampleGroup -n ExampleDeployment
59+
az group deployment list --resource-group ExampleGroup
60+
```
61+
62+
To get a specific deployment, use the [azure group deployment show](/cli/azure/group/deployment).
63+
64+
```azurecli-interactive
65+
az group deployment show --resource-group ExampleGroup --name ExampleDeployment
6066
```
6167

6268
The correlation ID is used to track related events, and can be helpful when working with technical support to troubleshoot a deployment.
@@ -65,7 +71,7 @@ The correlation ID is used to track related events, and can be helpful when work
6571
az group deployment show -g ExampleGroup -n ExampleDeployment --query properties.correlationId
6672
```
6773

68-
#### [HTTP](#tab/http)
74+
# [HTTP](#tab/http)
6975

7076
The following example shows how to get information about a deployment. For documentation about the latest API version, see the [Deployments - Get](/rest/api/resources/deployments/get) operation.
7177

@@ -96,7 +102,7 @@ In the response, note in particular the **provisioningState**, **correlationId**
96102

97103
To get details about a deployment from the deployment history use portal, PowerShell, Azure CLI, or REST API.
98104

99-
#### [Browser](#tab/browser)
105+
# [Portal](#tab/azure-portal)
100106

101107
1. To see deployment operations, select **Operation details**.
102108

@@ -106,24 +112,23 @@ To get details about a deployment from the deployment history use portal, PowerS
106112

107113
![Show operation details](./media/resource-manager-deployment-operations/show-operation-details.png)
108114

109-
110-
#### [PowerShell](#tab/powershell)
115+
# [PowerShell](#tab/azure-powershell)
111116

112117
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**.
113118

114119
```azurepowershell-interactive
115120
Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName azuredeploy
116121
```
117122

118-
#### [Bash](#tab/bash)
123+
# [Azure CLI](#tab/azure-cli)
119124

120125
To see the operations for a deployment, use:
121126

122127
```azurecli-interactive
123128
az group deployment operation list -g ExampleGroup -n ExampleDeployment
124129
```
125130

126-
#### [HTTP](#tab/http)
131+
# [HTTP](#tab/http)
127132

128133
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.
129134

@@ -160,19 +165,6 @@ The response includes request and/or response information based on what you spec
160165

161166
---
162167

163-
## Portal
164-
165-
166-
1. If your deployment failed, you see an error message. Select the error message for more details.
167-
168-
![View failed deployment](./media/resource-manager-deployment-operations/show-error.png)
169-
170-
1. The detailed error message is displayed.
171-
172-
![View error details](./media/resource-manager-deployment-operations/show-details.png)
173-
174-
175-
176168

177169
## PowerShell
178170

@@ -216,15 +208,6 @@ code message
216208
DnsRecordInUse DNS record dns.westus.cloudapp.azure.com is already used by another public IP. {}
217209
```
218210

219-
Every deployment operation in Azure includes request and response content. During deployment, you can use **DeploymentDebugLogLevel** parameter to specify that the request and/or response are logged.
220-
221-
You get that information from the log, and save it locally by using the following PowerShell commands:
222-
223-
```powershell
224-
(Get-AzResourceGroupDeploymentOperation -DeploymentName "TestDeployment" -ResourceGroupName "Test-RG").Properties.request | ConvertTo-Json | Out-File -FilePath <PathToFile>
225-
226-
(Get-AzResourceGroupDeploymentOperation -DeploymentName "TestDeployment" -ResourceGroupName "Test-RG").Properties.response | ConvertTo-Json | Out-File -FilePath <PathToFile>
227-
```
228211

229212
## Next steps
230213

0 commit comments

Comments
 (0)