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

Artigo
03/20/2024

O Azure Resource Manager permite que você exiba seu histórico de implantação. Você pode examinar operações específicas nas implantações anteriores e ver quais recursos foram implantados. Esse histórico também 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 aproximar do limite, as implantações serão excluídas automaticamente do histórico. Para obter mais informações, confira Exclusões automáticas do histórico de implantações.

Para ajudar a resolver erros de implantação específicos, confira 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 essa ID para identificar as operações da implantação com falha.

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

Implantações do grupo de recursos

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

Selecione o grupo de recursos que você quer examinar.
Selecione o link em Implantações.
Selecione uma das implantações do histórico de implantações.
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 parâmetro DeploymentName.

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 para 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, confira Implantações - listar 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 operação a seguir. Para obter o número de versão da API mais recente a ser usado na solicitação, confira Implantações – obter.

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 a ID de correlação.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Implantações da assinatura

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

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

Para listar todas as implantações da assinatura atual, use o comando Get-AzSubscriptionDeployment. Esse comando é equivalente ao Get-AzDeployment.

Get-AzSubscriptionDeployment

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

Get-AzSubscriptionDeployment -Name ExampleDeployment

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

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

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

az deployment sub list

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

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 para uma assinatura, use a operação a seguir. Para obter o número de versão da API mais recente a ser usado na solicitação, confira 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 operação a seguir. Para obter o número de versão da API mais recente a ser usado na solicitação, confira 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 a ID de correlação.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Implantações do grupo de gerenciamento

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

Selecione o grupo de gerenciamento que você deseja examinar. Você não poderá selecionar o grupo de gerenciamento se não tiver permissões suficientes para exibir detalhes sobre ele.
No painel esquerdo, selecione Implantações.
Selecione uma das implantações do histórico de implantações.
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. Você obterá um erro se não tiver permissões suficientes para exibir implantações para o grupo de gerenciamento.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

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

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. Você obterá um erro se não tiver permissões suficientes para exibir implantações para o grupo de gerenciamento.

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

Para obter uma implantação específica, use o 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 para 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, confira Implantações - lista no escopo do grupo de gerenciamento. Você obterá um erro se não tiver permissões suficientes para exibir implantações para o grupo de gerenciamento.

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 a ID de correlação.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Implantações de locatário

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

No momento, o portal não mostra implantações de locatários.

Para listar todas as implantações atuais de locatário, use o comando Get-AzTenantDeployment. Você obterá um erro se não tiver permissões suficientes para exibir implantações para o locatário.

Get-AzTenantDeployment

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

Get-AzTenantDeployment -Name ExampleDeployment

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

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

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

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 do locatário atual, use a seguinte operação. Para obter o número de versão da API mais recente a ser usado na solicitação, confira Implantações – lista por escopo de locatário. Você obterá um erro se não tiver permissões suficientes para exibir implantações para o locatário.

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

Para obter uma implantação específica, use a operação a seguir. Para obter o número de versão da API mais recente a ser usado na solicitação, confira Implantações – obter por escopo de locatário.

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

A resposta inclui a ID de correlação.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

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, veja as operações de implantação. Quando uma implantação falha, as operações de implantação incluem uma mensagem de erro.

No resumo para uma implantação, selecione Detalhes da operação.
Você verá 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 as operações com falha, filtre as operações com o estado Falhou.

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

Para obter a mensagem de status das 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 as operações com falha, filtre as operações com o estado Falhou.

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

Para obter a mensagem de status das 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:

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, confira Operações de implantação – listar.

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/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"
        }
      }
    },
    ...
  ]
}

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

Próximas etapas

Para ajudar a resolver erros de implantação específicos, confira Solucionar erros comuns de implantação do Azure.
Para saber mais sobre como as implantações são gerenciadas no histórico, confira Exclusões automáticas do histórico de implantação.
Para visualizar as alterações que um modelo fará antes de ser implantado, confira Operação de teste de hipóteses da implantação do modelo ARM.

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

ID de correlação e suporte

Implantações do grupo de recursos

Implantações da assinatura

Implantações do grupo de gerenciamento

Implantações de locatário

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

Próximas etapas

Recursos adicionais