添加链接
link之家
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接

通过 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 操作
  •