Afficher l’historique des déploiements avec Azure Resource Manager

Azure Resource Manager vous permet de voir l’historique de votre déploiement. Vous pouvez examiner des opérations spécifiques dans des déploiements antérieurs et voir quelles ressources ont été déployées. Cet historique contient des informations sur les erreurs éventuelles.

L’historique de déploiement de chaque groupe de ressources est limité à 800 déploiements. Quand vous vous approchez de la limite, les déploiements sont automatiquement supprimés de l’historique. Pour plus d’informations, consultez Suppressions automatiques de l’historique de déploiement.

Pour obtenir de l’aide sur la résolution d’erreurs de déploiement spécifiques, consultez Résoudre les erreurs courantes de déploiement Azure.

ID de corrélation et support

Chaque déploiement a un ID de corrélation, qui est utilisé pour suivre les événements connexes. Si vous créez une demande de support Azure, le support peut vous demander l’ID de corrélation. Le support utilise l’ID de corrélation pour identifier les opérations du déploiement qui a échoué.

Les exemples de cet article montrent comment extraire l’ID de corrélation.

Déploiements de groupes de ressources

Vous pouvez afficher les détails d’un déploiement de groupe de ressources via le Portail Azure, PowerShell, Azure CLI ou l’API REST.

Portail

1. Sélectionnez le groupe de ressources que vous souhaitez examiner.

   

2. Sélectionnez le lien sous Déploiements.

   

3. Sélectionnez un des déploiements dans l’historique des déploiements.

   

4. Un résumé du déploiement s’affiche, y compris l’ID de corrélation.

   

PowerShell

Pour répertorier tous les déploiements d’un groupe de ressources, utilisez la commande Get-AzResourceGroupDeployment.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup

Pour obtenir un déploiement spécifique à partir d’un groupe de ressources, ajoutez le paramètre DeploymentName.

Get-AzResourceGroupDeployment -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Pour obtenir l’ID de corrélation, utilisez :

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

Azure CLI

Pour répertorier tous les déploiements d’un groupe de ressources, utilisez az deployment group list.

az deployment group list --resource-group ExampleGroup

Pour obtenir un déploiement spécifique, utilisez az deployment group show.

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

Pour obtenir l’ID de corrélation, utilisez :

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

HTTP

Pour répertorier les déploiements d’un groupe de ressources, utilisez l’opération suivante. Pour obtenir le numéro de version le plus récent de l’API à utiliser dans la requête, consultez Déploiements – Liste par groupe de ressources.

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

Pour obtenir un déploiement spécifique, utilisez l’opération suivante. Pour obtenir le numéro de version le plus récent de l’API à utiliser dans la requête, consultez Déploiements – Récupérer.

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

La réponse inclut l’ID de corrélation.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Déploiements d’abonnements

Vous pouvez afficher l’historique des déploiements vers un abonnement.

Portail

1. Sélectionnez l’abonnement que vous souhaitez examiner.

   

2. Dans le volet gauche, sélectionnez Déploiements.

   

3. Sélectionnez un des déploiements dans l’historique des déploiements.

   

4. Un résumé du déploiement s’affiche, y compris l’ID de corrélation.

   

PowerShell

Pour lister tous les déploiements pour l’abonnement actuel, utilisez la commande Get-AzSubscriptionDeployment. Cette commande équivaut à Get-AzDeployment.

Get-AzSubscriptionDeployment

Pour obtenir un déploiement spécifique à partir d’un abonnement, ajoutez le paramètre Name.

Get-AzSubscriptionDeployment -Name ExampleDeployment

Pour obtenir l’ID de corrélation, utilisez :

(Get-AzSubscriptionDeployment -Name ExampleDeployment).CorrelationId

Azure CLI

Pour énumérer tous les déploiements pour l’abonnement actuel, utilisez az deployment sub list.

az deployment sub list

Pour obtenir un déploiement spécifique, utilisez az deployment sub show.

az deployment sub show --name ExampleDeployment

Pour obtenir l’ID de corrélation, utilisez :

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

HTTP

Pour répertorier les déploiements d’un abonnement, utilisez l’opération suivante. Pour obtenir le numéro de version le plus récent de l’API à utiliser dans la requête, consultez Déploiements – Liste de l’étendue d’abonnement.

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

Pour obtenir un déploiement spécifique, utilisez l’opération suivante. Pour obtenir le numéro de version le plus récent de l’API à utiliser dans la requête, consultez Déploiements – Obtenir l’étendue d’abonnement.

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

La réponse inclut l’ID de corrélation.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Déploiements de groupes d’administration

Vous pouvez afficher l’historique des déploiements vers un groupe d'administration.

Portail

1. Sélectionnez le groupe de gestion à examiner. Si vous n’avez pas les autorisations suffisantes pour afficher des détails sur le groupe de gestion, vous ne pourrez pas le sélectionner.

   

2. Dans le volet gauche, sélectionnez Déploiements.

   

3. Sélectionnez un des déploiements dans l’historique des déploiements.

   

4. Un résumé du déploiement s’affiche, y compris l’ID de corrélation.

   

PowerShell

Pour répertorier tous les déploiements d’un groupe d’administration, utilisez la commande Get-AzManagementGroupDeployment. Si vous n’avez pas les autorisations suffisantes pour afficher les déploiements pour le groupe de gestion, vous recevrez une erreur.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg

Pour obtenir un déploiement spécifique à partir d’un groupe d’administration, ajoutez le paramètre Name.

Get-AzManagementGroupDeployment -ManagementGroupId examplemg -Name ExampleDeployment

Pour obtenir l’ID de corrélation, utilisez :

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

Azure CLI

Pour énumérer tous les déploiements pour un groupe d’administration, utilisez az deployment mg list. Si vous n’avez pas les autorisations suffisantes pour afficher les déploiements pour le groupe de gestion, vous recevrez une erreur.

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

Pour obtenir un déploiement spécifique, utilisez az deployment mg show.

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

Pour obtenir l’ID de corrélation, utilisez :

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

HTTP

Pour répertorier les déploiements d’un groupe d'administration, utilisez l’opération suivante. Pour obtenir le numéro de version le plus récent de l’API à utiliser dans la requête, consultez Déploiements – Liste du groupe d'administration de l’abonnement. Si vous n’avez pas les autorisations suffisantes pour afficher les déploiements pour le groupe de gestion, vous recevrez une erreur.

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

Pour obtenir un déploiement spécifique, utilisez l’opération suivante. Pour obtenir le numéro de version le plus récent de l’API à utiliser dans la requête, consultez Déploiements – Obtenir le groupe d'administration de l’abonnement.

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

La réponse inclut l’ID de corrélation.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Déploiements de locataires

Vous pouvez afficher l’historique des déploiements vers un locataire.

Portail

Pour le moment, le portail n’affiche pas les déploiements des locataires.

PowerShell

Pour lister tous les déploiements du client actuel, utilisez la commande Get-AzTenantDeployment. Si vous n’avez pas les autorisations suffisantes pour afficher les déploiements pour le locataire, vous recevrez une erreur.

Get-AzTenantDeployment

Pour obtenir un déploiement spécifique à partir du locataire actuel, ajoutez le paramètre Name.

Get-AzTenantDeployment -Name ExampleDeployment

Pour obtenir l’ID de corrélation, utilisez :

(Get-AzTenantDeployment -Name ExampleDeployment).CorrelationId

Azure CLI

Pour énumérer tous les déploiements pour le locataire actuel, utilisez az deployment tenant list. Si vous n’avez pas les autorisations suffisantes pour afficher les déploiements pour le locataire, vous recevrez une erreur.

az deployment tenant list

Pour obtenir un déploiement spécifique, utilisez az deployment tenant show.

az deployment tenant show --name ExampleDeployment

Pour obtenir l’ID de corrélation, utilisez :

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

HTTP

Pour énumérer les déploiements pour le client actuel, utilisez l’opération suivante. Pour obtenir le numéro de version le plus récent de l’API à utiliser dans la requête, consultez Déploiements – Liste de l’étendue du locataire. Si vous n’avez pas les autorisations suffisantes pour afficher les déploiements pour le locataire, vous recevrez une erreur.

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

Pour obtenir un déploiement spécifique, utilisez l’opération suivante. Pour obtenir le numéro de version le plus récent de l’API à utiliser dans la requête, consultez Déploiements – Obtenir l’étendue du locataire.

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

La réponse inclut l’ID de corrélation.

{
 ...
 "properties": {
   "mode": "Incremental",
   "provisioningState": "Failed",
   "timestamp": "2019-11-26T14:18:36.4518358Z",
   "duration": "PT26.2091817S",
   "correlationId": "11111111-1111-1111-1111-111111111111",
   ...
 }
}

Opérations de déploiement et un message d’erreur

Chaque déploiement peut comprendre plusieurs opérations. Pour plus d’informations sur un déploiement, consultez les opérations de déploiement. En cas d’échec d’un déploiement, les opérations de déploiement incluent un message d’erreur.

Portail

1. Dans le résumé d’un déploiement, sélectionnez Détails des opérations.

   

2. Vous voyez les détails de cette étape du déploiement. Lorsqu’une erreur se produit, les détails incluent le message d’erreur.

   

PowerShell

Pour afficher les opérations de déploiement relatives au déploiement vers un groupe de ressources, utilisez la commande Get-AzResourceGroupDeploymentOperation.

Get-AzResourceGroupDeploymentOperation -ResourceGroupName ExampleGroup -DeploymentName ExampleDeployment

Pour afficher les opérations ayant échoué, filtrez les opérations à l’aide de l’état Échec.

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

Pour obtenir le message d’état d’opérations ayant échoué, utilisez la commande suivante :

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

Pour afficher les opérations de déploiement pour d’autres étendues, utilisez :

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

Azure CLI

Pour afficher les opérations de déploiement relatives au déploiement vers un groupe de ressources, utilisez la commande az deployment operation group list. Vous devez disposer d’Azure CLI 2.6.0 ou version ultérieure.

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

Pour afficher les opérations ayant échoué, filtrez les opérations à l’aide de l’état Échec.

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

Pour obtenir le message d’état d’opérations ayant échoué, utilisez la commande suivante :

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

Pour afficher les opérations de déploiement pour d’autres étendues, utilisez :

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

HTTP

Pour récupérer des opérations de déploiement, utilisez l’opération suivante. Pour obtenir le numéro de version le plus récent de l’API à utiliser dans la requête, consultez Opérations de déploiement – Liste.

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 réponse comprend un message d’erreur.

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

Pour afficher les opérations de déploiement pour d’autres étendues, utilisez :

• Opérations de déploiement - Liste de l’étendue de l’abonnement
• Opérations de déploiement - Liste de l’étendue du groupe d’administration
• Opérations de déploiement - Liste de l’étendue du locataire

Étapes suivantes

• Pour obtenir de l’aide sur la résolution d’erreurs de déploiement spécifiques, consultez Résoudre les erreurs courantes de déploiement Azure.
• Pour en savoir plus sur la gestion des déploiements dans l’historique, consultez Suppressions automatiques de l’historique de déploiement.
• Pour afficher un aperçu des modifications qu’apportera un modèle avant de le déployer, consultez Opération de simulation de déploiement de modèle ARM.