Visualizzare la cronologia delle distribuzioni con Azure Resource Manager
Articolo
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.
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.
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}
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 .
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.
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
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}
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 .
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 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}
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.
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}