

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.

# Utilisation d’Amazon S3 Storage Lens à l’aide de la console et de l’API
<a name="S3LensExamples"></a>

Amazon S3 Storage Lens est une fonction d'analyse du stockage dans le cloud que vous pouvez utiliser pour obtenir une visibilité à l'échelle de l'organisation sur l'utilisation et l'activité du stockage d'objets. Vous pouvez utiliser les métriques S3 Storage Lens pour générer des informations récapitulatives, telles que la quantité de stockage dont vous disposez dans l’ensemble de votre organisation ou les compartiments et préfixes qui connaissent la croissance la plus rapide. Vous pouvez également utiliser les métriques S3 Storage Lens pour identifier les opportunités d'optimisation des coûts, mettre en œuvre les bonnes pratiques de protection et de sécurisation des données et améliorer les performances des charges de travail d'application. Par exemple, vous pouvez identifier les compartiments qui sont dépourvus de règles de cycle de vie S3 pour faire expirer les chargements partitionnés non terminés datant de plus de 7 jours. Vous pouvez également identifier les compartiments qui ne respectent pas les bonnes pratiques de protection des données, telles que l'utilisation de la réplication S3 ou de la gestion des versions S3. S3 Storage Lens analyse également les métriques de stockage pour fournir des recommandations contextuelles afin d'aider à réduire les coûts de stockage et à appliquer les bonnes pratiques de protection des données. 

S3 Storage Lens regroupe vos métriques et affiche les informations dans la section **Account snapshot** (Instantané du compte) sur la page **Buckets** (Compartiments) de la console Amazon S3. S3 Storage Lens fournit également un tableau de bord interactif que vous pouvez utiliser pour visualiser les informations et les tendances, signaler les valeurs aberrantes et recevoir des recommandations pour optimiser les coûts de stockage et appliquer les meilleures pratiques en matière de protection des données. Votre tableau de bord comporte des options d'exploration permettant de générer et de visualiser des informations au niveau de l'organisation, du compte, de la classe de stockage Région AWS, du bucket, du préfixe ou du groupe Storage Lens. Vous pouvez également envoyer un rapport de mesures quotidiennes au format CSV ou Parquet au format CSV vers un compartiment S3 à usage général ou exporter les métriques directement vers un compartiment de table S3 AWS géré. 

**Note**  
Storage Lens agrège uniquement les métriques pour les [buckets S3 à usage général](UsingBucket.md).

La section suivante contient des exemples de création, de mise à jour et d’affichage des configurations S3 Storage Lens et d’exécution d’opérations liées à la fonction. Si vous utilisez S3 Storage Lens avec AWS Organizations, ces exemples couvrent également ces cas d'utilisation. Dans les exemples, remplacez toutes les valeurs d'espace réservé.

**Topics**
+ [Création d’un tableau de bord Amazon S3 Storage Lens](storage_lens_creating_dashboard.md)
+ [Mise à jour d’un tableau de bord Amazon S3 Storage Lens](storage_lens_editing.md)
+ [Désactivation d’un tableau de bord Amazon S3 Storage Lens](storage_lens_disabling.md)
+ [Suppression d’un tableau de bord Amazon S3 Storage Lens](storage_lens_deleting.md)
+ [Affichage des tableaux de bord Amazon S3 Storage Lens](storage_lens_list_dashboard.md)
+ [Affichage des détails d’un tableau de bord Amazon S3 Storage Lens](storage_lens_viewing.md)
+ [Gestion des balises de AWS ressources avec S3 Storage Lens](storage-lens-groups-manage-tags-dashboard.md)
+ [Fichiers d’aide pour l’utilisation d’Amazon S3 Storage Lens](S3LensHelperFilesCLI.md)

# Création d’un tableau de bord Amazon S3 Storage Lens
<a name="storage_lens_creating_dashboard"></a>

Vous pouvez créer des tableaux de bord personnalisés S3 Storage Lens supplémentaires qui peuvent être adaptés à votre organisation AWS Organizations ou à des compartiments spécifiques Régions AWS au sein d'un compte. 

**Note**  
L’affichage ou la visualisation des mises à jour apportées à la configuration de votre tableau de bord peut prendre jusqu’à 48 heures.

## Utilisation de la console S3
<a name="storage_lens_console_creating"></a>

Procédure pour créer un tableau de bord Amazon S3 Storage Lens sur la console Amazon S3.

**Étape 1 : Configuration des paramètres généraux**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans la barre de navigation en haut de la page, choisissez le nom du fichier actuellement affiché Région AWS. Choisissez ensuite la région à laquelle vous souhaitez passer. 

1. Dans le volet de navigation de gauche, sous **S3 Storage Lens**, choisissez **Tableaux de bord**.

1. Choisissez **Create dashboard (Créer un tableau de bord)**.

1. Sur la page **Tableau de bord**, dans la section **General (Général)**, procédez comme suit :

   1. Sélectionnez la **région d’origine** de votre tableau de bord. La région d'origine est l' Région AWS endroit où sont stockées la configuration et les mesures de ce tableau de bord Storage Lens.

   1. Saisissez un nom de tableau de bord. 

      Les noms de tableau de bord doivent contenir moins de 65 caractères et ne doivent pas contenir de caractères spéciaux ou d’espaces. 
**Note**  
Vous ne pouvez pas modifier ce nom de tableau de bord une fois le tableau de bord créé.

   1. Choisissez **Activé** pour afficher les statistiques quotidiennes mises à jour dans votre tableau de bord.

   1. (Facultatif) Vous pouvez choisir d'ajouter des **tags** à votre tableau de bord. Vous pouvez utiliser des balises pour gérer les autorisations de votre tableau de bord et suivre les coûts relatifs à S3 Storage Lens. Pour plus d'informations, consultez les sections [Contrôle de l'accès aux AWS ressources à l'aide de balises](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) dans le *guide de l'utilisateur IAM* et [Utilisation de balises AWS générées](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html) dans le guide de l'*AWS Billing utilisateur*.
**Note**  
Vous pouvez ajouter jusqu’à 50 balises à votre configuration de tableau de bord.

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

**Étape 2 : définir le périmètre du tableau de bord**

1. Dans la section **Champ d'application du tableau de bord**, choisissez les régions et les compartiments que S3 Storage Lens doit inclure ou exclure dans le tableau de bord.

1. Sélectionnez les compartiments dans les Régions sélectionnées que vous souhaitez que S3 Storage Lens inclue ou exclue. Vous pouvez inclure ou exclure des compartiments, mais pas les deux. Cette option n'est pas disponible lorsque vous créez des tableaux de bord au niveau de l'organisation.
**Note**  
Vous pouvez inclure ou exclure des Régions et des compartiments. Cette option est limitée aux Régions uniquement lors de la création de tableaux de bord au niveau de l’organisation sur les comptes membres de votre organisation. 
Vous pouvez choisir jusqu’à 50 compartiments à inclure ou exclure.

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

**Étape 3 : Choisissez le niveau de votre Storage Lens**

1. Dans la section **Niveau Storage Lens**, choisissez le niveau de fonctionnalités que vous souhaitez agréger pour ce tableau de bord.

   1. Pour inclure des métriques gratuites agrégées au niveau du bucket et disponibles pour les requêtes pendant 14 jours, choisissez le **niveau gratuit**.

   1. Pour activer les métriques avancées, choisissez le **niveau avancé**. Ces options incluent l'agrégation de groupes de préfixes ou de groupes Storage Lens, la CloudWatch publication sur Amazon, le rapport sur les préfixes étendus et les recommandations contextuelles. Les données sont disponibles pour les requêtes pendant 15 mois. Les métriques et recommandations avancées entraînent un coût supplémentaire. Pour plus d’informations, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/).

      Pour plus d’informations sur les métriques gratuites et avancées, consultez [Sélection des métriques](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection).

1. Sous **Catégories de mesures avancées**, sélectionnez la catégorie de mesures que vous souhaitez activer :
   + **Métriques d’activité**
   + **Detailed status code metrics** (Métriques détaillées sur le code de statut)
   + **Métriques d'optimisation des coûts**
   + **Mesures de protection des données**
   + **Indicateurs de performance**

   Pour prévisualiser les mesures incluses dans chaque catégorie, utilisez le bouton flèche déroulante situé sous la liste des cases à cocher des catégories de mesures. Pour plus d’informations sur les catégories de métriques, consultez [Catégories de métriques](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types). Pour obtenir une liste complète des métriques, consultez [Glossaire des métriques Amazon S3 Storage Lens](storage_lens_metrics_glossary.md).

1. Choisissez ou spécifiez un **séparateur de préfixe** pour distinguer les niveaux au sein de chaque préfixe. Cette valeur est utilisée pour identifier chaque niveau de préfixe. La valeur par défaut dans Amazon S3 est le caractère « `/` », mais votre structure de stockage peut utiliser d'autres caractères séparateurs.

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

**Étape 4 : (Facultatif) Choisissez votre agrégation de métriques**

1. Sous **Agrégation de mesures supplémentaires**, choisissez les mesures que vous souhaitez agréger :
   + Prefix aggregation (Agrégation de préfixes)
   + Regroupement des groupes Storage Lens

1. Si vous avez activé l'**agrégation de préfixes**, spécifiez le **seuil de préfixe** minimum pour votre tableau de bord et la profondeur du **préfixe**. Choisissez ensuite **Next** pour enregistrer et continuer.
**Note**  
Le paramètre de **profondeur du préfixe** détermine le nombre de niveaux hiérarchiques profonds. S3 Storage Lens analysera les préfixes de vos objets, avec une limite maximale de 10 niveaux. Le **seuil de préfixe** indique le pourcentage minimum du stockage total qu'un préfixe doit représenter avant d'être inclus dans les métriques de Storage Lens.

1. Si vous avez activé l'**agrégation de groupes Storage Lens**, choisissez l'une des options suivantes :
   + **Inclure les groupes de lentilles de stockage**
   + **Exclure les groupes de lentilles de stockage**

1. Lorsque vous incluez des groupes de lentilles de stockage dans votre agrégation, vous pouvez soit **inclure tous les groupes de lentilles de stockage dans votre région d'origine**, soit spécifier les groupes de lentilles de stockage à inclure.

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

**Étape 5 : (Facultatif) Choisissez les paramètres d'exportation et de publication de vos statistiques**

1. Sous **Publication des métriques**, choisissez **CloudWatchPublier** si vous souhaitez accéder à vos métriques Storage Lens dans votre CloudWatch tableau de bord.
**Note**  
Les métriques au niveau du préfixe ne sont pas disponibles dans. CloudWatch

1. Sous **Exportation des métriques**, choisissez les données du tableau de bord Storage Lens que vous souhaitez exporter quotidiennement :
   + **Rapport sur les métriques par défaut**
   + **Rapport détaillé sur les mesures relatives aux préfixes**

1. (Facultatif) Si vous avez choisi **Rapport de mesures par défaut**, dans les paramètres du **rapport de mesures par** défaut, choisissez le type de compartiment. Vous pouvez exporter le rapport vers un compartiment Amazon S3 à usage général ou vers un compartiment de table S3 AWS géré. En fonction du type de compartiment sélectionné, mettez à jour les options des paramètres de **destination des compartiments à usage général ou des paramètres** de **destination des compartiments de table**.
**Note**  
Le **rapport de mesures par défaut** inclut uniquement les préfixes compris dans les limites du seuil et de la profondeur définis dans les paramètres d'agrégation des préfixes.  
Si vous choisissez de spécifier une clé de chiffrement, vous devez choisir une AWS KMS clé (SSE-KMS) ou une clé gérée Amazon S3 (SSE-S3). Si votre politique de compartiment de destination exige le chiffrement, vous devez fournir une clé de chiffrement pour l'exportation de vos métriques. Sans la clé de chiffrement, l'exportation vers S3 échoue. Pour de plus amples informations, veuillez consulter [Utilisation d'un AWS KMS key pour chiffrer vos exportations de métriques](storage_lens_encrypt_permissions.md).

1. (Facultatif) Si vous avez choisi le rapport sur **les mesures sur les préfixes étendus, dans les paramètres du rapport** **sur les mesures sur les préfixes** étendus, choisissez le type de compartiment. Vous pouvez exporter le rapport vers un compartiment Amazon S3 à usage général ou vers un compartiment de table S3 en lecture seule. En fonction du type de compartiment sélectionné, mettez à jour les paramètres de **destination du compartiment à usage général ou les paramètres** de **destination du compartiment Table**.
**Note**  
Le **rapport sur les mesures relatives aux préfixes étendus** inclut tous les préfixes jusqu'à une profondeur de 50 dans tous les compartiments sélectionnés spécifiés dans le champ d'application de votre tableau de bord.  
Si vous choisissez de spécifier une clé de chiffrement, vous devez choisir une AWS KMS clé (SSE-KMS) ou une clé gérée Amazon S3 (SSE-S3). Si votre politique de compartiment de destination exige le chiffrement, vous devez fournir une clé de chiffrement pour l'exportation de vos métriques. Sans la clé de chiffrement, l'exportation vers S3 échoue. Pour de plus amples informations, veuillez consulter [Utilisation d'un AWS KMS key pour chiffrer vos exportations de métriques](storage_lens_encrypt_permissions.md).

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

1. Passez en revue tout ce qui se trouve sur la page **Réviser et créer**. S'il n'y a aucune autre modification, choisissez **Suivant** pour enregistrer vos modifications et créer votre tableau de bord.

**Étape 6 : Vérifiez la configuration de votre tableau de bord et créez votre tableau de bord**

1. Dans la section **Général**, passez en revue vos paramètres. Choisissez **Modifier** pour apporter des modifications.

1. Dans la section **Champ d'application du tableau** de bord, passez en revue vos paramètres. Choisissez **Modifier** pour apporter des modifications.

1. Dans la section **Storage Lens niveau**, passez en revue vos paramètres. Choisissez **Modifier** pour apporter des modifications.

1. Dans la section **Agrégation des mesures**, passez en revue vos paramètres. Choisissez **Modifier** pour apporter des modifications.

1. Dans la section **Exportation des métriques**, passez en revue vos paramètres. Choisissez **Modifier** pour apporter des modifications.

1. Après avoir examiné et confirmé tous les paramètres de configuration de votre tableau de bord, choisissez **Soumettre** pour créer votre tableau de bord.

Après avoir créé avec succès votre nouveau tableau de bord Storage Lens, vous pouvez consulter votre nouveau tableau de bord répertorié sous la page du tableau de **bord** Storage Lens.

## À l'aide du AWS CLI
<a name="S3PutStorageLensConfigurationTagsCLI"></a>

**Example**  
L’exemple de commande suivant crée une configuration Amazon S3 Storage Lens avec des balises. Pour utiliser ces exemples, remplacez les `user input placeholders` par vos propres informations.  

```
aws s3control put-storage-lens-configuration --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json --tags=file://./tags.json
```

**Example**  
L’exemple de commande suivant crée une configuration Amazon S3 Storage Lens sans balises. Pour utiliser ces exemples, remplacez les `user input placeholders` par vos propres informations.  

```
aws s3control put-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json
```

## Utilisation du AWS SDK pour Java
<a name="S3CreateandUpdateStorageLensConfigurationJava"></a>

**Example – Créer et mettre à jour une configuration Amazon S3 Storage Lens**  
L’exemple suivant crée et met à jour une configuration Amazon S3 Storage Lens dans le kit SDK pour Java :  

```
package aws.example.s3control;

import software.amazon.awssdk.awscore.exception.AwsServiceException;
import software.amazon.awssdk.core.exception.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.AccountLevel;
import software.amazon.awssdk.services.s3control.model.ActivityMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedCostOptimizationMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedDataProtectionMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedPerformanceMetrics;
import software.amazon.awssdk.services.s3control.model.BucketLevel;
import software.amazon.awssdk.services.s3control.model.CloudWatchMetrics;
import software.amazon.awssdk.services.s3control.model.DetailedStatusCodesMetrics;
import software.amazon.awssdk.services.s3control.model.Format;
import software.amazon.awssdk.services.s3control.model.Include;
import software.amazon.awssdk.services.s3control.model.OutputSchemaVersion;
import software.amazon.awssdk.services.s3control.model.PrefixLevel;
import software.amazon.awssdk.services.s3control.model.PrefixLevelStorageMetrics;
import software.amazon.awssdk.services.s3control.model.PutStorageLensConfigurationRequest;
import software.amazon.awssdk.services.s3control.model.S3BucketDestination;
import software.amazon.awssdk.services.s3control.model.SSES3;
import software.amazon.awssdk.services.s3control.model.SelectionCriteria;
import software.amazon.awssdk.services.s3control.model.StorageLensAwsOrg;
import software.amazon.awssdk.services.s3control.model.StorageLensConfiguration;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExportEncryption;
import software.amazon.awssdk.services.s3control.model.StorageLensExpandedPrefixesDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensTableDestination;
import software.amazon.awssdk.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

public class CreateAndUpdateDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        String exportAccountId = "Destination Account ID";
        String exportBucketArn = "arn:aws:s3:::destBucketName"; // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration.
        String awsOrgARN = "arn:aws:organizations::123456789012:organization/o-abcdefgh";
        Format exportFormat = Format.CSV;

        try {
            SelectionCriteria selectionCriteria = SelectionCriteria.builder()
                    .delimiter("/")
                    .maxDepth(5)
                    .minStorageBytesPercentage(10.0)
                    .build();

            PrefixLevelStorageMetrics prefixStorageMetrics = PrefixLevelStorageMetrics.builder()
                    .isEnabled(true)
                    .selectionCriteria(selectionCriteria)
                    .build();

            BucketLevel bucketLevel = BucketLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
                    .prefixLevel(PrefixLevel.builder().storageMetrics(prefixStorageMetrics).build())
                    .build();

            AccountLevel accountLevel = AccountLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
                    .bucketLevel(bucketLevel)
                    .build();

            Include include = Include.builder()
                    .buckets(Arrays.asList("arn:aws:s3:::bucketName"))
                    .regions(Arrays.asList("us-west-2"))
                    .build();

            StorageLensDataExportEncryption exportEncryption = StorageLensDataExportEncryption.builder()
                    .sses3(SSES3.builder().build())
                    .build();

            S3BucketDestination s3BucketDestination = S3BucketDestination.builder()
                    .accountId(exportAccountId)
                    .arn(exportBucketArn)
                    .encryption(exportEncryption)
                    .format(exportFormat)
                    .outputSchemaVersion(OutputSchemaVersion.V_1)
                    .prefix("Prefix")
                    .build();

            StorageLensTableDestination s3TablesDestination = StorageLensTableDestination.builder()
                    .encryption(exportEncryption)
                    .isEnabled(true)
                    .build();

            CloudWatchMetrics cloudWatchMetrics = CloudWatchMetrics.builder()
                    .isEnabled(true)
                    .build();

            StorageLensDataExport dataExport = StorageLensDataExport.builder()
                    .cloudWatchMetrics(cloudWatchMetrics)
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensAwsOrg awsOrg = StorageLensAwsOrg.builder()
                    .arn(awsOrgARN)
                    .build();

            StorageLensExpandedPrefixesDataExport expandedPrefixesDataExport = StorageLensExpandedPrefixesDataExport.builder()
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensConfiguration configuration = StorageLensConfiguration.builder()
                    .id(configurationId)
                    .accountLevel(accountLevel)
                    .include(include)
                    .dataExport(dataExport)
                    .awsOrg(awsOrg)
                    .expandedPrefixesDataExport(expandedPrefixesDataExport)
                    .prefixDelimiter("/")
                    .isEnabled(true)
                    .build();

            List<StorageLensTag> tags = Arrays.asList(
                    StorageLensTag.builder().key("key-1").value("value-1").build(),
                    StorageLensTag.builder().key("key-2").value("value-2").build()
            );

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();

            s3ControlClient.putStorageLensConfiguration(PutStorageLensConfigurationRequest.builder()
                    .accountId(sourceAccountId)
                    .configId(configurationId)
                    .storageLensConfiguration(configuration)
                    .tags(tags)
                    .build()
            );

        } catch (AwsServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

Pour accéder aux groupes S3 Storage Lens ou aux préfixes étendus, vous devez mettre à niveau votre tableau de bord pour utiliser le niveau avancé. Des frais supplémentaires s’appliquent. Pour plus d'informations sur les niveaux gratuit et avancé, consultez[Sélection des métriques](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection). Pour plus d’informations sur les groupes S3 Storage Lens, consultez [Utilisation des groupes S3 Storage Lens pour filtrer et agréger des métriques](storage-lens-groups-overview.md). 

# Mise à jour d’un tableau de bord Amazon S3 Storage Lens
<a name="storage_lens_editing"></a>

 Le tableau de bord par défaut d’Amazon S3 Storage Lens est `default-account-dashboard`. Ce tableau de bord est préconfiguré par Amazon S3 pour vous aider à visualiser le résumé des informations et des tendances des métriques gratuites et avancées agrégées de votre compte dans la console. Vous ne pouvez pas modifier la portée de la configuration du tableau de bord par défaut, mais vous pouvez mettre à niveau la sélection de métriques gratuites vers les métriques et recommandations avancées payantes, configurer l’exportation facultative des métriques ou même désactiver le tableau de bord par défaut. Ce tableau de bord par défaut ne peut pas être supprimé et peut uniquement être désactivé. Pour de plus amples informations, veuillez consulter [Utilisation de la console S3](storage_lens_console_deleting.md).

## Utilisation de la console S3
<a name="storage_lens_console_editing"></a>

Suivez les étapes suivantes pour mettre à jour un tableau de bord Amazon S3 Storage Lens sur la console Amazon S3.

**Étape 1 : mettez à jour votre tableau de bord et configurez vos paramètres généraux**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le volet de navigation de gauche, choisissez **Storage Lens, Tableaux de bord**.

1. Choisissez le tableau de bord que vous souhaitez modifier.

1. Choisissez **Afficher la configuration du tableau de bord**.

1. Choisissez **Modifier**. Vous pouvez désormais revoir la configuration du tableau de bord, étape par étape. Pour modifier l'une des étapes, vous pouvez cliquer directement sur l'étape en utilisant le menu de navigation de gauche. Pour obtenir des instructions sur la façon de mettre à jour ces étapes,
**Note**  
Vous ne pouvez pas modifier les éléments suivants :  
Le nom du tableau de bord
La Région d’accueil

1. Sur la page **Tableau de bord**, dans la section **Général**, vous pouvez apporter des modifications aux éléments suivants :
   + Choisissez **Activé** **ou Désactivé** pour savoir si vous recevez des statistiques quotidiennes dans votre tableau de bord.
   + (Facultatif) Vous pouvez choisir d'ajouter des **tags** à votre tableau de bord. Vous pouvez utiliser des balises pour gérer les autorisations de votre tableau de bord et suivre les coûts relatifs à S3 Storage Lens. Pour plus d'informations, consultez les sections [Contrôle de l'accès aux AWS ressources à l'aide de balises](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) dans le *guide de l'utilisateur IAM* et [Utilisation de balises AWS générées](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html) dans le guide de l'*AWS Billing utilisateur*.
**Note**  
Vous pouvez ajouter jusqu’à 50 balises à votre configuration de tableau de bord.

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

**Étape 2 : mettre à jour le périmètre du tableau de bord**

1. Dans la section **Champ d'application du tableau de bord**, mettez à jour les régions et les compartiments que vous souhaitez que S3 Storage Lens inclue ou exclue dans le tableau de bord.
**Note**  
Vous pouvez inclure ou exclure des Régions et des compartiments. Cette option est limitée aux Régions uniquement lors de la création de tableaux de bord au niveau de l’organisation sur les comptes membres de votre organisation. 
Vous pouvez choisir jusqu’à 50 compartiments à inclure ou exclure.

1. Sélectionnez les compartiments dans les Régions sélectionnées que vous souhaitez que S3 Storage Lens inclue ou exclue. Vous pouvez inclure ou exclure des compartiments, mais pas les deux. Cette option n'est pas disponible lorsque vous créez des tableaux de bord au niveau de l'organisation.
**Note**  
Vous pouvez inclure ou exclure des Régions et des compartiments. Cette option est limitée aux Régions uniquement lors de la création de tableaux de bord au niveau de l’organisation sur les comptes membres de votre organisation.
Vous pouvez choisir jusqu’à 50 compartiments à inclure ou exclure.

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

**Étape 3 : mise à jour du niveau de votre Storage Lens Configuration de la sélection des métriques**

1. Dans la section de **sélection des métriques** du **niveau Storage Lens**, mettez à jour le niveau de mesures que vous souhaitez agréger pour ce tableau de bord.
**Note**  
Si vous passez du **niveau gratuit au niveau** **avancé**, vous devez mettre à jour vos paramètres d'**agrégation des métriques**. Pour mettre à jour vos **paramètres d'agrégation de métriques**, voir **Étape 4 : Mettre à jour votre agrégation de métriques**.
Si vous mettez à jour votre niveau Storage Lens du **niveau avancé au niveau** **gratuit**, vous n'aurez pas besoin de mettre à jour les paramètres d'**agrégation des métriques**. La fonctionnalité d'**agrégation de mesures** s'applique uniquement aux catégories de mesures de **niveau avancé**.

1. Pour inclure des métriques gratuites agrégées au niveau du bucket et disponibles pour les requêtes pendant 14 jours, choisissez le **niveau gratuit**.

1. Pour activer les métriques avancées, choisissez le **niveau avancé**. Ces options incluent l'agrégation de préfixes, la CloudWatch publication sur Amazon et les recommandations contextuelles. Les données sont disponibles pour les requêtes pendant 15 mois. Les métriques et recommandations avancées entraînent un coût supplémentaire. Pour plus d’informations, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/).

   Pour plus d’informations sur les métriques gratuites et avancées, consultez [Sélection des métriques](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection).

1. Sous **Catégories de mesures avancées**, choisissez la catégorie de mesures que vous souhaitez activer :
   + **Métriques d’activité**
   + **Detailed status code metrics** (Métriques détaillées sur le code de statut)
   + **Métriques d'optimisation des coûts**
   + **Mesures de protection des données**
   + **Indicateurs de performance**

   Pour prévisualiser les mesures incluses dans chaque catégorie, utilisez le bouton flèche déroulante situé sous la liste des cases à cocher des catégories de mesures. Pour plus d’informations sur les catégories de métriques, consultez [Catégories de métriques](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types). Pour obtenir une liste complète des métriques, consultez [Glossaire des métriques Amazon S3 Storage Lens](storage_lens_metrics_glossary.md).

1. Choisissez ou spécifiez un **séparateur de préfixe** pour distinguer les niveaux au sein de chaque préfixe. Cette valeur est utilisée pour identifier chaque niveau de préfixe. La valeur par défaut dans Amazon S3 est le caractère « `/` », mais votre structure de stockage peut utiliser d'autres caractères séparateurs.

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

**Étape 4 : (Facultatif) Mettez à jour votre agrégation de statistiques**

1. Sous **Agrégation de mesures supplémentaires**, mettez à jour les mesures que vous souhaitez agréger en choisissant l'une des options suivantes :
   + Prefix aggregation (Agrégation de préfixes)
   + Regroupement des groupes Storage Lens

1. Si vous avez activé l'**agrégation de préfixes**, spécifiez le **seuil de préfixe** minimum pour votre tableau de bord et la profondeur du **préfixe**. Choisissez ensuite **Next** pour enregistrer et continuer.

1. Si vous avez activé l'**agrégation de groupes Storage Lens**, choisissez l'une des options suivantes :
   + **Inclure les groupes de lentilles de stockage**
   + **Exclure les groupes de lentilles de stockage**

1. Lorsque vous incluez des groupes de lentilles de stockage dans votre agrégation, vous pouvez soit **inclure tous les groupes de lentilles de stockage dans votre région d'origine**, soit spécifier les groupes de lentilles de stockage à inclure.

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

**Étape 5 : (Facultatif) Mettez à jour les paramètres d'exportation et de publication de vos statistiques**

1. Sous **Publication des métriques**, choisissez **CloudWatchPublier** si vous souhaitez accéder à vos métriques Storage Lens dans votre CloudWatch tableau de bord.
**Note**  
Les métriques au niveau du préfixe ne sont pas disponibles dans. CloudWatch

1. Sous **Exportation des métriques**, choisissez les données du tableau de bord Storage Lens que vous souhaitez exporter quotidiennement :
   + **Rapport sur les métriques par défaut**
   + **Rapport détaillé sur les mesures relatives aux préfixes**

1. (Facultatif) Si vous avez choisi **Rapport de mesures par défaut**, dans les paramètres du **rapport de mesures par** défaut, choisissez le type de compartiment. Vous pouvez exporter le rapport vers un compartiment S3 à usage général ou vers un compartiment de table S3 en lecture seule. En fonction du type de compartiment sélectionné, mettez à jour les options des paramètres de **destination des compartiments à usage général ou des paramètres** de **destination des compartiments de table**.
**Note**  
Le **rapport de mesures par défaut** inclut uniquement les préfixes compris dans les limites du seuil et de la profondeur définis dans les paramètres d'agrégation des préfixes. Si votre agrégation de préfixes n'est pas déjà configurée, le seuil inclut jusqu'aux 100 plus grands préfixes par taille.
Si vous choisissez de spécifier une clé de chiffrement, vous devez choisir une AWS KMS clé (SSE-KMS) ou une clé gérée Amazon S3 (SSE-S3). Si votre politique de compartiment de destination exige le chiffrement, vous devez fournir une clé de chiffrement pour l'exportation de vos métriques. Sans la clé de chiffrement, l'exportation vers S3 échoue. Pour de plus amples informations, veuillez consulter [Utilisation d'un AWS KMS key pour chiffrer vos exportations de métriques](storage_lens_encrypt_permissions.md).

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

1. (Facultatif) Si vous avez choisi le rapport sur **les mesures sur les préfixes étendus, dans les paramètres du rapport** **sur les mesures sur les préfixes** étendus, choisissez le type de compartiment. Vous pouvez exporter le rapport vers un compartiment S3 à usage général ou vers un compartiment de table S3 en lecture seule. En fonction du type de compartiment sélectionné, mettez à jour les paramètres de **destination du compartiment à usage général ou les paramètres** de **destination du compartiment Table**.
**Note**  
Le **rapport sur les mesures relatives aux préfixes étendus** inclut des préfixes dans tous les compartiments spécifiés dans le champ d'application de votre tableau de bord.
Si vous choisissez de spécifier une clé de chiffrement, vous devez choisir une AWS KMS clé (SSE-KMS) ou une clé gérée Amazon S3 (SSE-S3). Si votre politique de compartiment de destination exige le chiffrement, vous devez fournir une clé de chiffrement pour l'exportation de vos métriques. Sans la clé de chiffrement, l'exportation vers S3 échoue. Pour de plus amples informations, veuillez consulter [Utilisation d'un AWS KMS key pour chiffrer vos exportations de métriques](storage_lens_encrypt_permissions.md).

1. Choisissez **Suivant** pour enregistrer vos modifications et continuer.

**Étape 6 : Vérifiez et mettez à jour la configuration de votre tableau de bord**

1. Dans la section **Général**, passez en revue vos paramètres. Choisissez **Modifier** pour apporter des modifications.

1. Dans la section **Champ d'application du tableau** de bord, passez en revue vos paramètres. Choisissez **Modifier** pour apporter des modifications.

1. Dans la section **Storage Lens niveau**, passez en revue vos paramètres. Choisissez **Modifier** pour apporter des modifications.

1. Dans la section **Agrégation des mesures**, passez en revue vos paramètres. Choisissez **Modifier** pour apporter des modifications.

1. Dans la section **Exportation des métriques**, passez en revue vos paramètres. Choisissez **Modifier** pour apporter des modifications.

1. Après avoir examiné et confirmé tous les paramètres de configuration de votre tableau de bord, choisissez **Soumettre** pour mettre à jour votre tableau de bord.

Une fois que vous avez correctement mis à jour votre nouveau tableau de bord Storage Lens, vous pouvez consulter la configuration mise à jour de votre tableau de bord sur la page du tableau de **bord** Storage Lens.

## À l'aide du AWS CLI
<a name="S3PutStorageLensConfigurationTagsCLI"></a>

**Example**  
L’exemple de commande suivant met à jour la configuration d’un tableau de bord Amazon S3 Storage Lens. Pour utiliser ces exemples, remplacez les `user input placeholders` par vos propres informations.  

```
aws s3control put-storage-lens-configuration --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json --tags=file://./tags.json
```

## Utilisation du AWS SDK pour Java
<a name="S3UpdateStorageLensConfigurationAdvancedJava"></a>

**Example – Mettre à jour la configuration par défaut Amazon S3 Storage Lens avec les métriques et recommandations avancées**  
Les exemples suivants montrent comment mettre à jour la configuration S3 Storage Lens par défaut avec les métriques et recommandations avancées dans le kit SDK pour Java :  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.ActivityMetrics;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.Format;
import com.amazonaws.services.s3control.model.Include;
import com.amazonaws.services.s3control.model.OutputSchemaVersion;
import com.amazonaws.services.s3control.model.PrefixLevel;
import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.S3BucketDestination;
import com.amazonaws.services.s3control.model.SSES3;
import com.amazonaws.services.s3control.model.SelectionCriteria;
import com.amazonaws.services.s3control.model.StorageLensAwsOrg;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensDataExport;
import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class UpdateDefaultConfigWithPaidFeatures {

    public static void main(String[] args) {
        String configurationId = "default-account-dashboard"; // This configuration ID cannot be modified.
        String sourceAccountId = "111122223333";

        try {
            SelectionCriteria selectionCriteria = new SelectionCriteria()
                    .withDelimiter("/")
                    .withMaxDepth(5)
                    .withMinStorageBytesPercentage(10.0);
            PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics()
                    .withIsEnabled(true)
                    .withSelectionCriteria(selectionCriteria);
            BucketLevel bucketLevel = new BucketLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
                    .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics));
            AccountLevel accountLevel = new AccountLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
                    .withBucketLevel(bucketLevel);

            StorageLensConfiguration configuration = new StorageLensConfiguration()
                    .withId(configurationId)
                    .withAccountLevel(accountLevel)
                    .withIsEnabled(true);

            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withStorageLensConfiguration(configuration)
            );

        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

Pour accéder aux groupes S3 Storage Lens ou aux préfixes étendus, vous devez mettre à niveau votre tableau de bord pour utiliser le niveau avancé. Des frais supplémentaires s’appliquent. Pour plus d'informations sur les niveaux gratuit et avancé, consultez[Sélection des métriques](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection). Pour plus d’informations sur les groupes S3 Storage Lens, consultez [Utilisation des groupes S3 Storage Lens pour filtrer et agréger des métriques](storage-lens-groups-overview.md). 

# Désactivation d’un tableau de bord Amazon S3 Storage Lens
<a name="storage_lens_disabling"></a>

Vous pouvez désactiver un tableau de bord Amazon S3 Storage Lens à partir de la console Amazon S3. Lorsqu’un tableau de bord est désactivé, il ne peut plus générer de métriques. Un tableau de bord désactivé conserve toujours ses informations de configuration. Ainsi, vous pouvez facilement le reprendre lorsque vous le réactivez. Un tableau de bord désactivé retient ses données historiques jusqu’à ce qu’il ne soit plus disponible pour les requêtes.

# Utilisation de la console S3
<a name="storage_lens_console_disabling"></a>

Suivez la procédure ci-dessous pour créer un tableau de bord Amazon S3 Storage Lens dans la console Amazon S3.

**Pour désactiver un tableau de bord Amazon S3 Storage Lens**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le panneau de navigation de gauche, choisissez **Storage Lens**, **Dashboards** (Tableaux de bord).

1. Dans la liste **Dashboards (Tableaux)**, sélectionnez le tableau de bord que vous souhaitez désactiver, puis sélectionnez **Disable (Désactiver)** en haut de la liste.

1. Sur la page de confirmation, confirmez que vous souhaitez désactiver le tableau de bord en saisissant son nom dans le champ de texte, puis sélectionnez **Confirmer**.

# Suppression d’un tableau de bord Amazon S3 Storage Lens
<a name="storage_lens_deleting"></a>

Vous ne pouvez pas supprimer le tableau de bord par défaut. Cependant, vous pouvez la ou le désactiver. Avant de supprimer un tableau de bord que vous avez créé, tenez compte des points suivants :
+ Au lieu de supprimer un tableau de bord, vous pouvez le *désactiver* afin qu’il puisse être réactivé à l’avenir. Pour de plus amples informations, veuillez consulter [Utilisation de la console S3](storage_lens_console_disabling.md).
+ Lorsque le tableau de bord est supprimé, tous les paramètres de configuration qui lui sont associés sont également supprimés.
+ En outre, toutes les données historiques des métriques ne sont plus disponibles. Ces données historiques sont conservées pendant 15 mois. Si vous souhaitez accéder à nouveau à ces données, vous devez créer un tableau de bord portant le même nom dans la même Région d’accueil que celui qui a été supprimé. 

# Utilisation de la console S3
<a name="storage_lens_console_deleting"></a>

Vous pouvez supprimer un tableau de bord Amazon S3 Storage Lens à partir de la console Amazon S3. Cependant, lorsqu’un tableau de bord est supprimé, il ne peut plus générer de métriques.

**Supprimer un tableau de bord Amazon S3 Storage Lens**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le panneau de navigation de gauche, choisissez **Storage Lens**, **Dashboards** (Tableaux de bord).

1. Dans la liste **Dashboards (Tableaux de bord)**, sélectionnez le tableau de bord à supprimer, puis **Delete (Supprimer)** en haut de la liste.

1. Sur la page **Supprimer les tableaux de bord**, confirmez que vous souhaitez supprimer le tableau de bord en saisissant son nom dans le champ de texte. Ensuite, choisissez **Valider**. 

# À l'aide du AWS CLI
<a name="storage_lens_cli_deleting"></a>

**Example**  
 L’exemple suivant supprime une configuration S3 Storage Lens. Pour utiliser ces exemples, remplacez les `user input placeholders` par vos propres informations.  

```
aws s3control delete-storage-lens-configuration --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id
```

## Utilisation du AWS SDK pour Java
<a name="S3DeleteStorageLensConfigurationJava"></a>

**Example – Supprimer une configuration de tableau de bord Amazon S3 Storage Lens**  
L’exemple suivant illustre comment supprimer une configuration S3 Storage Lens à l’aide du kit SDK for Java :  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.DeleteStorageLensConfigurationRequest;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class DeleteDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.deleteStorageLensConfiguration(new DeleteStorageLensConfigurationRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
            );
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

# Affichage des tableaux de bord Amazon S3 Storage Lens
<a name="storage_lens_list_dashboard"></a>

 

# Utilisation de la console S3
<a name="storage_lens_console_listing"></a>

**Pour afficher les tableaux de bord S3 Storage Lens**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le volet de navigation de gauche, accédez à **Storage Lens**.

1. Choisissez **Tableaux de bord**. Vous pouvez désormais consulter les tableaux de bord dans votre Compte AWS.

## À l'aide du AWS CLI
<a name="S3ListStorageLensConfigurationsCLI"></a>

**Example**  
L'exemple de commande suivant répertorie les tableaux de bord S3 Storage Lens de votre Compte AWS. Pour utiliser ces exemples, remplacez les `user input placeholders` par vos propres informations.  

```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1 --next-token=abcdefghij1234
```

**Example**  
L’exemple suivant répertorie les configurations S3 Storage Lens sans jeton suivant. Pour utiliser ces exemples, remplacez les `user input placeholders` par vos propres informations.  

```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1
```

## Utilisation du AWS SDK pour Java
<a name="S3ListStorageLensConfigurationsJava"></a>

**Example – Répertorie les configurations de tableau de bord S3 Storage Lens**  
L’exemple suivant illustre comment répertorier les configurations S3 Storage Lens à l’aide du kit SDK pour Java : Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations. dans chaque description de l’exemple.  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.ListStorageLensConfigurationEntry;
import com.amazonaws.services.s3control.model.ListStorageLensConfigurationsRequest;

import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class ListDashboard {

    public static void main(String[] args) {
        String sourceAccountId = "111122223333";
        String nextToken = "nextToken";

        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            final List<ListStorageLensConfigurationEntry> configurations =
                    s3ControlClient.listStorageLensConfigurations(new ListStorageLensConfigurationsRequest()
                            .withAccountId(sourceAccountId)
                            .withNextToken(nextToken)
                    ).getStorageLensConfigurationList();

            System.out.println(configurations.toString());
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

# Affichage des détails d’un tableau de bord Amazon S3 Storage Lens
<a name="storage_lens_viewing"></a>

Vous pouvez consulter un tableau de bord Amazon S3 Storage Lens depuis la console Amazon S3 et le SDK for Java. AWS CLI

# Utilisation de la console S3
<a name="storage_lens_console_viewing"></a>

**Pour afficher les détails de configuration d’un tableau de bord S3 Storage Lens**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le volet de navigation de gauche, accédez à **Storage Lens**.

1. Choisissez **Tableaux de bord**.

1. Dans la liste **Tableaux de bord**, sélectionnez le tableau de bord que vous souhaitez afficher. Vous pouvez désormais afficher les détails de votre tableau de bord Storage Lens.

## À l'aide du AWS CLI
<a name="S3ListStorageLensConfigurationsCLI"></a>

**Example**  
L’exemple suivant récupère une configuration S3 Storage Lens afin que vous puissiez consulter les détails de la configuration. Pour utiliser ces exemples, remplacez les `user input placeholders` par vos propres informations.  

```
aws s3control get-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```

## Utilisation du AWS SDK pour Java
<a name="S3GetStorageLensConfigurationJava"></a>

**Example — Récupérer et afficher une configuration S3 Storage Lens**  
L’exemple suivant montre comment récupérer une configuration S3 Storage Lens dans le kit SDK pour Java afin de pouvoir consulter les détails de la configuration. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationResult;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class GetDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";

        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            final StorageLensConfiguration configuration =
                    s3ControlClient.getStorageLensConfiguration(new GetStorageLensConfigurationRequest()
                            .withAccountId(sourceAccountId)
                            .withConfigId(configurationId)
                    ).getStorageLensConfiguration();

            System.out.println(configuration.toString());
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

# Gestion des balises de AWS ressources avec S3 Storage Lens
<a name="storage-lens-groups-manage-tags-dashboard"></a>

Chaque tableau de bord Amazon S3 Storage Lens est considéré comme une AWS ressource dotée de son propre Amazon Resource Name (ARN). Par conséquent, lorsque vous configurez votre tableau de bord Storage Lens, vous pouvez éventuellement y ajouter AWS des balises de ressources. Vous pouvez ajouter jusqu’à 50 balises par tableau de bord Storage Lens. Pour créer un tableau de bord Storage Lens avec des balises, vous devez disposer des [autorisations S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_iam_permissions.html)suivantes :
+ `s3:ListStorageLensConfigurations`
+ `s3:GetStorageLensConfiguration`
+ `s3:GetStorageLensConfigurationTagging`
+ `s3:PutStorageLensConfiguration`
+ ` s3:PutStorageLensConfigurationTagging`

Vous pouvez utiliser AWS des balises de ressources pour classer les ressources par département, secteur d'activité ou projet. Cela est utile lorsque vous avez de nombreuses ressources du même type. En appliquant des balises, vous pouvez rapidement identifier un tableau de bord S3 Storage Lens spécifique en fonction des balises que vous lui avez affectées. Vous pouvez également utiliser des balises pour suivre et répartir les coûts.

En outre, lorsque vous ajoutez une balise de AWS ressource à votre tableau de bord Storage Lens, vous activez le [contrôle d'accès basé sur les attributs (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html). L’ABAC est une stratégie d’autorisation qui définit les autorisations en fonction d’attributs, tels que des balises. Vous pouvez également utiliser des conditions qui spécifient des balises de ressources dans vos politiques IAM pour [contrôler l'accès aux AWS ressources](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).

Vous pouvez modifier les clés et valeurs de balise, et vous pouvez retirer des balises d’une ressource à tout moment. En outre, tenez compte des limitations suivantes :
+ Les clés de balise et valeurs de balise sont sensibles à la casse.
+ Si vous ajoutez une balise ayant la même clé qu’une balise existante sur cette ressource, la nouvelle valeur remplace l’ancienne valeur.
+ Si vous supprimez une ressource, ses balises sont également supprimées. 
+ N'incluez pas de données privées ou sensibles dans vos balises de AWS ressources.
+ Les balises système (dont les clés de balise commencent par `aws:`) ne sont pas prises en charge.
+ La longueur de chaque clé de balise ne peut pas dépasser 128 caractères. La longueur de chaque valeur de balise ne peut pas dépasser 256 caractères.

Les exemples suivants montrent comment utiliser les balises de AWS ressources avec le tableau de bord Storage Lens.

**Topics**
+ [Ajouter AWS des balises de ressources à un tableau de bord Storage Lens](storage-lens-add-tags.md)
+ [Récupérer AWS des balises de ressources pour un tableau de bord Storage Lens](storage-lens-get-tags.md)
+ [Mise à jour des balises de tableau de bord Storage Lens](storage-lens-update-tags.md)
+ [Supprimer AWS des balises de ressources d'un tableau de bord S3 Storage Lens](storage-lens-dashboard-delete-tags.md)

# Ajouter AWS des balises de ressources à un tableau de bord Storage Lens
<a name="storage-lens-add-tags"></a>

Les exemples suivants montrent comment ajouter AWS des balises de ressources à un tableau de bord S3 Storage Lens. Vous pouvez ajouter des balises de ressources à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) et AWS SDK pour Java.

## Utilisation de la console S3
<a name="storage-lens-add-tags-console"></a>

**Pour ajouter AWS des balises de ressources à un tableau de bord Storage Lens**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le volet de navigation de gauche, accédez à **Storage Lens**.

1. Choisissez **Tableaux de bord**.

1. Choisissez la case d’option du tableau de bord Storage Lens que vous souhaitez mettre à jour. Ensuite, choisissez **Edit** (Modifier).

1. Sous **Général**, choisissez **Ajouter une balise**.

1. Sur la page **Ajouter une balise**, ajoutez la nouvelle paire clé-valeur.
**Note**  
L’ajout d’une nouvelle balise ayant la même clé qu’une balise existante remplace la valeur de balise précédente.

1. (Facultatif) Pour ajouter plusieurs nouvelles balises, choisissez à nouveau **Ajouter une balise** pour continuer à ajouter de nouvelles entrées. Vous pouvez ajouter jusqu'à 50 balises de AWS ressources à votre tableau de bord Storage Lens.

1. (Facultatif) Si vous souhaitez retirer une entrée récemment ajoutée, choisissez **Retirer** en regard de la balise que vous souhaitez retirer.

1. Sélectionnez **Enregistrer les modifications**.

## À l'aide du AWS CLI
<a name="storage-lens-add-tags-cli"></a>

**Example**  
L’exemple de commande suivant ajoute des balises à une configuration de tableau de bord S3 Storage Lens. Pour utiliser ces exemples, remplacez les `user input placeholders` par vos propres informations.  

```
aws s3control put-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id --tags=file://./tags.json
```

## Utilisation du AWS SDK pour Java
<a name="storage-lens-add-tags-sdk-java"></a>

L’exemple suivant ajoute des balises à une configuration Amazon S3 Storage Lens dans le kit SDK pour Java. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.

**Example – Ajouter des balises à une configuration S3 Storage Lens**  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class PutDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";

        try {
            List<StorageLensTag> tags = Arrays.asList(
                    new StorageLensTag().withKey("key-1").withValue("value-1"),
                    new StorageLensTag().withKey("key-2").withValue("value-2")
            );

            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withTags(tags)
            );
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

# Récupérer AWS des balises de ressources pour un tableau de bord Storage Lens
<a name="storage-lens-get-tags"></a>

Les exemples suivants montrent comment récupérer AWS des balises de ressources pour un tableau de bord S3 Storage Lens. Vous pouvez obtenir des balises de ressources à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) et AWS SDK pour Java.

# Utilisation de la console S3
<a name="storage-lens-get-tags-console"></a>

**Pour récupérer les balises de AWS ressources d'un tableau de bord Storage Lens**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le volet de navigation de gauche, accédez à **Storage Lens**.

1. Choisissez **Tableaux de bord**.

1. Choisissez la case d’option correspondant à la configuration du tableau de bord Storage Lens que vous souhaitez afficher. Choisissez ensuite **Afficher la configuration du tableau de bord**.

1. Sous **Balises**, vérifiez les balises associées au tableau de bord.

1. (Facultatif) Pour ajouter une nouvelle balise, choisissez **Modifier**. Choisissez ensuite **Ajouter une balise**. Sur la page **Ajouter une balise**, ajoutez la nouvelle paire clé-valeur.
**Note**  
L’ajout d’une nouvelle balise ayant la même clé qu’une balise existante remplace la valeur de balise précédente.

1. (Facultatif) Si vous souhaitez retirer une entrée récemment ajoutée, choisissez **Retirer** en regard de la balise que vous souhaitez retirer.

1. Sélectionnez **Enregistrer les modifications**.

## À l'aide du AWS CLI
<a name="storage-lens-get-tags-cli"></a>

**Example**  
L’exemple de commande suivant récupère des balises pour la configuration d’un tableau de bord S3 Storage Lens. Pour utiliser ces exemples, remplacez les `user input placeholders` par vos propres informations.  

```
aws s3control get-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id --tags=file://./tags.json
```

## Utilisation du AWS SDK pour Java
<a name="S3GetStorageLensConfigurationTaggingJava"></a>

**Example – Obtenir des balises pour une configuration de tableau de bord S3 Storage Lens**  
L’exemple suivant illustre comment récupérer des balises pour la configuration d’un tableau de bord S3 Storage Lens dans le kit SDK pour Java. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.DeleteStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class GetDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            final List<StorageLensTag> s3Tags = s3ControlClient
                    .getStorageLensConfigurationTagging(new GetStorageLensConfigurationTaggingRequest()
                            .withAccountId(sourceAccountId)
                            .withConfigId(configurationId)
                    ).getTags();

            System.out.println(s3Tags.toString());
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

# Mise à jour des balises de tableau de bord Storage Lens
<a name="storage-lens-update-tags"></a>

Les exemples suivants montrent comment mettre à jour les balises du tableau de bord Storage Lens à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) et AWS SDK pour Java.

## Utilisation de la console S3
<a name="storage-lens-dashboard-update-tags-console"></a>

**Pour mettre à jour une balise de AWS ressource pour un tableau de bord Storage Lens**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le volet de navigation de gauche, accédez à **Storage Lens**.

1. Choisissez **Tableaux de bord**.

1. Choisissez la case d’option correspondant à la configuration du tableau de bord Storage Lens que vous souhaitez afficher. Choisissez ensuite **Afficher la configuration du tableau de bord**.

1. Sous **Balises**, vérifiez les balises associées au tableau de bord.

1. (Facultatif) Pour ajouter une nouvelle balise, choisissez **Modifier**. Choisissez ensuite **Ajouter une balise**. Sur la page **Ajouter une balise**, ajoutez la nouvelle paire clé-valeur.
**Note**  
L’ajout d’une nouvelle balise ayant la même clé qu’une balise existante remplace la valeur de balise précédente.

1. (Facultatif) Si vous souhaitez retirer une entrée récemment ajoutée, choisissez **Retirer** en regard de la balise que vous souhaitez retirer.

1. Sélectionnez **Enregistrer les modifications**.

## À l'aide du AWS CLI
<a name="storage-lens-dashboard-update-tags-cli"></a>

**Example**  
L’exemple de commande suivant ajoute ou remplace des balises au niveau d’une configuration existante de tableau de bord Amazon S3 Storage Lens. Pour utiliser ces exemples, remplacez les `user input placeholders` par vos propres informations.  

```
aws s3control put-storage-lens-configuration-tagging --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --config-id=your-configuration-id
```

## Utilisation du AWS SDK pour Java
<a name="storage-lens-dashboard-update-tags-sdk-java"></a>

L' AWS SDK pour Java exemple suivant met à jour les balises de AWS ressources d'un tableau de bord Storage Lens existant. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.

**Example — Mettre à jour les balises au niveau une configuration existante de tableau de bord Storage Lens**  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class PutDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";

        try {
            List<StorageLensTag> tags = Arrays.asList(
                    new StorageLensTag().withKey("key-1").withValue("value-1"),
                    new StorageLensTag().withKey("key-2").withValue("value-2")
            );

            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withTags(tags)
            );
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

# Supprimer AWS des balises de ressources d'un tableau de bord S3 Storage Lens
<a name="storage-lens-dashboard-delete-tags"></a>

Les exemples suivants montrent comment supprimer AWS des balises de ressources d'un tableau de bord Storage Lens existant. Vous pouvez supprimer des balises à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) et AWS SDK pour Java.

## Utilisation de la console S3
<a name="storage-lens-groups-delete-tags-console"></a>

**Pour supprimer les balises de AWS ressources d'un tableau de bord Storage Lens existant**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans le volet de navigation de gauche, accédez à **Storage Lens**.

1. Choisissez **Tableaux de bord**.

1. Choisissez la case d’option correspondant à la configuration du tableau de bord Storage Lens que vous souhaitez afficher. Choisissez ensuite **Afficher la configuration du tableau de bord**.

1. Sous **Balises**, vérifiez les balises associées au tableau de bord.

1. Sélectionnez **Supprimer** à côté de la balise que vous souhaitez supprimer.

1. Sélectionnez **Enregistrer les modifications**.

## À l'aide du AWS CLI
<a name="storage-lens-dashboard-delete-tags-cli"></a>

La AWS CLI commande suivante supprime les balises de AWS ressources d'un tableau de bord Storage Lens existant. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.

**Example**  

```
aws s3control delete-storage-lens-configuration-tagging --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```

## Utilisation du AWS SDK pour Java
<a name="storage-lens-dashboard-delete-tags-sdk-java"></a>

L' AWS SDK pour Java exemple suivant supprime une balise de AWS ressource du tableau de bord de Storage Lens à l'aide de l'Amazon Resource Name (ARN) que vous spécifiez dans le compte`111122223333`. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.

**Example – Supprimer des balises pour une configuration de tableau de bord S3 Storage Lens**  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.DeleteStorageLensConfigurationTaggingRequest;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class DeleteDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.deleteStorageLensConfigurationTagging(new DeleteStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
            );
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

# Fichiers d’aide pour l’utilisation d’Amazon S3 Storage Lens
<a name="S3LensHelperFilesCLI"></a>

Utilisez les fichiers JSON suivants et ses entrées de clé pour vos exemples.

## Exemple de configuration S3 Storage Lens dans JSON
<a name="S3LensHelperFilesSampleConfigurationCLI"></a>

**Example `config.json`**  
Le fichier `config.json` contient les détails d’une configuration de *métriques et recommandations avancées* S3 Storage Lens au niveau de l’organisation. Pour utiliser l'exemple suivant, remplacez `user input placeholders` par vos propres informations.  
Des frais supplémentaires s'appliquent pour les métriques et recommandations avancées. Pour plus d’informations, consultez [Métriques et recommandations avancées](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_basics_metrics_recommendations.html#storage_lens_basics_metrics_selection).

```
{
  "Id": "SampleS3StorageLensConfiguration", //Use this property to identify your S3 Storage Lens configuration.
  "AwsOrg": { //Use this property when enabling S3 Storage Lens for AWS Organizations.
    "Arn": "arn:aws:organizations::123456789012:organization/o-abcdefgh"
  },
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "DetailedStatusCodesMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
        "IsEnabled":true
      },
      "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
      },
      "AdvancedCostOptimizationMetrics": {
        "IsEnabled":true
      },
      "DetailedStatusCodesMetrics": {
        "IsEnabled":true
      },
      "PrefixLevel":{
        "StorageMetrics":{
          "IsEnabled":true,
          "SelectionCriteria":{
            "MaxDepth":5,
            "MinStorageBytesPercentage":1.25,
            "Delimiter":"/"
          }
        }
      }
    }
  },
  "Exclude": { //Replace with "Include" if you prefer to include Regions.
    "Regions": [
      "eu-west-1"
    ],
    "Buckets": [ //This attribute is not supported for AWS Organizations-level configurations.
      "arn:aws:s3:::amzn-s3-demo-source-bucket"
    ]
  },
  "IsEnabled": true, //Whether the configuration is enabled
  "DataExport": { //Details about the metrics export
    "S3BucketDestination": {
      "OutputSchemaVersion": "V_1",
      "Format": "CSV", //You can add "Parquet" if you prefer.
      "AccountId": "111122223333",
      "Arn": "arn:aws:s3:::
amzn-s3-demo-destination-bucket", // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration. 
      "Prefix": "prefix-for-your-export-destination",
      "Encryption": {
        "SSES3": {}
      }
    },
    "CloudWatchMetrics": {
      "IsEnabled": true
    }
  }
}
```

## Exemple de configuration S3 Storage Lens avec des groupes Storage Lens dans JSON
<a name="StorageLensGroupsHelperFilesCLI"></a>

**Example `config.json`**  

Le fichier `config.json` contient les détails que vous souhaitez appliquer à votre configuration Storage Lens lorsque vous utilisez des groupes Storage Lens. Pour utiliser l’exemple, remplacez `user input placeholders` par vos propres informations.

Pour attacher tous les groupes Storage Lens à votre tableau de bord, mettez à jour votre configuration Storage Lens avec la syntaxe suivante :

```
{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
    "StorageLensGroupLevel": {},
  "IsEnabled": true
}
```

Pour inclure uniquement deux groupes Storage Lens dans la configuration de votre tableau de bord Storage Lens (*slg-1*et*slg-2*), utilisez la syntaxe suivante :

```
{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
   "StorageLensGroupLevel": {
        "SelectionCriteria": {
            "Include": [
                "arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
                "arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
            ]
    },
  "IsEnabled": true
}
```

Pour exclure uniquement certains groupes Storage Lens de la configuration de votre tableau de bord, utilisez la syntaxe suivante :

```
{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
   "StorageLensGroupLevel": {
        "SelectionCriteria": {
            "Exclude": [
                "arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
                "arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
            ]
    },
  "IsEnabled": true
}
```

## Exemple de configuration de balises S3 Storage Lens dans JSON
<a name="S3LensHelperFilesSampleConfigurationTagsCLI"></a>

**Example `tags.json`**  
Le fichier `tags.json` contient les étiquettes que vous souhaitez appliquer à votre configuration S3 Storage Lens. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.  

```
[
    {
        "Key": "key1",
        "Value": "value1"
    },
    {
        "Key": "key2",
        "Value": "value2"
    }
]
```

## Exemple de configuration d’autorisations IAM pour S3 Storage Lens
<a name="S3LensHelperFilesSampleConfigurationIAMPermissionsCLI"></a>

**Example `permissions.json` : nom de tableau de bord spécifique**  
Cet exemple de politique montre un fichier `permissions.json` IAM de S3 Storage Lens avec un nom de tableau de bord spécifique spécifié. Remplacez *`value1`*, `us-east-1`, `your-dashboard-name` et `example-account-id` par vos propres valeurs.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetStorageLensConfiguration",
                "s3:DeleteStorageLensConfiguration",
                "s3:PutStorageLensConfiguration"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/key1": "value1"
                }
            },
            "Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens/your-dashboard-name"
        }
    ]
}
```

**Example `permissions.json` : aucun nom de tableau de bord spécifique**  
Cet exemple de politique montre un fichier `permissions.json` IAM de S3 Storage Lens sans nom de tableau de bord spécifique spécifié. Remplacez *`value1`*, `us-east-1` et `example-account-id` par vos propres valeurs.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetStorageLensConfiguration",
                "s3:DeleteStorageLensConfiguration",
                "s3:PutStorageLensConfiguration"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/key1": "value1"
                }
            },
            "Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens/*"
        }
    ]
}
```