Visualizzare la cronologia delle distribuzioni con Azure Resource Manager

Articolo
03/20/2024

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

La cronologia della 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 di 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 tecnico di Azure, è possibile che il supporto richieda l'ID di correlazione. Il supporto usa l'ID correlazione per identificare le operazioni per la distribuzione non riuscita.

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

Distribuzioni di gruppi di risorse

È possibile visualizzare i dettagli sulla distribuzione di un gruppo di risorse tramite l'API PORTALE DI AZURE, PowerShell, l'interfaccia della riga di comando di Azure o REST.

Selezionare il gruppo di risorse da esaminare.
Selezionare il collegamento in Distribuzioni.
Selezionare una delle distribuzioni dalla cronologia delle distribuzioni.
Viene visualizzato un riepilogo della distribuzione, incluso l'ID correlazione.

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 DeploymentName parametro .

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Per ottenere l'ID di correlazione, usare:

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

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

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

Distribuzioni di sottoscrizioni

È possibile visualizzare la cronologia delle distribuzioni in una sottoscrizione.

Selezionare la sottoscrizione da esaminare.
Nel riquadro sinistro selezionare Distribuzioni.
Selezionare una delle distribuzioni dalla cronologia delle distribuzioni.
Viene visualizzato un riepilogo della distribuzione, incluso l'ID correlazione.

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

Get-AzSubscriptionDeployment

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

Get-AzSubscriptionDeployment -Name ExampleDeployment

Per ottenere l'ID di correlazione, usare:

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

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

az deployment sub list

Per ottenere una distribuzione specifica, usare la sotto mostra az deployment.

az deployment sub show --name ExampleDeployment

Per ottenere l'ID di correlazione, usare:

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

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 - Elenco nell'ambito della 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 l'ambito della 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": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Distribuzioni di gruppi di gestione

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

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.
Nel riquadro sinistro selezionare Distribuzioni.
Selezionare una delle distribuzioni dalla cronologia delle distribuzioni.
Viene visualizzato un riepilogo della distribuzione, incluso l'ID correlazione.

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 Name parametro .

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Per ottenere l'ID di correlazione, usare:

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

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

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 - Elenco nell'ambito del 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}

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

Distribuzioni tenant

È possibile visualizzare la cronologia delle distribuzioni in un tenant.

Il portale attualmente non mostra le distribuzioni dei tenant.

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 dal tenant corrente, aggiungere il Name parametro .

Get-AzTenantDeployment -Name ExampleDeployment

Per ottenere l'ID di correlazione, usare:

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

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 il comando 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

Per elencare le distribuzioni per il tenant corrente, usare l'operazione seguente. Per il numero di versione più recente dell'API da usare nella richiesta, vedere Distribuzioni - Elenco nell'ambito del 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 più recente dell'API da usare nella richiesta, vedere Distribuzioni - Ottenere l'ambito del 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": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Operazioni di distribuzione e 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.

Nel riepilogo di una distribuzione selezionare Dettagli operazione.
Vengono visualizzati i dettagli per il passaggio della distribuzione. Quando si verifica un errore, i dettagli includono il messaggio di errore.

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:

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:

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

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

Passaggi successivi

Per risolvere errori di distribuzione specifici, vedere Risolvere gli errori comuni di distribuzione di Azure.
Per informazioni sulla gestione delle distribuzioni nella cronologia, vedere Eliminazioni automatiche dalla cronologia di distribuzione.
Per visualizzare in anteprima le modifiche apportate a un modello prima della distribuzione, vedere l'operazione di simulazione della distribuzione del modello di Resource Manager.

Visualizzare la cronologia delle distribuzioni con Azure Resource Manager

ID di correlazione e supporto

Distribuzioni di gruppi di risorse

Distribuzioni di sottoscrizioni

Distribuzioni di gruppi di gestione

Distribuzioni tenant

Operazioni di distribuzione e messaggio di errore

Passaggi successivi

Risorse aggiuntive