

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Affichage de l’utilisation de votre AMI

Si vous partagez vos Amazon Machine Images (AMI) avec d'autres personnes, Comptes AWS que ce soit au sein d'organisations Comptes AWS, d'unités organisationnelles (UO) spécifiques ou publiquement, 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 :
+ Qui 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 à :
+ Identifiez Comptes AWS les types de ressources qui font référence à vos AMI afin de pouvoir désenregistrer ou désactiver les AMI 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.

**Topics**
+ [Comment fonctionnent les rapports d’utilisation des AMI](#how-ami-usage-reports-work)
+ [Création d’un rapport d’utilisation d’AMI](#create-ami-usage-reports)
+ [Affichage des rapports d’utilisation d’AMI](#view-ami-usage-reports)
+ [Suppression d’un rapport d’utilisation d’AMI](#delete-ami-usage-reports)
+ [Quotas de rapports](#ami-usage-report-quotas)

## Comment fonctionnent les rapports d’utilisation des AMI
<a name="how-ami-usage-reports-work"></a>

Lorsque vous créez un rapport d’utilisation d’AMI, vous spécifiez :
+ L’AMI faisant l’objet du rapport.
+ Les Comptes AWS éléments à 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 utilisateurs Comptes AWS de 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
<a name="create-ami-usage-reports"></a>

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 en consulter le contenu. 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/](https://console.aws.amazon.com/ec2/).

1. Dans le panneau de navigation, sélectionnez **AMI**.

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

1. 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.

   1. 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.

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

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

1. 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-image-usage-report.html) 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-reports.html) 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'[New-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2ImageUsageReport.html)applet de commande 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 [ Get-EC2ImageUsageReport ](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReport.html) commande 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
<a name="view-ami-usage-reports"></a>

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 ceux Comptes AWS qui utilisent l'AMI, et pour chaque compte, le décompte des 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/](https://console.aws.amazon.com/ec2/).

1. Dans le panneau de navigation, sélectionnez **AMI**.

1. Sélectionnez une AMI.

1. 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.

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

1. 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-reports.html) 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-report-entries.html) 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-report-entries.html) 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'[Get-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReport.html)applet 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 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'[Get-EC2ImageUsageReportEntry](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReportEntry.html)applet 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 d’AMI pour le rapport spécifié**  
Utilisez l'[Get-EC2ImageUsageReportEntry](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReportEntry.html)applet 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
```

------

## Suppression d’un rapport d’utilisation d’AMI
<a name="delete-ami-usage-reports"></a>

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/](https://console.aws.amazon.com/ec2/).

1. Dans le panneau de navigation, sélectionnez **AMI**.

1. Sélectionnez une AMI.

1. Choisissez l’onglet **Utilisation de mes AMI**.

1. 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-image-usage-report.html) 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'[Remove-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2ImageUsageReport.html)applet de commande et spécifiez l'ID du rapport.

```
Remove-EC2ImageUsageReport -ReportId {{amiur-0123456789abcdefg}}
```

------

## Quotas de rapports
<a name="ami-usage-report-quotas"></a>

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


| Description | Quota | 
| --- | --- | 
| In-progress (pending) Rapports d'utilisation de l'AMI par Compte AWS | 2 000 | 
| In-progress (pending) Rapports d'utilisation de l'AMI par AMI | 1 | 