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 implementaçõ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 o 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 implementações para a subscrição atual, use 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 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 Implementações - Lista ao nível 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 mais recente da API 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 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 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}
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 do grupo de gestão.
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 Implementações - Lista no escopo do cliente. 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}
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 Implementações - Obter no escopo do locatário.
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 num 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:
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