Afficher l'utilisation de votre AMI

Si vous partagez vos images Amazon Machine (AMIs) avec d'autres personnes, Comptes AWS que ce soit avec des organisations spécifiques Comptes AWS, des unités organisationnelles (OUs) ou publiquement, vous pouvez voir comment elles AMIs sont utilisées en créant des rapports d'utilisation des AMI. Les rapports fournissent de la visibilité sur :

• Qui Comptes AWS utilisent vos AMIs EC2 instances internes ou vos modèles de lancement

• Combien d' EC2 instances ou de modèles de lancement font référence à chaque AMI

Les rapports d'utilisation des AMI vous aident à gérer votre activité AMIs de manière plus efficace en vous aidant à :

• Identifiez les types Comptes AWS de ressources qui vous référencent AMIs afin de pouvoir vous désinscrire ou désactiver en toute sécurité. AMIs

• Identifiez les articles non utilisés AMIs pour la désinscription afin de réduire les coûts de stockage.

• Identifiez ceux que vous utilisez le plus AMIs.

Comment fonctionnent les rapports d'utilisation de l'AMI

Lorsque vous créez un rapport d'utilisation de l'AMI, vous spécifiez :

• L'AMI dont il faut rendre compte.

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

• Les types de ressources à vérifier (EC2 instances, 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 :

• Liste des utilisateurs Comptes AWS de l'AMI.

• 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 de l'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 supprime EC2 automatiquement un rapport 30 jours après sa création. Vous pouvez télécharger des rapports depuis la EC2 console pour les conserver localement.

Création d'un rapport d'utilisation de l'AMI

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

Console

Pour créer un rapport d'utilisation de l'AMI

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

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

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

4. Sur la page Créer mon rapport d'utilisation de l'AMI, procédez comme suit :

   1. Pour les types de ressources, sélectionnez un ou plusieurs types de ressources sur lesquels créer un rapport.

   2. Pour Account (Compte) IDs, sélectionnez l'une des options suivantes :

      • Choisissez Spécifier les comptes, IDs puis choisissez Ajouter un identifiant de compte pour chaque compte sur lequel vous souhaitez créer un rapport.

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

   3. Choisissez Créer mon rapport d'utilisation de l'AMI.

5. Sur la page AMI, choisissez l'onglet Utilisation de mon AMI.

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

AWS CLI

Pour créer un rapport d'utilisation de l'AMI pour une liste de comptes

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

• --image-id— L'ID de l'AMI à signaler.

• --resource-types— Les types de ressources à vérifier. Dans l'exemple suivant, les types de ressources à vérifier sont les EC2 instances 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 --account-ids paramètre pour spécifier l'ID de chaque compte à signaler.

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 des AMI pour tous les comptes

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

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 l'état de création du rapport

Utilisez la describe-image-usage-reportscommande 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 State champ estpending. Pour pouvoir consulter les entrées du rapport, l'état doit êtreavailable.

{
    "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 de l'AMI pour une liste de comptes

Utilisez l'New-EC2ImageUsageReportapplet de commande avec les paramètres obligatoires suivants :

• -ImageId— L'ID de l'AMI à signaler.

• -ResourceType— Les types de ressources à vérifier. Dans l'exemple suivant, les types de ressources à vérifier sont les EC2 instances 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 -AccountId paramètre pour spécifier l'ID de chaque compte à signaler.

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 des AMI pour tous les comptes

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

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 l'état de création du rapport

Utilisez la Get-EC2ImageUsageReportcommande et spécifiez l'ID du rapport.

Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0

Voici un exemple de sortie. La valeur initiale du State champ estpending. Pour pouvoir consulter les entrées du rapport, l'état doit êtreavailable.

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

Afficher les rapports d'utilisation de l'AMI

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

Pour chaque rapport, vous pouvez voir ceux Comptes AWS qui utilisent l'AMI, et pour chaque compte, le nombre de ressources référençant l'AMI par type de ressource. Vous pouvez également voir à quel moment 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 de l'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 de l'AMI

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

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

3. Sélectionnez une AMI.

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

   La liste des rapports indique :

   • Tous les rapports générés au cours des 30 derniers jours pour l'AMI sélectionnée.

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

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 de l'AMI pour l'AMI spécifiée

Utilisez la describe-image-usage-reportscommande 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 scanné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 de l'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 de l'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 de l'AMI pour l'AMI spécifiée

Utilisez l'Get-EC2ImageUsageReportapplet de commande 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 scanné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 de l'AMI pour l'AMI spécifiée

Utilisez l'Get-EC2ImageUsageReportEntryapplet de commande 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 de l'AMI pour le rapport spécifié

Utilisez l'Get-EC2ImageUsageReportEntryapplet de commande 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

Supprimer un rapport d'utilisation de l'AMI

Amazon supprime EC2 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 de l'AMI

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

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

3. Sélectionnez une AMI.

4. Choisissez l'onglet Utilisation de mon AMI.

5. Cliquez sur le bouton d'option situé à côté du rapport à supprimer, puis sélectionnez Supprimer.

AWS CLI

Pour supprimer un rapport d'utilisation de l'AMI

Utilisez la delete-image-usage-reportcommande et spécifiez l'ID du rapport.

aws ec2 delete-image-usage-report --report-id amiur-0123456789abcdefg

PowerShell

Pour supprimer un rapport d'utilisation de l'AMI

Utilisez l'Remove-EC2ImageUsageReportapplet de commande et spécifiez l'ID du rapport.

Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg