Exibir histórico de implantação com o Azure Resource Manager

Artigo
10/16/2024

O Azure Resource Manager permite que você exiba seu histórico de implantação. Pode examinar operações específicas em implementações anteriores e ver quais os recursos que foram implementados. Este histórico contém informações sobre quaisquer erros.

O histórico de implantação de um grupo de recursos é limitado a 800 implantações. À medida que você se aproxima do limite, as implantações são excluídas automaticamente do histórico. Para obter mais informações, consulte Exclusões automáticas do histórico de implantação.

Para obter ajuda com a resolução de erros de implantação específicos, consulte Solucionar erros comuns de implantação do Azure.

ID de correlação e suporte

Cada implantação tem uma ID de correlação, que é usada para rastrear eventos relacionados. Se você criar uma solicitação de suporte do Azure, o suporte poderá solicitar a ID de correlação. O suporte usa a ID de correlação para identificar as operações para a implantação com falha.

Os exemplos neste artigo mostram como recuperar a ID de correlação.

Implementações de grupos de recursos

Você pode exibir detalhes sobre uma implantação de grupo de recursos por meio do portal do Azure, PowerShell, CLI do Azure ou API REST.

Selecione o grupo de recursos que deseja examinar.
Selecione o link em Implantações.
Selecione uma das implantações no histórico de implantação.
Um resumo da implantação é exibido, incluindo a ID de correlação.

Para listar todas as implantações de um grupo de recursos, use o comando Get-AzResourceGroupDeployment .

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

Para obter uma implantação específica de um grupo de recursos, adicione o DeploymentName parâmetro.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Para obter a ID de correlação, use:

(Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment).CorrelationId

Para listar todas as implantações de um grupo de recursos, use az deployment group list.

az deployment group list --resource-group ExampleGroup

Para obter uma implantação específica, use az deployment group show.

az deployment group show --resource-group ExampleGroup --name ExampleDeployment

Para obter a ID de correlação, use:

az deployment group show --resource-group ExampleGroup --name ExampleDeployment --query properties.correlationId

Para listar as implantações de um grupo de recursos, use a operação a seguir. Para obter o número de versão da API mais recente a ser usado na solicitação, consulte Implantações - Lista por grupo de recursos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/?api-version={api-version}

Para obter uma implantação específica, use a seguinte operação. Para obter o número de versão da API mais recente a ser usado na solicitação, consulte Deployments - Get.

GET https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{resource-group-name}/providers/microsoft.resources/deployments/{deployment-name}?api-version={api-version}

A resposta inclui o ID de correlação.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

Implantações de assinatura

Você pode exibir o histórico de implantações de uma assinatura.

Selecione a assinatura que deseja examinar.
No painel esquerdo, selecione Implantações.
Selecione uma das implantações no histórico de implantação.
Um resumo da implantação é exibido, incluindo a ID de correlação.

Para listar todas as implantações para a assinatura atual, use o Get-AzSubscriptionDeployment comando. Este comando é equivalente a Get-AzDeployment.

Get-AzSubscriptionDeployment

Para obter uma implantação específica de uma assinatura, adicione o Name parâmetro.

Get-AzSubscriptionDeployment -Name ExampleDeployment

Para obter a ID de correlação, use:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Para listar todas as implantações para a assinatura atual, use az deployment sub list.

az deployment sub list

Para obter uma implantação específica, use o subshow az deployment.

az deployment sub show --name ExampleDeployment

Para obter a ID de correlação, use:

az deployment sub show --name ExampleDeployment --query properties.correlationId

Para listar as implantações de uma assinatura, use a operação a seguir. Para obter o número da versão mais recente da API a ser usado na solicitação, consulte Implantações - Lista no escopo da assinatura.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/?api-version={api-version}

Para obter uma implantação específica, use a seguinte operação. Para obter o número de versão da API mais recente a ser usado na solicitação, consulte Implantações - Obter no escopo da assinatura.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

A resposta inclui o ID de correlação.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

Implantações de grupos de gerenciamento

Você pode exibir o histórico de implantações em um grupo de gerenciamento.

Selecione o grupo de gerenciamento que deseja examinar. Se você não tiver permissões suficientes para exibir detalhes sobre o grupo de gerenciamento, não poderá selecioná-lo.
No painel esquerdo, selecione Implantações.
Selecione uma das implantações no histórico de implantação.
Um resumo da implantação é exibido, incluindo a ID de correlação.

Para listar todas as implantações de um grupo de gerenciamento, use o comando Get-AzManagementGroupDeployment . Se você não tiver permissões suficientes para exibir implantações para o grupo de gerenciamento, receberá um erro.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

Para obter uma implantação específica de um grupo de gerenciamento, adicione o Name parâmetro.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Para obter a ID de correlação, use:

(Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment).CorrelationId

Para listar todas as implantações de um grupo de gerenciamento, use az deployment mg list. Se você não tiver permissões suficientes para exibir implantações para o grupo de gerenciamento, receberá um erro.

az deployment mg list --management-group-id examplemg

Para obter uma implantação específica, use az deployment mg show.

az deployment mg show --management-group-id examplemg --name ExampleDeployment

Para obter a ID de correlação, use:

az deployment mg show --management-group-id examplemg --name ExampleDeployment --query properties.correlationId

Para listar as implantações de um grupo de gerenciamento, use a operação a seguir. Para obter o número de versão da API mais recente a ser usado na solicitação, consulte Implantações - Lista no escopo do grupo de gerenciamento. Se você não tiver permissões suficientes para exibir implantações para o grupo de gerenciamento, receberá um erro.

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/?api-version={api-version}

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

A resposta inclui o ID de correlação.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

Implementações de inquilinos

Você pode exibir o histórico de implantações para um locatário.

Atualmente, o portal não mostra implantações de locatário.

Para listar todas as implantações para o locatário atual, use o comando Get-AzTenantDeployment . Se você não tiver permissões suficientes para exibir implantações para o locatário, receberá um erro.

Get-AzTenantDeployment

Para obter uma implantação específica do locatário atual, adicione o Name parâmetro.

Get-AzTenantDeployment -Name ExampleDeployment

Para obter a ID de correlação, use:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Para listar todas as implantações para o locatário atual, use az deployment tenant list. Se você não tiver permissões suficientes para exibir implantações para o locatário, receberá um erro.

az deployment tenant list

Para obter uma implantação específica, use az deployment tenant show.

az deployment tenant show --name ExampleDeployment

Para obter a ID de correlação, use:

az deployment tenant show --name ExampleDeployment --query properties.correlationId

Para listar as implantações para o locatário atual, use a operação a seguir. Para obter o número de versão da API mais recente a ser usado na solicitação, consulte Implantações - Lista no escopo do locatário. Se você não tiver permissões suficientes para exibir implantações para o locatário, receberá um erro.

GET https://management.azure.com/providers/Microsoft.Resources/deployments/?api-version={api-version}

GET https://management.azure.com/providers/Microsoft.Resources/deployments/{deploymentName}?api-version={api-version}

A resposta inclui o ID de correlação.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
   ...
 }
}

Operações de implantação e mensagem de erro

Cada implantação pode incluir várias operações. Para ver mais detalhes sobre uma implantação, exiba as operações de implantação. Quando uma implantação falha, as operações de implantação incluem uma mensagem de erro.

No resumo de uma implantação, selecione Detalhes da operação.
Você vê os detalhes dessa etapa da implantação. Quando ocorre um erro, os detalhes incluem a mensagem de erro.

Para exibir as operações de implantação para implantação em um grupo de recursos, use o comando Get-AzResourceGroupDeploymentOperation .

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Para exibir operações com falha, filtre as operações com o estado Falha .

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -Name ExampleDeployment | Where-Object { $_.ProvisioningState -eq "Failed" }

Para obter a mensagem de status de operações com falha, use o seguinte comando:

(Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -Name ExampleDeployment | Where-Object { $_.ProvisioningState -eq "Failed" }).StatusMessage

Para exibir operações de implantação para outros escopos, use:

Para exibir as operações de implantação para implantação em um grupo de recursos, use o comando az deployment operation group list . Você deve ter a CLI do Azure 2.6.0 ou posterior.

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment

Para exibir operações com falha, filtre as operações com o estado Falha .

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment --query "[?properties.provisioningState=='Failed']"

Para obter a mensagem de status de operações com falha, use o seguinte comando:

az deployment operation group list --resource-group ExampleGroup --name ExampleDeployment --query "[?properties.provisioningState=='Failed'].properties.statusMessage.error"

Para exibir operações de implantação para outros escopos, use:

sublista de operações de implantação az
Lista MG da operação de implantação AZ
Lista de locatários da operação de implantação AZ.

Para obter operações de implantação, use a seguinte operação. Para obter o número de versão da API mais recente a ser usado na solicitação, consulte Operações de implantação - Lista.

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}

A resposta inclui uma mensagem de erro.

{
  "value": [
    {
      "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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": "aaaa0000-bb11-2222-33cc-444444dddddd",
        "serviceRequestId": "aaaa0000-bb11-2222-33cc-444444dddddd",
        "statusCode": "BadRequest",
        "statusMessage": {
          "error": {
            "code": "InvalidAccountType",
            "message": "The AccountType Standard_LRS1 is invalid. For more information, see - https://aka.ms/storageaccountskus"
          }
        },
        "targetResource": {
          "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/examplegroup/providers/Microsoft.Storage/storageAccounts/storage",
          "resourceType": "Microsoft.Storage/storageAccounts",
          "resourceName": "storage"
        }
      }
    },
    ...
  ]
}

Para exibir operações de implantação para outros escopos, use:

Próximos passos

Para obter ajuda para resolver erros de implantação específicos, consulte Solucionar erros comuns de implantação do Azure.
Para saber como as implantações são gerenciadas no histórico, consulte Exclusões automáticas do histórico de implantação.
Para visualizar as alterações que um modelo fará antes de implantar, consulte Operação hipotética de implantação de modelo ARM.

Partilhar via

Exibir histórico de implantação com o Azure Resource Manager

ID de correlação e suporte

Implementações de grupos de recursos

Implantações de assinatura

Implantações de grupos de gerenciamento

Implementações de inquilinos

Operações de implantação e mensagem de erro

Próximos passos

Comentários

Recursos adicionais