Visualizzare la cronologia delle distribuzioni con Azure Resource Manager

Azure Resource Manager consente di visualizzare la cronologia di distribuzione. È possibile esaminare operazioni specifiche nelle distribuzioni precedenti e vedere quali risorse sono state distribuite. Questa cronologia contiene informazioni su eventuali errori.

La cronologia di distribuzione per un gruppo di risorse è limitata a 800 distribuzioni. Quando si avvicina il limite, le distribuzioni vengono eliminate automaticamente dalla cronologia. Per alter informazioni, vedere Eliminazioni automatiche dalla cronologia delle distribuzioni.

Per informazioni sulla risoluzione di errori di distribuzione specifici, vedere Risolvere gli errori comuni di distribuzione di Azure.

ID correlazione e supporto

Ad ogni distribuzione è associato un ID correlazione, che viene usato per tenere traccia degli eventi correlati. Se si crea una richiesta di supporto di Azure, il supporto potrebbe richiedere l'ID di correlazione. Il supporto usa l'ID di correlazione per identificare le operazioni per la distribuzione non riuscita.

Gli esempi in questo articolo illustrano come recuperare l'ID di correlazione.

Distribuzioni di un gruppo di risorse

È possibile visualizzare i dettagli di una distribuzione di un gruppo di risorse tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando di Azure o l'API REST.

Portale

1. Selezionare il gruppo di risorse da esaminare.

   

2. Selezionare il collegamento in Distribuzioni.

   

3. Selezionare una delle distribuzioni dalla cronologia delle distribuzioni.

   

4. Viene visualizzato un riepilogo della distribuzione, incluso l'ID correlazione.

   

PowerShell

Per elencare tutte le distribuzioni per un gruppo di risorse, usare il comando Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

Per ottenere una distribuzione specifica da un gruppo di risorse, aggiungere il parametro DeploymentName.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Per ottenere l'ID di correlazione, usare:

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

Interfaccia della riga di comando di Azure

Per elencare tutte le distribuzioni per un gruppo di risorse, usare az deployment group list.

az deployment group list --resource-group ExampleGroup

Per ottenere una distribuzione specifica, usare az deployment group show.

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

Per ottenere l'ID di correlazione, usare:

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

HTTP

Per elencare le distribuzioni per un gruppo di risorse, usare l'operazione seguente. Per il numero di versione dell'API più recente da usare nella richiesta, vedere Distribuzioni: elencare per gruppo di risorse.

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

Per ottenere una distribuzione specifica, usare l'operazione seguente. Per il numero di versione dell'API più recente da usare nella richiesta, vedere Distribuzioni: ottenere.

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

La risposta include l'ID correlazione.

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

Distribuzioni di sottoscrizioni

È possibile visualizzare la cronologia delle distribuzioni in una sottoscrizione.

Portale

1. Selezionare la sottoscrizione da esaminare.

   

2. Nel riquadro sinistro selezionare Distribuzioni.

   

3. Selezionare una delle distribuzioni dalla cronologia delle distribuzioni.

   

4. Viene visualizzato un riepilogo della distribuzione, incluso l'ID correlazione.

   

PowerShell

Per elencare tutte le distribuzioni per la sottoscrizione corrente, usare il comando Get-AzSubscriptionDeployment. Questo comando equivale a Get-AzDeployment.

Get-AzSubscriptionDeployment

Per ottenere una distribuzione specifica da una sottoscrizione, aggiungere il parametro Name.

Get-AzSubscriptionDeployment -Name ExampleDeployment

Per ottenere l'ID di correlazione, usare:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Interfaccia della riga di comando di Azure

Per elencare tutte le distribuzioni per la sottoscrizione corrente, usare az deployment sub list.

az deployment sub list

Per ottenere una distribuzione specifica, usare az deployment sub show.

az deployment sub show --name ExampleDeployment

Per ottenere l'ID di correlazione, usare:

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

HTTP

Per elencare le distribuzioni per una sottoscrizione, usare l'operazione seguente. Per il numero di versione dell'API più recente da usare nella richiesta, vedere Distribuzioni: elencare con ambito sottoscrizione.

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

Per ottenere una distribuzione specifica, usare l'operazione seguente. Per il numero di versione dell'API più recente da usare nella richiesta, vedere Distribuzioni: ottenere con ambito sottoscrizione.

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

La risposta include l'ID correlazione.

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

Distribuzioni in un gruppo di gestione

È possibile visualizzare la cronologia delle distribuzioni in un gruppo di gestione.

Portale

1. Selezionare il gruppo di gestione da esaminare. Se non si dispone di autorizzazioni sufficienti per visualizzare i dettagli sul gruppo di gestione, non sarà possibile selezionarlo.

   

2. Nel riquadro sinistro selezionare Distribuzioni.

   

3. Selezionare una delle distribuzioni dalla cronologia delle distribuzioni.

   

4. Viene visualizzato un riepilogo della distribuzione, incluso l'ID correlazione.

   

PowerShell

Per elencare tutte le distribuzioni per un gruppo di gestione, usare il comando Get-AzManagementGroupDeployment. Se non si dispone di autorizzazioni sufficienti per visualizzare le distribuzioni per il gruppo di gestione, verrà visualizzato un errore.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

Per ottenere una distribuzione specifica da un gruppo di gestione, aggiungere il parametro Name.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Per ottenere l'ID di correlazione, usare:

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

Interfaccia della riga di comando di Azure

Per elencare tutte le distribuzioni per un gruppo di gestione, usare az deployment mg list. Se non si dispone di autorizzazioni sufficienti per visualizzare le distribuzioni per il gruppo di gestione, verrà visualizzato un errore.

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

Per ottenere una distribuzione specifica, usare az deployment mg show.

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

Per ottenere l'ID di correlazione, usare:

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

HTTP

Per elencare le distribuzioni per un gruppo di gestione, usare l'operazione seguente. Per il numero di versione più recente dell'API da usare nella richiesta, vedere Distribuzioni: elencare con ambito gruppo di gestione. Se non si dispone di autorizzazioni sufficienti per visualizzare le distribuzioni per il gruppo di gestione, verrà visualizzato un errore.

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

Per ottenere una distribuzione specifica, usare l'operazione seguente. Per il numero di versione più recente dell'API da usare nella richiesta, vedere Distribuzioni: ottenere con ambito gruppo di gestione.

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

La risposta include l'ID correlazione.

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

Distribuzioni di tenant

È possibile visualizzare la cronologia delle distribuzioni in un tenant.

Portale

Il portale non mostra attualmente le distribuzioni dei tenant.

PowerShell

Per elencare tutte le distribuzioni per il tenant corrente, usare il comando Get-AzTenantDeployment. Se non si dispone di autorizzazioni sufficienti per visualizzare le distribuzioni per il tenant, verrà visualizzato un errore.

Get-AzTenantDeployment

Per ottenere una distribuzione specifica da un gruppo di gestione, aggiungere il parametro Name.

Get-AzTenantDeployment -Name ExampleDeployment

Per ottenere l'ID di correlazione, usare:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Interfaccia della riga di comando di Azure

Per elencare tutte le distribuzioni per il tenant corrente, usare az deployment tenant list. Se non si dispone di autorizzazioni sufficienti per visualizzare le distribuzioni per il tenant, verrà visualizzato un errore.

az deployment tenant list

Per ottenere una distribuzione specifica, usare az deployment tenant show.

az deployment tenant show --name ExampleDeployment

Per ottenere l'ID di correlazione, usare:

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

HTTP

Per elencare le distribuzioni per un gruppo di gestione, usare l'operazione seguente. Per il numero di versione dell'API più recente da usare nella richiesta, vedere Distribuzioni: elencare con ambito tenant. Se non si dispone di autorizzazioni sufficienti per visualizzare le distribuzioni per il tenant, verrà visualizzato un errore.

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

Per ottenere una distribuzione specifica, usare l'operazione seguente. Per il numero di versione dell'API più recente da usare nella richiesta, vedere Distribuzioni: ottenere con ambito tenant.

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

La risposta include l'ID correlazione.

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

Operazioni di distribuzione e il messaggio di errore

Ogni distribuzione può includere più operazioni. Per visualizzare più dettagli su una distribuzione, vedere le operazioni di distribuzione. Quando una distribuzione ha esito negativo, le operazioni di distribuzione includono un messaggio di errore.

Portale

1. Nel riepilogo di una distribuzione selezionare Dettagli operazione.

   

2. Vengono visualizzati i dettagli per il passaggio della distribuzione. Quando si verifica un errore, i dettagli includono il messaggio di errore.

   

PowerShell

Per visualizzare le operazioni di distribuzione per la distribuzione in un gruppo di risorse, usare il comando Get-AzResourceGroupDeploymentOperation.

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Per visualizzare le operazioni non riuscite, filtrare le operazioni con lo stato Non riuscito.

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

Per ottenere il messaggio di stato delle operazioni non riuscite, usare il comando seguente:

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

Per visualizzare le operazioni di distribuzione per altri ambiti, usare:

• Get-AzDeploymentOperation
• Get-AzManagementGroupDeploymentOperation
• Get-AzTenantDeploymentOperation

Interfaccia della riga di comando di Azure

Per visualizzare le operazioni di distribuzione per la distribuzione in un gruppo di risorse, usare il comando az deployment operation group list. È necessario disporre dell'interfaccia della riga di comando di Azure 2.6.0 o versione successiva.

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

Per visualizzare le operazioni non riuscite, filtrare le operazioni con lo stato Non riuscito.

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

Per ottenere il messaggio di stato delle operazioni non riuscite, usare il comando seguente:

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

Per visualizzare le operazioni di distribuzione per altri ambiti, usare:

• az deployment operation sub list
• az deployment operation mg list
• az deployment operation tenant list.

HTTP

Per visualizzare le operazioni di distribuzione, usare l'operazione seguente. Per il numero di versione dell'API più recente da usare nella richiesta, vedere Distribuzioni: elencare.

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}

La risposta include un messaggio di errore.

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

Per visualizzare le operazioni di distribuzione per altri ambiti, usare:

• Operazioni di distribuzione - Elenco nell'ambito della sottoscrizione
• Operazioni di distribuzione - Elenco nell'ambito del gruppo di gestione
• Operazioni di distribuzione - Elenco nell'ambito del tenant

Passaggi successivi

• Identificare il codice errore della distribuzione usando la Guida alla risoluzione degli errori di distribuzione comuni di Azure.
• Per informazioni sulla gestione delle distribuzioni nella cronologia, vedere Eliminazioni automatiche dalla cronologia di distribuzione.
• Per visualizzare in anteprima le modifiche apportate da un modello prima della distribuzione, vedere Operazione di simulazione di distribuzione del modello di Resource Manager.