Affichage de l’utilisation de votre AMI - Amazon Elastic Compute Cloud
Comment fonctionnent les rapports d’utilisation des AMICréation d’un rapport d’utilisation d’AMIAffichage des rapports d’utilisation d’AMISuppression d’un rapport d’utilisation d’AMIQuotas de rapports

Affichage de l’utilisation de votre AMI

Si vous partagez vos images Amazon Machine Images (AMI) avec d’autres Comptes AWS, qu’il s’agisse d’Comptes AWS spécifiques, d’organisations, d’unités organisationnelles (OU) ou du grand public, vous pouvez voir comment ces AMI sont utilisées en créant des rapports d’utilisation des AMI. Les rapports fournissent de la visibilité sur :

  • quels Comptes AWS utilisent vos AMI dans des instances EC2 ou des modèles de lancement ;

  • combien d’instances EC2 ou de modèles de lancement font référence à chaque AMI.

Les rapports d’utilisation des AMI permettent de gérer plus efficacement vos AMI en vous aidant à :

  • Identifier les Comptes AWS et les types de ressources qui font référence à vos AMI afin de pouvoir annuler l’inscription des AMI ou les désactiver en toute sécurité.

  • Identifier les AMI inutilisées afin d’annuler leur inscription et de réduire les coûts de stockage.

  • Identifier vos AMI les plus utilisées.

Comment fonctionnent les rapports d’utilisation des AMI

Lorsque vous créez un rapport d’utilisation d’AMI, vous spécifiez :

  • L’AMI faisant l’objet du rapport.

  • Les Comptes AWS à vérifier (comptes spécifiques ou tous les comptes).

  • Les types de ressources à vérifier (instances EC2, modèles de lancement ou les deux).

  • Pour les modèles de lancement, le nombre de versions à vérifier (par défaut, les 20 versions les plus récentes).

Amazon EC2 crée un rapport distinct pour chaque AMI. Chaque rapport fournit :

  • Une liste des Comptes AWS utilisant l’AMI.

  • Le nombre de ressources référençant l’AMI par type de ressource par compte. Notez que pour les modèles de lancement, si une AMI est référencée dans plusieurs versions d’un modèle de lancement, le nombre n’est que de 1.

Important

Lorsque vous générez un rapport d’utilisation d’AMI, il se peut qu’il ne contienne pas l’activité la plus récente. L’activité des instances au cours des dernières 24 heures et l’activité du modèle de lancement au cours des derniers jours peuvent ne pas apparaître dans le rapport.

Amazon EC2 supprime automatiquement un rapport 30 jours après sa création. Vous pouvez télécharger des rapports depuis la console EC2 afin de les conserver localement.

Création d’un rapport d’utilisation d’AMI

Pour voir comment votre AMI est utilisée, vous devez d’abord créer un rapport d’utilisation d’AMI, en spécifiant les comptes et les types de ressources sur lesquels porte le rapport. Une fois le rapport créé, vous pouvez afficher le contenu du rapport. Vous pouvez également télécharger le rapport depuis la console EC2.

Console
Pour créer un rapport d’utilisation d’AMI

  1. Ouvrez la console Amazon EC2 à l’adresse https://console.aws.amazon.com/ec2/.

  2. Dans le panneau de navigation, sélectionnez AMI.

  3. Sélectionnez une AMI et choisissez Actions, Utilisation de mes AMI, Afficher l’utilisation de mes AMI.

  4. Sur la page Créer un rapport d’utilisation de mes AMI, procédez comme suit :

    1. En regard de Types de ressource, sélectionnez un ou plusieurs types de ressources sur lesquels porte le rapport.

    2. Pour ID de compte, sélectionnez l’une des options suivantes :

      • Choisissez Spécifier les ID de compte, puis choisissez Ajouter un ID de compte pour chaque compte sur lequel porte le rapport.

      • Choisissez Inclure tous les comptes pour créer un rapport sur tous les comptes.

    3. Choisissez Créer un rapport d’utilisation de mes AMI.

  5. Sur la page AMI, choisissez l’onglet Utilisation de mes AMI.

  6. Choisissez un ID de rapport pour en afficher les détails.

AWS CLI
Pour créer un rapport d’utilisation d’AMI pour une liste de comptes

Utilisez la commande create-image-usage-report avec les paramètres obligatoires suivants :

  • --image-id : ID de l’AMI sur laquelle porte le rapport.

  • --resource-types : les types de ressources à vérifier. Dans l’exemple suivant, les types de ressources à vérifier sont les instances EC2 et les modèles de lancement. En outre, le nombre de versions du modèle de lancement à vérifier est également spécifié (version-depth=100).

Pour créer un rapport sur des comptes spécifiques, utilisez le paramètre --account-ids pour spécifier l’ID de chaque compte sur lequel porte le rapport.

aws ec2 create-image-usage-report \
    --image-id ami-0abcdef1234567890 \
    --account-ids 111122223333 444455556666 123456789012 \
    --resource-types ResourceType=ec2:Instance \
      'ResourceType=ec2:LaunchTemplate,ResourceTypeOptions=[{OptionName=version-depth,OptionValues=100}]'
Pour créer un rapport d’utilisation d’AMI pour tous les comptes

Pour créer un rapport portant sur tous les comptes utilisant l’AMI spécifiée, utilisez la même commande, mais omettez le paramètre --account-ids.

aws ec2 create-image-usage-report \
    --image-id ami-0abcdef1234567890 \
    --resource-types ResourceType=ec2:Instance \
      'ResourceType=ec2:LaunchTemplate,ResourceTypeOptions=[{OptionName=version-depth,OptionValues=100}]'

Voici un exemple de sortie.

{
    "ReportId": "amiur-00b877d192f6b02d0"
}
Pour surveiller le statut de création du rapport

Utilisez la commande describe-image-usage-reports et spécifiez l’ID du rapport.

aws ec2 describe-image-usage-reports --report-ids amiur-00b877d192f6b02d0

Voici un exemple de sortie. La valeur initiale du champ State est pending. Pour pouvoir consulter les entrées du rapport, l’état doit être available.

{
    "ImageUsageReports": [
        {
            "ImageId": "ami-0e9ae3dc21c2b3a64",
            "ReportId": "amiur-abcae3dc21c2b3999",
            "ResourceTypes": [
                {"ResourceType": "ec2:Instance"}
            ],
            "State": "pending",
            "CreationTime": "2025-09-29T13:27:12.322000+00:00",
            "ExpirationTime": "2025-10-28T13:27:12.322000+00:00"
        }
    ]
}
PowerShell
Pour créer un rapport d’utilisation d’AMI pour une liste de comptes

Utilisez l’applet de commande New-EC2ImageUsageReport avec les paramètres obligatoires suivants :

  • -ImageId : ID de l’AMI sur laquelle porte le rapport.

  • -ResourceType : les types de ressources à vérifier. Dans l’exemple suivant, les types de ressources à vérifier sont les instances EC2 et les modèles de lancement. En outre, le nombre de versions du modèle de lancement à vérifier est également spécifié ('version-depth' = 100).

Pour créer un rapport sur des comptes spécifiques, utilisez le paramètre -AccountId pour spécifier l’ID de chaque compte sur lequel porte le rapport.

New-EC2ImageUsageReport `
    -ImageId ami-0abcdef1234567890 `
    -AccountId 111122223333 444455556666 123456789012 `
    -ResourceType @(
        @{ResourceType = 'ec2:Instance'},
        @{ResourceType = 'ec2:LaunchTemplate'ResourceTypeOptions = @{'version-depth' = 100}
        })
Pour créer un rapport d’utilisation d’AMI pour tous les comptes

Pour créer un rapport portant sur tous les comptes utilisant l’AMI spécifiée, utilisez la même commande, mais omettez le paramètre -AccountId.

New-EC2ImageUsageReport `
    -ImageId ami-0abcdef1234567890 `
    -ResourceType @(
        @{ResourceType = 'ec2:Instance'},
        @{ResourceType = 'ec2:LaunchTemplate'ResourceTypeOptions = @{'version-depth' = 100}
        })

Voici un exemple de sortie.

ReportId
--------
amiur-00b877d192f6b02d0
Pour surveiller le statut de création du rapport

Utilisez la commande Get-EC2ImageUsageReport et spécifiez l’ID du rapport.

Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0

Voici un exemple de sortie. La valeur initiale du champ State est pending. Pour pouvoir consulter les entrées du rapport, l’état doit être available.

ImageUsageReports
-----------------
{@{ImageId=ami-0e9ae3dc21c2b3a64; ReportId=amiur-abcae3dc21c2b3999; ResourceTypes=System.Object[]; State=pending; CreationTime=2025-09-29; ExpirationTime=2025-10-28}}

Affichage des rapports d’utilisation d’AMI

Vous pouvez consulter tous les rapports d’utilisation que vous avez créés pour une AMI au cours des 30 derniers jours. Amazon EC2 supprime automatiquement un rapport 30 jours après sa création.

Pour chaque rapport, vous pouvez voir les Comptes AWS qui utilisent l’AMI et, pour chaque compte, le nombre de ressources faisant référence à l’AMI par type de ressource. Vous pouvez également voir quand la création du rapport a été lancée. Ces informations ne sont disponibles que lorsque le rapport est à l’état Complet (console) ou available (AWS CLI).

Important

Lorsque vous générez un rapport d’utilisation d’AMI, il se peut qu’il ne contienne pas l’activité la plus récente. L’activité des instances au cours des dernières 24 heures et l’activité du modèle de lancement au cours des derniers jours peuvent ne pas apparaître dans le rapport.

Console
Pour consulter un rapport d’utilisation d’AMI

  1. Ouvrez la console Amazon EC2 à l’adresse https://console.aws.amazon.com/ec2/.

  2. Dans le panneau de navigation, sélectionnez AMI.

  3. Sélectionnez une AMI.

  4. Choisissez l’onglet Mes rapports d’utilisation.

    La liste des rapports affiche :

    • tous les rapports générés au cours des 30 derniers jours pour l’AMI sélectionnée ;

    • la colonne Heure de lancement du rapport indiquant la date à laquelle le rapport a été créé, pour chaque rapport.

  5. Choisissez l’ID d’un rapport pour afficher son contenu.

  6. Pour revenir à l’onglet Mes rapports d’utilisation sur la page de détails de l’AMI, choisissez Afficher tous les rapports pour cette AMI.

AWS CLI
Pour répertorier tous les rapports d’utilisation d’AMI pour l’AMI spécifiée

Utilisez la commande describe-image-usage-reports et spécifiez l’ID de l’AMI pour obtenir la liste de ses rapports.

aws ec2 describe-image-usage-reports --image-ids ami-0abcdef1234567890

Voici un exemple de sortie. Chaque ID de rapport est répertorié avec les types de ressources qui ont été analysés, ainsi que les dates de création et d’expiration du rapport. Vous pouvez utiliser ces informations pour identifier les rapports dont vous souhaitez consulter les entrées.

{
  "ImageUsageReports": [
    {
      "ImageId": "ami-0abcdef1234567890",
      "ReportId": "amiur-1111111111111111",
      "ResourceTypes": [
        {
          "ResourceType": "ec2:Instance"
        }
      ],
      "State": "available",
      "CreationTime": "2025-09-29T13:27:12.322000+00:00",
      "ExpirationTime": "2025-10-28T13:27:12.322000+00:00",
      "Tags": []
    },
    {
      "ImageId": "ami-0abcdef1234567890",
      "ReportId": "amiur-22222222222222222",
      "ResourceTypes": [
        {
          "ResourceType": "ec2:Instance"
        },
        {
          "ResourceType": "ec2:LaunchTemplate"
        }
      ],
      "State": "available",
      "CreationTime": "2025-10-01T13:27:12.322000+00:00",
      "ExpirationTime": "2025-10-30T13:27:12.322000+00:00",
      "Tags": []
    }
  ],
  "NextToken": "opaque"
}
Pour afficher le contenu d’un rapport d’utilisation d’AMI pour l’AMI spécifiée

Utilisez la commande describe-image-usage-report-entries et spécifiez l’ID de l’AMI. La réponse renvoie tous les rapports pour l’AMI spécifiée, indiquant les comptes qui ont utilisé l’AMI et le nombre de leurs ressources.

aws ec2 describe-image-usage-report-entries --image-ids ami-0abcdef1234567890

Voici un exemple de sortie.

{
  "ImageUsageReportEntries": [
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:Instance",
      "AccountId": "123412341234",
      "UsageCount": 15,
      "ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
      "ReportId": "amiur-1111111111111111"
    },
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:Instance",
      "AccountId": "123412341234",
      "UsageCount": 2,
      "ReportCreationTime": "2025-10-01T13:27:12.322000+00:00",
      "ReportId": "amiur-22222222222222222"
    },
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:Instance",
      "AccountId": "001100110011",
      "UsageCount": 39,
      "ReportCreationTime": "2025-10-01T13:27:12.322000+00:00",
      "ReportId": "amiur-22222222222222222"
    }
  ],
  "NextToken": "opaque"
}
Pour afficher le contenu d’un rapport d’utilisation d’AMI pour le rapport spécifié

Utilisez la commande describe-image-usage-report-entries et spécifiez l’ID du rapport. La réponse renvoie toutes les entrées du rapport spécifié, indiquant les comptes qui ont utilisé l’AMI et le nombre de leurs ressources.

aws ec2 describe-image-usage-report-entries --report-ids amiur-11111111111111111

Voici un exemple de sortie.

{
  "ImageUsageReportEntries": [
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:Instance",
      "AccountId": "123412341234",
      "UsageCount": 15,
      "ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
      "ReportId": "amiur-11111111111111111"
    },
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:LaunchTemplate",
      "AccountId": "123412341234",
      "UsageCount": 4,
      "ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
      "ReportId": "amiur-11111111111111111"
    },
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:LaunchTemplate",
      "AccountId": "001100110011",
      "UsageCount": 2,
      "ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
      "ReportId": "amiur-11111111111111111"
    }
  ],
  "NextToken": "opaque"
}
PowerShell
Pour répertorier tous les rapports d’utilisation d’AMI pour l’AMI spécifiée

Utilisez l’applet de commande Get-EC2ImageUsageReport et spécifiez l’ID de l’AMI pour obtenir la liste de ses rapports.

Get-EC2ImageUsageReport -ImageId ami-0abcdef1234567890

Voici un exemple de sortie. Chaque ID de rapport est répertorié avec les types de ressources qui ont été analysés, ainsi que les dates de création et d’expiration du rapport. Vous pouvez utiliser ces informations pour identifier les rapports dont vous souhaitez consulter les entrées.

@{
    ImageUsageReports = @(
        @{
            ImageId = "ami-0abcdef1234567890"
            ReportId = "amiur-1111111111111111"
            ResourceTypes = @(
                @{
                    ResourceType = "ec2:Instance"
                }
            )
            State = "available"
            CreationTime = "2025-09-29T13:27:12.322000+00:00"
            ExpirationTime = "2025-10-28T13:27:12.322000+00:00"
        },
        @{
            ImageId = "ami-0abcdef1234567890"
            ReportId = "amiur-22222222222222222"
            ResourceTypes = @(
                @{
                    ResourceType = "ec2:Instance"
                }
            )
            State = "available"
            CreationTime = "2025-09-30T13:27:12.322000+00:00"
            ExpirationTime = "2025-10-29T13:27:12.322000+00:00"
        },
        @{
            ImageId = "ami-0abcdef1234567890"
            ReportId = "amiur-33333333333333333"
            ResourceTypes = @(
                @{
                    ResourceType = "ec2:Instance"
                }
            )
            State = "available"
            CreationTime = "2025-10-01T13:27:12.322000+00:00"
            ExpirationTime = "2025-10-30T13:27:12.322000+00:00"
        }
    )
    NextToken = "opaque"
}
Pour afficher le contenu d’un rapport d’utilisation d’AMI pour l’AMI spécifiée

Utilisez l’applet de commande Get-EC2ImageUsageReportEntry et spécifiez l’ID de l’AMI. La réponse renvoie tous les rapports pour l’AMI spécifiée, indiquant les comptes qui ont utilisé l’AMI et le nombre de leurs ressources.

Get-EC2ImageUsageReportEntry -ImageId ami-0abcdef1234567890

Voici un exemple de sortie.

ImageUsageReportEntries : {@{
    ImageId = "ami-0abcdef1234567890"
    ResourceType = "ec2:Instance"
    AccountId = "123412341234"
    UsageCount = 15
    ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
    ReportId = "amiur-1111111111111111"
    }, @{
    ImageId = "ami-0abcdef1234567890"
    ResourceType = "ec2:Instance"
    AccountId = "123412341234"
    UsageCount = 7
    ReportCreationTime = "2025-09-30T13:27:12.322000+00:00"
    ReportId = "amiur-22222222222222222"
    }...}
NextToken : opaque
Pour afficher le contenu d’un rapport d’utilisation d’AMI pour le rapport spécifié

Utilisez l’applet de commande Get-EC2ImageUsageReportEntry et spécifiez l’ID du rapport. La réponse renvoie toutes les entrées du rapport spécifié, indiquant les comptes qui ont utilisé l’AMI et le nombre de leurs ressources.

Get-EC2ImageUsageReportEntry -ReportId amiur-11111111111111111

Voici un exemple de sortie.

ImageUsageReportEntries : {@{
    ImageId = "ami-0abcdef1234567890"
    ResourceType = "ec2:Instance"
    AccountId = "123412341234"
    UsageCount = 15
    ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
    ReportId = "amiur-11111111111111111"
    }, @{
    ImageId = "ami-0abcdef1234567890"
    ResourceType = "ec2:LaunchTemplate"
    AccountId = "123412341234"
    UsageCount = 4
    ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
    ReportId = "amiur-11111111111111111"
    }, @{
    ImageId = "ami-0abcdef1234567890"
    ResourceType = "ec2:LaunchTemplate"
    AccountId = "************"
    UsageCount = 2
    ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
    ReportId = "amiur-11111111111111111"
    }}
NextToken : opaque

Suppression d’un rapport d’utilisation d’AMI

Amazon EC2 supprime automatiquement un rapport 30 jours après sa création. Vous pouvez le supprimer manuellement avant cette date.

Console
Pour supprimer un rapport d’utilisation d’AMI

  1. Ouvrez la console Amazon EC2 à l’adresse https://console.aws.amazon.com/ec2/.

  2. Dans le panneau de navigation, sélectionnez AMI.

  3. Sélectionnez une AMI.

  4. Choisissez l’onglet Utilisation de mes AMI.

  5. Sélectionnez le bouton d’option situé à côté du rapport à supprimer, puis choisissez Supprimer.

AWS CLI
Pour supprimer un rapport d’utilisation d’AMI

Utilisez la commande delete-image-usage-report et spécifiez l’ID du rapport.

aws ec2 delete-image-usage-report --report-id amiur-0123456789abcdefg
PowerShell
Pour supprimer un rapport d’utilisation d’AMI

Utilisez l’applet de commande Remove-EC2ImageUsageReport et spécifiez l’ID du rapport.

Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg

Quotas de rapports

Les quotas suivants s’appliquent à la création de rapports d’utilisation d’AMI. Les quotas s’appliquent par Région AWS.

Description Quota
Rapports d’utilisation d’AMI en cours (pending) par Compte AWS 100
Rapports d’utilisation d’AMI en cours (pending) par AMI 1