通过 Azure 资源管理器,你能够查看部署历史记录。 可以检查过去的部署中的特定操作和部署的资源。 此历史记录包含有关任何错误的信息。
一个资源组的部署历史记录限含 800 个部署。 接近限制时,将自动从历史记录中删除部署。 有关详细信息,请参阅
从部署历史记录中自动删除
。
有关解决特定部署错误的帮助,请参阅
排查常见的 Azure 部署错误
。
关联 ID 和支持
每个部署都有一个相关 ID,用于跟踪相关的事件。 如果你
创建 Azure 支持请求
,则客户支持可能会要求你提供相关 ID。 客户支持使用相关 ID 来识别失败部署的操作。
本文中的示例显示如何检索关联 ID。
资源组部署
可以通过 Azure 门户、PowerShell、Azure CLI 或 REST API 查看有关资源组部署的详细信息。
PowerShell
Azure CLI
若要列出一个资源组的所有部署,请使用
Get-AzResourceGroupDeployment
命令。
Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup
若要从资源组中获取特定部署,请添加 DeploymentName
参数。
Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment
若要获取相关 ID,请使用:
(Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment).CorrelationId
若要列出资源组部署,请使用 az deployment group list。
az deployment group list --resource-group ExampleGroup
若要获取特定部署,请使用 az 部署组显示。
az deployment group show --resource-group ExampleGroup --name ExampleDeployment
若要获取相关 ID,请使用:
az deployment group show --resource-group ExampleGroup --name ExampleDeployment --query properties.correlationId
若要列出某个资源组的部署,请使用以下操作。 若要在请求中使用最新的 API 版本号,请参阅部署 - 按资源组列出。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/?api-version={api-version}
若要获取特定部署,请使用以下操作。 如需在请求中使用的最新 API 版本号,请参阅部署 - 获取。
GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}?api-version={api-version}
响应包含相关 ID。
"properties": {
"mode": "Incremental",
"provisioningState": "Failed",
"timestamp": "2019-11-26T14:18:36.4518358Z",
"duration": "PT26.2091817S",
"correlationId": "11111111-1111-1111-1111-111111111111",
你可以查看订阅部署的历史记录。
PowerShell
Azure CLI
若要列出当前订阅的所有部署,请使用 Get-AzSubscriptionDeployment
命令。 此命令等效于 Get-AzDeployment。
Get-AzSubscriptionDeployment
若要从订阅中获取特定部署,请添加 Name
参数。
Get-AzSubscriptionDeployment -Name ExampleDeployment
若要获取相关 ID,请使用:
(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId
若要列出订阅的部署,请使用以下操作。 若要在请求中使用最新的 API 版本号,请参阅部署 - 在订阅范围列出。
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/?api-version={api-version}
若要获取特定部署,请使用以下操作。 若要在请求中使用最新的 API 版本号,请参阅部署 - 在订阅范围获取。
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}
响应包含相关 ID。
"properties": {
"mode": "Incremental",
"provisioningState": "Failed",
"timestamp": "2019-11-26T14:18:36.4518358Z",
"duration": "PT26.2091817S",
"correlationId": "11111111-1111-1111-1111-111111111111",
管理组部署
你可以查看管理组部署的历史记录。
PowerShell
Azure CLI
若要列出管理组的所有部署,请使用 Get-AzManagementGroupDeployment 命令。 如果没有足够的权限查看管理组的部署,则出现错误。
Get-AzManagementGroupDeployment -ManagementGroupId examplemg
若要从管理组中获取特定部署,请添加 Name
参数。
Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment
若要获取相关 ID,请使用:
(Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment).CorrelationId
若要列出管理组部署,请使用 az deployment mg list。 如果没有足够的权限查看管理组的部署,则出现错误。
az deployment mg list --management-group-id examplemg
若要获取特定部署,请使用 az deployment mg show。
az deployment mg show --management-group-id examplemg --name ExampleDeployment
若要获取相关 ID,请使用:
az deployment mg show --management-group-id examplemg --name ExampleDeployment --query properties.correlationId
若要列出管理组的部署,请使用以下操作。 若要在请求中使用最新的 API 版本号,请参阅部署 - 在管理组范围列出。 如果没有足够的权限查看管理组的部署,则出现错误。
GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/?api-version={api-version}
若要获取特定部署,请使用以下操作。 若要在请求中使用最新的 API 版本号,请参阅部署 - 在管理组范围获取。
GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}
响应包含相关 ID。
"properties": {
"mode": "Incremental",
"provisioningState": "Failed",
"timestamp": "2019-11-26T14:18:36.4518358Z",
"duration": "PT26.2091817S",
"correlationId": "11111111-1111-1111-1111-111111111111",
你可以查看租户部署的历史记录。
PowerShell
Azure CLI
若要列出当前租户的所有部署,请使用 Get-AzTenantDeployment 命令。 如果没有足够的权限查看租户的部署,则出现错误。
Get-AzTenantDeployment
若要从当前租户中获取特定部署,请添加 Name
参数。
Get-AzTenantDeployment -Name ExampleDeployment
若要获取相关 ID,请使用:
(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId
若要列出当前租户的所有部署,请使用 az deployment tenant list。 如果没有足够的权限查看租户的部署,则出现错误。
az deployment tenant list
若要获取特定部署,请使用 az deployment tenant show。
az deployment tenant show --name ExampleDeployment
若要获取相关 ID,请使用:
az deployment tenant show --name ExampleDeployment --query properties.correlationId
若要列出当前租户的部署,请使用以下操作。 若要在请求中使用最新的 API 版本号,请参阅部署 - 在租户范围列出。 如果没有足够的权限查看租户的部署,则出现错误。
GET https://management.azure.com/providers/Microsoft.Resources/deployments/?api-version={api-version}
若要获取特定部署,请使用以下操作。 若要在请求中使用最新的 API 版本号,请参阅部署 - 在租户范围获取。
GET https://management.azure.com/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}
响应包含相关 ID。
"properties": {
"mode": "Incremental",
"provisioningState": "Failed",
"timestamp": "2019-11-26T14:18:36.4518358Z",
"duration": "PT26.2091817S",
"correlationId": "11111111-1111-1111-1111-111111111111",
部署操作和错误消息
每个部署可能包括多个操作。 若要查看某个部署的更多详细信息,请参阅部署操作。 当部署失败时,部署操作会包含一条错误消息。
PowerShell
Azure CLI
若要查看部署到某个资源组时的部署操作,请使用 Get-AzResourceGroupDeploymentOperation 命令。
Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment
若要查看失败的操作,请使用“失败”状态筛选操作。
Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -Name ExampleDeployment | Where-Object { $_.ProvisioningState -eq "Failed" }
若要获取失败操作的状态消息,请使用以下命令:
(Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -Name ExampleDeployment | Where-Object { $_.ProvisioningState -eq "Failed" }).StatusMessage
若要查看其他范围的部署操作,请使用:
Get-AzDeploymentOperation
Get-AzManagementGroupDeploymentOperation
Get-AzTenantDeploymentOperation
若要查看部署到资源组的部署操作,请使用 az deployment operation group list 命令。 必须具有 Azure CLI 2.6.0 或更高版本。
az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment
若要查看失败操作,请筛选具有“失败”状态的操作。
az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment --query "[?properties.provisioningState=='Failed']"
若要获取失败操作的状态消息,请使用以下命令:
az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment --query "[?properties.provisioningState=='Failed'].properties.statusMessage.error"
若要查看其他范围的部署操作,请使用:
az deployment operation sub list
az deployment operation mg list
az deployment operation tenant list.
若要获取部署操作,请使用以下操作。 如需在请求中使用的最新 API 版本号,请参阅部署操作 - 列出。
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}
响应包含错误消息。
"value": [
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/examplegroup/providers/Microsoft.Resources/deployments/exampledeployment/operations/1234567890ABCDEF",
"operationId": "1234567890ABCDEF",
"properties": {
"provisioningOperation": "Create",
"provisioningState": "Failed",
"timestamp": "2019-11-26T14:18:36.3177613Z",
"duration": "PT21.0580179S",
"trackingId": "11111111-1111-1111-1111-111111111111",
"serviceRequestId": "11111111-1111-1111-1111-111111111111",
"statusCode": "BadRequest",
"statusMessage": {
"error": {
"code": "InvalidAccountType",
"message": "The AccountType Standard_LRS1 is invalid. For more information, see - https://aka.ms/storageaccountskus"
"targetResource": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/examplegroup/providers/Microsoft.Storage/storageAccounts/storage",
"resourceType": "Microsoft.Storage/storageAccounts",
"resourceName": "storage"
若要查看其他范围的部署操作,请使用:
部署操作 - 在订阅范围列出
部署操作 - 在管理组范围列出
部署操作 - 在租户范围内列出
有关解决特定部署错误的帮助,请参阅排查常见的 Azure 部署错误。
要了解历史记录中的部署是如何进行管理的,请参阅从部署历史记录中自动删除。
若要在部署模板前先预览更改,请参阅 ARM 模板部署 What-if 操作。