Ver o histórico de implementações com o Azure Resource Manager

Artigo
03/20/2024

O Azure Resource Manager permite-lhe ver o histórico de implementações. 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 erros.

O histórico de implementações de um grupo de recursos está limitado a 800 implementações. À medida que se aproxima do limite, as implementações são automaticamente eliminadas do histórico. Para obter mais informações, veja Eliminações automáticas do histórico de implementações.

Para obter ajuda com a resolução de erros de implementação específicos, veja Resolver erros comuns de implementação do Azure.

ID de Correlação e suporte

Cada implementação tem um ID de correlação, que é utilizado para monitorizar eventos relacionados. Se criar um pedido de suporte do Azure, o suporte poderá pedir-lhe o ID de correlação. O suporte utiliza o ID de correlação para identificar as operações da implementação falhada.

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

Implementações de grupos de recursos

Pode ver detalhes sobre a implementação de um grupo de recursos através do portal do Azure, do PowerShell, da CLI do Azure ou da API REST.

Selecione o grupo de recursos que pretende examinar.
Selecione a ligação em Implementações.
Selecione uma das implementações no histórico de implementações.
É apresentado um resumo da implementação, incluindo o ID de correlação.

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

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

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

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Para obter o ID de correlação, utilize:

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

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

az deployment group list --resource-group ExampleGroup

Para obter uma implementação específica, utilize az deployment group show.

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

Para obter o ID de correlação, utilize:

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

Para listar as implementações de um grupo de recursos, utilize a seguinte operação. Para obter o número da versão mais recente da API a utilizar no pedido, veja Deployments - List By Resource Group (Implementaçõ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 implementação específica, utilize a seguinte operação. Para obter o número da versão mais recente da API a utilizar no pedido, veja Implementaçõ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 o 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",
   ...
 }
}

Implementações de subscrições

Pode ver o histórico de implementações numa subscrição.

Selecione a subscrição que pretende examinar.
No painel esquerdo, selecione Implementações.
Selecione uma das implementações no histórico de implementações.
É apresentado um resumo da implementação, incluindo o ID de correlação.

Para listar todas as implementações da subscrição atual, utilize o Get-AzSubscriptionDeployment comando . Este comando é equivalente a Get-AzDeployment.

Get-AzSubscriptionDeployment

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

Get-AzSubscriptionDeployment -Name ExampleDeployment

Para obter o ID de correlação, utilize:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Para listar todas as implementações da subscrição atual, utilize az deployment sub list.

az deployment sub list

Para obter uma implementação específica, utilize az deployment sub show.

az deployment sub show --name ExampleDeployment

Para obter o ID de correlação, utilize:

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

Para listar as implementações de uma subscrição, utilize a seguinte operação. Para obter o número da versão mais recente da API a utilizar no pedido, veja Deployments - List At Subscription Scope (Implementações – Lista no Âmbito da Subscrição).

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

Para obter uma implementação específica, utilize a seguinte operação. Para obter o número da versão mais recente da API a utilizar no pedido, veja Deployments - Get At Subscription Scope (Implementações – Obter no Âmbito da Subscrição).

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": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Implementações de grupos de gestão

Pode ver o histórico de implementações num grupo de gestão.

Selecione o grupo de gestão que pretende examinar. Se não tiver permissões suficientes para ver detalhes sobre o grupo de gestão, não poderá selecioná-lo.
No painel esquerdo, selecione Implementações.
Selecione uma das implementações no histórico de implementações.
É apresentado um resumo da implementação, incluindo o ID de correlação.

Para listar todas as implementações de um grupo de gestão, utilize o comando Get-AzManagementGroupDeployment . Se não tiver permissões suficientes para ver as implementações do grupo de gestão, receberá um erro.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

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

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Para obter o ID de correlação, utilize:

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

Para listar todas as implementações de um grupo de gestão, utilize az deployment mg list. Se não tiver permissões suficientes para ver as implementações do grupo de gestão, receberá um erro.

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

Para obter uma implementação específica, utilize az deployment mg show.

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

Para obter o ID de correlação, utilize:

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

Para listar as implementações de um grupo de gestão, utilize a seguinte operação. Para obter o número da versão mais recente da API a utilizar no pedido, veja Deployments - List At Management Group Scope (Implementações – Lista no Âmbito do Grupo de Gestão). Se não tiver permissões suficientes para ver as implementações do grupo de gestão, receberá um erro.

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

Para obter uma implementação específica, utilize a seguinte operação. Para obter o número da versão mais recente da API a utilizar no pedido, veja Deployments - Get At Management Group Scope (Implementações – Obter no Âmbito 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": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Implementações de inquilinos

Pode ver o histórico de implementações para um inquilino.

Atualmente, o portal não mostra implementações de inquilinos.

Para listar todas as implementações do inquilino atual, utilize o comando Get-AzTenantDeployment . Se não tiver permissões suficientes para ver as implementações do inquilino, receberá um erro.

Get-AzTenantDeployment

Para obter uma implementação específica do inquilino atual, adicione o Name parâmetro .

Get-AzTenantDeployment -Name ExampleDeployment

Para obter o ID de correlação, utilize:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Para listar todas as implementações do inquilino atual, utilize az deployment tenant list. Se não tiver permissões suficientes para ver as implementações do inquilino, receberá um erro.

az deployment tenant list

Para obter uma implementação específica, utilize az deployment tenant show.

az deployment tenant show --name ExampleDeployment

Para obter o ID de correlação, utilize:

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

Para listar as implementações do inquilino atual, utilize a seguinte operação. Para obter o número da versão mais recente da API a utilizar no pedido, veja Deployments - List At Tenant Scope (Implementações – Lista no Âmbito do Inquilino). Se não tiver permissões suficientes para ver as implementações do inquilino, receberá um erro.

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

Para obter uma implementação específica, utilize a seguinte operação. Para obter o número da versão mais recente da API a utilizar no pedido, veja Deployments - Get At Tenant Scope (Implementações – Obter no Âmbito do Inquilino).

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": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

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

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

No resumo de uma implementação, selecione Detalhes da operação.
Verá os detalhes desse passo da implementação. Quando ocorre um erro, os detalhes incluem a mensagem de erro.

Para ver as operações de implementação para implementação num grupo de recursos, utilize o comando Get-AzResourceGroupDeploymentOperation .

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Para ver operações falhadas, filtre as operações com o estado Com Falhas .

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

Para obter a mensagem de estado das operações falhadas, utilize o seguinte comando:

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

Para ver as operações de implementação de outros âmbitos, utilize:

Para ver as operações de implementação para implementação num grupo de recursos, utilize o comando az deployment operation group list . Tem de ter a CLI 2.6.0 do Azure ou posterior.

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

Para ver operações falhadas, filtre as operações com o estado Com Falhas .

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

Para obter a mensagem de estado das operações falhadas, utilize o seguinte comando:

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

Para ver as operações de implementação de outros âmbitos, utilize:

Para obter operações de implementação, utilize a seguinte operação. Para obter o número da versão mais recente da API a utilizar no pedido, veja Deployment Operations - List (Operações de Implementaçã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/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 ver as operações de implementação de outros âmbitos, utilize:

Passos seguintes

Para ajudar a resolver erros de implementação específicos, veja Resolver erros comuns de implementação do Azure.
Para saber como as implementações são geridas no histórico, veja Eliminações automáticas do histórico de implementações.
Para pré-visualizar as alterações que um modelo irá fazer antes de implementar, veja Operação de hipóteses de implementação do modelo do ARM.

Ver o histórico de implementações com o Azure Resource Manager

ID de Correlação e suporte

Implementações de grupos de recursos

Implementações de subscrições

Implementações de grupos de gestão

Implementações de inquilinos

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

Passos seguintes

Recursos adicionais