

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.

# Attachement ou retrait de groupes S3 Storage Lens à ou de votre tableau de bord
<a name="storage-lens-groups-dashboard-console"></a>

Une fois que vous êtes passé au niveau avancé dans Amazon S3 Storage Lens, vous pouvez attacher un [groupe Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-overview.html) à votre tableau de bord. Si vous avez plusieurs groupes Storage Lens, vous pouvez inclure ou exclure les groupes de votre choix. 

Vos groupes Storage Lens doivent résider dans la région d’origine désignée dans le compte du tableau de bord. Une fois que vous avez attaché un groupe Storage Lens à votre tableau de bord, vous recevrez les données d’agrégation supplémentaires du groupe Storage Lens dans votre exportation de métriques dans un délai de 48 heures.

**Note**  
Si vous souhaitez consulter les métriques agrégées de votre groupe Storage Lens, vous devez les attacher à votre tableau de bord Storage Lens. Pour obtenir des exemples de fichiers de configuration JSON pour le groupe Storage Lens, consultez [Exemple de configuration S3 Storage Lens avec des groupes Storage Lens dans JSON](S3LensHelperFilesCLI.md#StorageLensGroupsHelperFilesCLI). 

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

**Pour attacher un groupe Storage Lens à 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, sous **Storage Lens**, choisissez **Tableaux de bord**.

1. Choisissez le bouton d’option du tableau de bord Storage Lens auquel vous souhaitez attacher un groupe Storage Lens.

1. Choisissez **Modifier**.

1. Sous **Metrics selection** (Sélection des métriques), choisissez **Advanced metrics and recommendations** (Métriques et recommandations avancées).

1. Sélectionnez **Regroupement des groupes Storage Lens**.
**Note**  
Par défaut, **Métriques avancées** est également sélectionné. Toutefois, vous pouvez également désélectionner ce paramètre, car il n’est pas obligatoire pour agréger les données des groupes Storage Lens.

1. Faites défiler la page jusqu’à **Regroupement des groupes Storage Lens** et spécifiez le ou les groupes Storage Lens que vous souhaitez inclure ou exclure dans l’agrégation de données. Vous pouvez utiliser les options de filtrage suivantes :
   + Si vous souhaitez inclure certains groupes Storage Lens, choisissez **Inclure les groupes Storage Lens**. Sous **Groupes Storage Lens à inclure**, sélectionnez vos groupes Storage Lens.
   + Si vous souhaitez inclure tous les groupes Storage Lens, sélectionnez **Inclure tous les groupes Storage Lens de la région d’origine de ce compte**.
   + Si vous souhaitez exclure certains groupes Storage Lens, choisissez **Exclure les groupes Storage Lens**. Sous **Groupes Storage Lens à exclure**, sélectionnez les groupes Storage Lens que vous souhaitez exclure.

1. Sélectionnez **Enregistrer les modifications**. Si vous avez configuré vos groupes Storage Lens correctement, vous verrez les données d’agrégation supplémentaires du groupe Storage Lens dans votre tableau de bord dans un délai de 48 heures.

**Pour retirer un groupe Storage Lens 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 panneau de navigation de gauche, sous **Storage Lens**, choisissez **Tableaux de bord**.

1. Choisissez le bouton d’option du tableau de bord Storage Lens duquel vous souhaitez retirer un groupe Storage Lens.

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

1. Choisissez **Modifier**.

1. Faites défiler la page jusqu’à la section **Sélection des métriques**.

1. Sous **Regroupement des groupes Storage Lens**, cliquez sur le **X** en regard du groupe Storage Lens que vous souhaitez retirer. Votre groupe Storage Lens est retiré.

   Si vous avez inclus tous vos groupes Storage Lens dans votre tableau de bord, décochez la case en regard de **Inclure tous les groupes Storage Lens de la région d’origine de ce compte**. 

1. Sélectionnez **Enregistrer les modifications**.
**Note**  
La répercussion des mises à jour de configuration dans votre tableau de bord prend jusqu’à 48 heures.

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

**Example – Attacher tous les groupes Storage Lens à un tableau de bord**  
L'exemple de SDK pour Java suivant associe tous les groupes Storage Lens du *111122223333* compte au tableau *DashBoardConfigurationId* de bord :  

```
package aws.example.s3control;


import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;

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

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

        try {
            StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel();

            AccountLevel accountLevel = new AccountLevel()
                    .withBucketLevel(new BucketLevel())
                    .withStorageLensGroupLevel(storageLensGroupLevel);

            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();
        }
    }
}
```

**Example – Attacher deux groupes Storage Lens à un tableau de bord**  
L' AWS SDK pour Java exemple suivant associe deux groupes Storage Lens (*StorageLensGroupName1*et*StorageLensGroupName2*) au *ExampleDashboardConfigurationId* tableau de bord.  

```
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.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria;

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

public class CreateDashboardWith2StorageLensGroups {
    public static void main(String[] args) {
        String configurationId = "ExampleDashboardConfigurationId";
        String storageLensGroupName1 = "StorageLensGroupName1";
        String storageLensGroupName2 = "StorageLensGroupName2";
        String sourceAccountId = "111122223333";

        try {
            StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria()
                    .withInclude(
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1,
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2);

            System.out.println(selectionCriteria);
            StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel()
                    .withSelectionCriteria(selectionCriteria);

            AccountLevel accountLevel = new AccountLevel()
                    .withBucketLevel(new BucketLevel())
                    .withStorageLensGroupLevel(storageLensGroupLevel);

            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();
        }
    }
}
```

**Example – Attacher tous les groupes Storage Lens avec des exclusions**  
L'exemple de SDK pour Java suivant associe tous les groupes Storage Lens au tableau de bord, à *ExampleDashboardConfigurationId* l'exception des deux spécifiés *StorageLensGroupName1* (*StorageLensGroupName2*et) :  

```
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.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria;

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

public class CreateDashboardWith2StorageLensGroupsExcluded {
    public static void main(String[] args) {
        String configurationId = "ExampleDashboardConfigurationId";
        String storageLensGroupName1 = "StorageLensGroupName1";
        String storageLensGroupName2 = "StorageLensGroupName2";
        String sourceAccountId = "111122223333";

        try {
            StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria()
                    .withInclude(
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1,
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2);

            System.out.println(selectionCriteria);
            StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel()
                    .withSelectionCriteria(selectionCriteria);

            AccountLevel accountLevel = new AccountLevel()
                    .withBucketLevel(new BucketLevel())
                    .withStorageLensGroupLevel(storageLensGroupLevel);

            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();
        }
    }
}
```