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 sugli errori.
La cronologia delle distribuzioni per un gruppo di risorse è limitata a 800 distribuzioni. Quando si è prossimi al limite, le distribuzioni vengono automaticamente eliminate dalla cronologia. Per altre informazioni, vedere Eliminazioni automatiche dalla cronologia di distribuzione.
Per informazioni sulla risoluzione di errori di distribuzione specifici, vedere Risoluzione dei problemi 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 correlazione per identificare le operazioni per la distribuzione che ha restituito un errore.
Gli esempi in questo articolo mostrano come recuperare l'ID correlazione.
Distribuzioni di gruppi di risorse
È possibile visualizzare informazioni dettagliate sulla distribuzione di un gruppo di risorse tramite il portale di Azure, PowerShell, Azure CLI o l'API 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 parametro DeploymentName.
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 più recente dell'API da usare nella richiesta, vedere Distribuzioni - Elenca 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 più recente dell'API 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.
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 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
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
Per elencare le distribuzioni per una sottoscrizione, usare l'operazione seguente. Per il numero di versione più recente dell'API 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 a livello di 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.
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, si riceverà 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
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, si riceverà 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 più recente dell'API 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, si riceverà 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 dell'API più recente da usare nella richiesta, vedere Distribuzioni - Ottenere l'ambito a livello di 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",
...
}
}
Distribuzione tenant
È possibile visualizzare la cronologia delle distribuzioni in un tenant.
Il portale non mostra attualmente le distribuzioni in un 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, si riceverà un errore.
Get-AzTenantDeployment
Per ottenere una distribuzione specifica dal tenant corrente, aggiungere il parametro Name.
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, si riceverà 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 ottenere il numero di versione più recente dell'API da utilizzare nella richiesta, consultare Distribuzioni - Elenco per ambito tenant. Se non si dispone di autorizzazioni sufficienti per visualizzare le distribuzioni per il tenant, si riceverà 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 l'ambito a livello di 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 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 operativi.
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 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 avere Azure CLI 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 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 più recente dell'API da usare nella richiesta, vedere Deployment Operations - List.
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:
Passaggi successivi