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": "aaaa0000-bb11-2222-33cc-444444dddddd",
...
}
}
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": "aaaa0000-bb11-2222-33cc-444444dddddd",
...
}
}
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}
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 do grupo de gerenciamento.
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": "aaaa0000-bb11-2222-33cc-444444dddddd",
...
}
}
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": "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, 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/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óximas etapas